使用 Java API 為 Word 檔案設定密碼保護與加密是企業在分發前需要保護敏感文件的常見需求。 Aspose.Words Cloud SDK for Java 提供了一個直接從 Java 應用程式為 DOCX 檔案添加密碼保護和加密的簡易庫。 在本指南中，您將學習如何配置 SDK、上傳文件、使用密碼套用唯讀保護，以及取得受保護的檔案。 本教學還包括 REST API 使用者的等效 cURL 命令以及安全文件處理的最佳實踐建議。
使用 Java API 在 5 步驟中對 Word 檔案設定密碼保護與加密
-
將來源 DOCX 上傳至 Aspose Cloud 儲存空間：使用
UploadFileRequest將本機檔案傳輸至雲端。Path inputPath = Paths.get(localInputPath); byte[] inputData = Files.readAllBytes(inputPath); UploadFileRequest uploadRequest = new UploadFileRequest(remoteInputFile, inputData, null, null); wordsApi.uploadFile(uploadRequest); -
建立帶密碼的保護請求：實例化
ProtectionRequest，設定密碼並選擇READ_ONLY保護類型。ProtectionRequest protection = new ProtectionRequest(); protection.setPassword(documentPassword); protection.setProtectionType(ProtectionRequest.ProtectionTypeEnum.READ_ONLY); -
套用保護並加密文件：呼叫
PutProtectDocumentRequest，傳入來源與目標檔案名稱。PutProtectDocumentRequest protectRequest = new PutProtectDocumentRequest( remoteInputFile, protection, null, null, null, null, remoteOutputFile, null, null); wordsApi.putProtectDocument(protectRequest); -
下載已保護的 DOCX：使用
DownloadFileRequest取得加密後的檔案。DownloadFileRequest downloadRequest = new DownloadFileRequest(remoteOutputFile, null, null); byte[] protectedData = wordsApi.downloadFile(downloadRequest); Path outputPath = Paths.get(localOutputPath); Files.write(outputPath, protectedData); -
（可選）清理遠端檔案：如果不再需要，從儲存空間刪除暫存檔案。
如需詳細的類別資訊，請參閱 WordsApi 參考文件。
使用 Java API 為 Word 檔案設定密碼保護與加密 - 完整程式碼範例
此範例示範如何上傳 DOCX、套用密碼保護，並使用 Aspose.Words Cloud SDK for Java 下載受保護的檔案。
import com.aspose.words.cloud.ApiClient;
import com.aspose.words.cloud.api.WordsApi;
import com.aspose.words.cloud.model.ProtectionRequest;
import com.aspose.words.cloud.model.requests.DownloadFileRequest;
import com.aspose.words.cloud.model.requests.PutProtectDocumentRequest;
import com.aspose.words.cloud.model.requests.UploadFileRequest;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class ProtectAndEncryptWord {
public static void main(String[] args) {
// Replace with your actual Aspose Cloud credentials
final String clientId = "YOUR_CLIENT_ID";
final String clientSecret = "YOUR_CLIENT_SECRET";
// File locations (local)
final String localInputPath = "input.docx";
final String localOutputPath = "output_protected.docx";
// Remote file names (in Aspose Cloud storage)
final String remoteInputFile = "input.docx";
final String remoteOutputFile = "output_protected.docx";
// Password to protect the document
final String documentPassword = "MySecretPassword";
// Initialize API client
ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.aspose.cloud");
apiClient.setAppSid(clientId);
apiClient.setAppKey(clientSecret);
WordsApi wordsApi = new WordsApi(apiClient);
try {
// Upload local document to Aspose Cloud storage
Path inputPath = Paths.get(localInputPath);
byte[] inputData = Files.readAllBytes(inputPath);
UploadFileRequest uploadRequest = new UploadFileRequest(remoteInputFile, inputData, null, null);
wordsApi.uploadFile(uploadRequest);
// Create protection request with password and protection type
ProtectionRequest protection = new ProtectionRequest();
protection.setPassword(documentPassword);
protection.setProtectionType(ProtectionRequest.ProtectionTypeEnum.READ_ONLY);
// Apply protection and encrypt the document
PutProtectDocumentRequest protectRequest = new PutProtectDocumentRequest(
remoteInputFile, // source file name
protection, // protection settings
null, // folder (root)
null, // storage
null, // loadEncoding
null, // password (none, because we are adding one)
remoteOutputFile, // destination file name
null, // revisionAuthor
null // revisionDateTime
);
wordsApi.putProtectDocument(protectRequest);
// Download the protected document back to local storage
DownloadFileRequest downloadRequest = new DownloadFileRequest(remoteOutputFile, null, null);
byte[] protectedData = wordsApi.downloadFile(downloadRequest);
Path outputPath = Paths.get(localOutputPath);
Files.write(outputPath, protectedData);
// Optional: clean up remote files
// wordsApi.deleteFile(new DeleteFileRequest(remoteInputFile, null, null));
// wordsApi.deleteFile(new DeleteFileRequest(remoteOutputFile, null, null));
System.out.println("Document protected and saved to: " + localOutputPath);
} catch (IOException e) {
System.err.println("File I/O error: " + e.getMessage());
} catch (Exception e) {
System.err.println("Aspose API error: " + e.getMessage());
}
}
}
注意： 此程式碼範例展示了核心功能。在將其用於您的專案之前，請確保更新所有檔案路徑和設定值以符合實際環境，驗證所有必要的相依項已正確安裝，並在開發環境中徹底測試。若遇到任何問題，請參閱官方文件或聯繫支援團隊以獲得協助。
使用 cURL 透過 REST API 保護與加密 Word 文件
以下的 cURL 命令執行與 Java 程式碼相同的操作，但透過 Aspose.Words Cloud REST 端點。
-
取得存取令牌
將YOUR_CLIENT_ID與YOUR_CLIENT_SECRET替換為您的憑證。curl -X POST "https://api.aspose.cloud/connect/token" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" -
上傳來源 DOCX
curl -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/input.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@input.docx"
- 套用密碼保護（唯讀）
curl -X PUT "https://api.aspose.cloud/v4.0/words/input.docx/protect?destFileName=output_protected.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"Password": "MySecretPassword",
"ProtectionType": "ReadOnly"
}'
- 下載受保護的 DOCX
curl -X GET "https://api.aspose.cloud/v4.0/words/storage/file/output_protected.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output_protected.docx
如需更多詳細資訊，請參閱官方 API 文件。
安裝與設定 Aspose.Words Cloud SDK for Java
將 Maven 相依性加入您的專案 pom.xml（或等效的 Gradle 片段）。
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words-cloud</artifactId>
<version>26.10.0</version>
</dependency>
從發行頁面下載最新的函式庫。
如程式碼範例所示初始化用戶端（摘錄）：
ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.aspose.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");
WordsApi wordsApi = new WordsApi(apiClient);
請確保您擁有有效的 Aspose Cloud 帳戶，且已產生用戶端 ID 與密鑰。
Aspose.Words Cloud SDK for Java 的文件安全功能
- Password protection - 使用自訂密碼套用唯讀、註解或追蹤變更保護。
- Encryption - 當設定密碼時，SDK 會加密整個 DOCX 檔案，防止未授權存取。
- Cloud storage integration - 直接從 Aspose Cloud 儲存體上傳和下載檔案，簡化工作流程自動化。
- Fine‑grained control - 從多個
ProtectionTypeEnum值中選擇，以符合您的安全政策。 - Cross‑platform support - 可在任何相容 Java 的環境中運作，從桌面應用程式到伺服器端服務皆可。
Best Practices for Securing Word Files with Aspose.Words
- 使用強密碼: 結合大寫字母、小寫字母、numbers，以及符號，以抵禦暴力破解攻擊。
- 安全存儲憑證: 將
clientId和clientSecret從源代碼中移除，使用環境變數或機密管理器。 - 驗證檔案大小: 檢查上傳文件的大小，以避免加密過程中過度的記憶體消耗。
- 限制權限: 僅為用於保護操作的 API 金鑰授予必要的存儲權限。
- 測試解密: 在套用保護後，下載文件並驗證密碼是否如預期般運作，然後再提供給使用者。
最後的想法
使用 Java API 為 Word 檔案設定密碼保護與加密對於保護現代應用程式中的機密資訊至關重要。透過利用 Aspose.Words Cloud SDK for Java，開發人員可以自動化整個工作流程，從上傳 DOCX、套用唯讀保護到取得加密後的結果。SDK 豐富的 API 結合簡單的 cURL 替代方案，使得在任何基於 Java 的系統中整合文件安全變得輕鬆。請記得在正式環境中取得適當的授權；產品頁面上提供了價格資訊，您也可以在評估解決方案時從 臨時授權頁面 取得臨時授權。
常見問題
在 Aspose.Words 中，使用 Java API 的密碼保護與加密 Word 檔案是如何運作的？
此流程會將 DOCX 上傳至 Aspose Cloud 儲存空間，建立包含密碼與保護類型的 ProtectionRequest，呼叫 PutProtectDocument 套用設定，最後下載已加密的檔案。SDK 會在內部處理所有加密細節。
我可以在 Java 中以程式方式加密 Word 文件時，使用除唯讀之外的其他保護類型嗎？
是的。ProtectionRequest.ProtectionTypeEnum 列舉包含 COMMENTS、TRACK_CHANGES 和 FORMS 等選項。選擇符合您安全需求的類型。
是否可以在未先下載到本機的情況下保護文件？
當然可以。所有操作都可以直接在雲端儲存中執行。保護後，您可以將檔案保留在 Aspose Cloud，或稍後使用 DownloadFileRequest 下載。
什麼授權是生產部署 Aspose.Words Java API 所需的？
生產環境需要商業授權。您可以在產品頁面查看價格，並從臨時授權頁面獲取臨時評估授權。