Bảo vệ Excel bằng mật khẩu qua REST trong Java

Việc ẩn dữ liệu nhạy cảm trong các sổ làm việc Excel là một yêu cầu phổ biến cho các doanh nghiệp chia sẻ báo cáo nội bộ hoặc với đối tác. GroupDocs.Merger Cloud SDK for Java cho phép các nhà phát triển thêm bảo vệ bằng mật khẩu cho các tệp XLSX thông qua một REST API đơn giản. Trong hướng dẫn này, bạn sẽ học cách thực hiện password Protect Excel via REST in Java, xem một ví dụ Java đầy đủ, và chạy các lệnh cURL tương đương cho việc tích hợp đám mây.

Các yêu cầu và cài đặt

Trước khi bắt đầu, hãy chắc chắn rằng bạn đã có những thứ sau:

Java 8 hoặc cao hơn đã được cài đặt.
Maven hoặc Gradle để quản lý phụ thuộc.
Một tài khoản GroupDocs Cloud với client ID và client secret.
Truy cập vào bộ nhớ đám mây nơi các tệp Excel sẽ được lưu trữ.

Thêm phụ thuộc Maven vào tệp pom.xml của bạn (hoặc đoạn mã Gradle tương đương):

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Bạn có thể tải xuống các JAR mới nhất từ trang tải xuống. Sau khi thêm phụ thuộc, tạo một đối tượng cấu hình với thông tin xác thực của bạn:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

Khi client đã sẵn sàng, bạn có thể chuyển sang quy trình bảo vệ mật khẩu thực tế.

Bảo mật Excel bằng mật khẩu qua REST trong Java: Hướng dẫn chi tiết

Bước 1: Tải tài liệu nguồn

Xác định vị trí của tệp XLSX nguồn trong bộ nhớ đám mây của bạn.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Bước 2: Đặt đường dẫn đích

Xác định vị trí lưu workbook được bảo vệ.

String outputPath = "output_protected.xlsx"; // destination file

Bước 3: Cấu hình các tùy chọn bảo vệ bằng mật khẩu

Tạo một đối tượng ProtectOptions, đính kèm thông tin tệp, đường dẫn đầu ra và mật khẩu mong muốn.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Bước 4: Tạo yêu cầu bảo vệ tài liệu

Đóng gói các tùy chọn trong một ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Bước 5: Thực hiện yêu cầu và xử lý phản hồi

Gọi phương thức API và xử lý bất kỳ lỗi nào.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Để biết thêm chi tiết về mỗi lớp, hãy tham khảo API reference.

Ví dụ Hoạt động đầy đủ cho Bảo vệ Excel bằng mật khẩu qua REST trong Java

Đoạn mã sau đây trình bày quy trình hoàn chỉnh từ đầu đến cuối.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (input.xlsx, output_protected.xlsx) để phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển của bạn. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Bảo vệ sổ làm việc Excel qua REST API bằng cURL

Dưới đây là một tập hợp các lệnh cURL thực hiện cùng một thao tác bảo vệ bằng mật khẩu trực tiếp trên các endpoint REST.

1. Xác thực và nhận token truy cập

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

Phản hồi chứa một access_token mà bạn sẽ sử dụng trong các cuộc gọi tiếp theo.

2. Tải lên tệp XLSX nguồn

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Yêu cầu bảo vệ bằng mật khẩu

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Tải xuống workbook được bảo vệ

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Các lệnh này cho phép bạn tích hợp quy trình bảo vệ vào các script hoặc pipeline CI. Để biết thêm chi tiết, xem tài liệu API chính thức.

Kết luận

Triển khai bảo mật Excel bằng mật khẩu qua REST trong Java rất đơn giản với GroupDocs.Merger Cloud SDK for Java. Bằng cách thực hiện các bước ở trên, bạn có thể bảo vệ các sổ làm việc Excel, tự động hoá quy trình trong các ứng dụng phía máy chủ và giữ an toàn cho dữ liệu nhạy cảm. Hãy nhớ mua giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; thông tin về giá cả có sẵn trên trang sản phẩm và bạn có thể bắt đầu với một giấy phép tạm thời để đánh giá thư viện. Chúc lập trình vui vẻ!

Câu hỏi thường gặp

Bảo mật bằng mật khẩu cho Excel qua REST trong Java khác như thế nào so với mã hóa cục bộ?
API đám mây thực hiện việc mã hóa trên máy chủ, vì vậy bạn không cần quản lý các thư viện mật mã cục bộ. SDK xử lý việc xây dựng yêu cầu và phân tích phản hồi, giúp đơn giản hoá quá trình tích hợp.
Có thể thiết lập các tùy chọn bảo vệ bổ sung, chẳng hạn như chế độ chỉ đọc không?
Lớp ProtectOptions hiện tại tập trung vào bảo vệ bằng mật khẩu. Đối với các tính năng bảo mật nâng cao hơn, hãy tham khảo tài liệu API để biết các tham số mới hơn.
Các định dạng tệp nào được hỗ trợ cho việc bảo vệ bằng mật khẩu?
API Merger hiện đang hỗ trợ XLSX, DOCX, PPTX, và PDF để mã hóa. Tham khảo tài liệu chính thức để biết danh sách đầy đủ.
Tôi có cần giấy phép để chạy ví dụ trong môi trường phát triển không?
Việc phát triển và kiểm thử có thể được thực hiện với giấy phép tạm thời. Việc triển khai trong môi trường sản xuất yêu cầu giấy phép trả phí, bạn có thể mua qua trang sản phẩm.

Các yêu cầu và cài đặt#

Bảo mật Excel bằng mật khẩu qua REST trong Java: Hướng dẫn chi tiết#

Bước 1: Tải tài liệu nguồn#

Bước 2: Đặt đường dẫn đích#

Bước 3: Cấu hình các tùy chọn bảo vệ bằng mật khẩu#

Bước 4: Tạo yêu cầu bảo vệ tài liệu#

Bước 5: Thực hiện yêu cầu và xử lý phản hồi#

Ví dụ Hoạt động đầy đủ cho Bảo vệ Excel bằng mật khẩu qua REST trong Java#

Bảo vệ sổ làm việc Excel qua REST API bằng cURL#

Kết luận#

Câu hỏi thường gặp#

Đọc thêm#