1. 登錄密鑰管理服務控制臺，在頂部菜單欄選擇地域后，在左側導航欄單擊資源 > 密鑰管理。

2. 在密鑰管理頁單擊默認密鑰，點擊主密鑰操作欄的啟用按鈕。為主密鑰取名alias/main。

購買ECS產品時，在購買頁選擇使用創建的主密鑰alias/main加密服務端數據

當有數據在ECS上傳輸時，ECS會默認調用KMS API對數據進行加解密處理，無需人工處理數據。通常云產品采用信封加密的機制實現對數據的加密，詳情請參見使用KMS密鑰進行信封加密。

1. 登錄密鑰管理服務控制臺，在頂部菜單欄選擇地域后，在左側導航欄單擊資源 > 密鑰管理。

2. 進入用戶主密鑰頁面，點擊創建密鑰，根據提示完成配置。

• KMS實例選擇之前購買的KMS軟件密鑰管理實例

• 密鑰類型選擇對稱加密。

• 密鑰規格選擇Aliyun_AES_256。

1. 環境準備

   環境要求

   已下載并安裝Java 8或以上版本。

   驗證版本

   打開終端，輸入java -version，查看Java（JDK）版本。

2. 安裝SDK

   在項目中添加Maven依賴，從Maven倉庫中自動下載Java安裝包。

   訪問alibabacloud-dkms-gcs-java-sdk了解更多安裝信息和源代碼。

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>alibabacloud-dkms-gcs-sdk</artifactId>
     <version>xx.xx.xx</version>
   </dependency>
   <dependency>
       <groupId>com.aliyun</groupId>
       <artifactId>tea</artifactId>
       <version>[1.2.3)</version>
   </dependency>
               

   重要

   • 建議您安裝最新版本的SDK。

   • 請使用com.aliyun.tea  1.2.3及以上版本。

1. 登錄密鑰管理服務控制臺，在頂部菜單欄選擇地域后，在左側導航欄單擊應用接入 > 接入點。

2. 創建接入點

   1. 在應用接入頁簽，單擊創建應用接入點，在創建應用接入點面板完成各項配置。

      配置項	說明
      創建模式	選擇快速創建。
      作用域（KMS實例）	選擇應用要訪問的KMS實例。
      應用接入點名稱	自定義應用接入點的名稱。
      認證方式	默認為ClientKey，不支持修改。
      默認權限策略	默認為key/*secret/*，不支持修改。即應用可以訪問指定KMS實例中的所有密鑰和憑據。

   2. 單擊確定，瀏覽器會自動下載ClientKey。

      ClientKey包含應用身份憑證內容（ClientKeyContent）和憑證口令（ClientKeyPassword）。 應用身份憑證內容（ClientKeyContent）文件名默認為clientKey_****.json。憑證口令（ClientKeyPassword）文件名默認為clientKey_****_Password.txt

   

1. 登錄密鑰管理服務控制臺，在頂部菜單欄選擇地域后，在左側導航欄單擊資源 > 實例管理。

2. 在右側操作頁面上方，點擊CA證書下載。

   

1. 初始化KMS實例SDK

     public static void initClient() throws Exception {
           Config config = new Config();
           config.setProtocol("https");
           config.setEndpoint("實例id.cryptoservice.KMS.aliyuncs.com"); // 設置KMS實例Endpoint
           config.setClientKeyFile("<YOUR-CLIENT-KEY-FILE>"); // 設置client key文件地址
           // config.setClientKeyContent("<YOUR-CLIENT-KEY-CONTENT>"); // 或設置client key文件的內容
           config.setPassword("<YOUR-PASSWORD>"); // 設置client key 保護密碼
           config.setCaFilePath("<path/to/yourCaCert>");// 設置KMS實例的CA證書，可通過文件路徑
           //config.setCa("<your-ca-certificate-content"); // 或者設置服務端證書內容
   
           client = new Client(config);
       }

2. 調用AdvanceEncrypt加密數據

   /**
        * KMS默認采用GCM加密模式。
        * @param keyId     keyId 參數，可使用密鑰Id或別名
        * @param plaintext 需要加密的數據
        * @param aad       用戶可根據使用的需要設置GCM加密模式的AAD參數。如果不需要使用，請設置為null或不設置。
        * @return AdvanceEncrypt密文數據上下文（本示例采用AdvanceEncryptContext），包含密文數據（ciphertextBlob）和相關參數密文（AAD）。
        */
       private static AdvanceEncryptContext advanceEncryptSample(String keyId, byte[] plaintext, byte[] aad) {
           AdvanceEncryptRequest request = new AdvanceEncryptRequest();
           request.setKeyId(keyId);
           request.setPlaintext(plaintext);
           request.setAad(aad);
           try {
               AdvanceEncryptResponse response = client.advanceEncrypt(request);
               return new AdvanceEncryptContext(response.getCiphertextBlob(), aad);
           } catch (TeaException e) {
               System.out.printf("code: %s%n", e.getCode());
               System.out.printf("message: %s%n", e.getMessage());
               System.out.printf("requestId: %s%n", e.getData().get("requestId"));
               e.printStackTrace();
               throw new RuntimeException(e);
           } catch (Exception e) {
               System.out.printf("advance encrypt err: %s%n", e.getMessage());
               e.printStackTrace();
               throw new RuntimeException(e);
           }
       }

3. 調用AdvanceDecrypt解密數據

      /**
        * 調用 AdvanceDecrypt 的示例。
        *
        * @param advanceEncryptContext AdvanceEncrypt密文數據上下文（本示例采用AdvanceEncryptContext），包含密文數據（ciphertextBlob）和相關參數密文（AAD）。
        * @return 解密后得到的明文數據。
        */
       private static byte[] advanceDecryptSample(final AdvanceEncryptContext advanceEncryptContext) {
           // 構建高級解密請求對象
           AdvanceDecryptRequest request = new AdvanceDecryptRequest();
           request.setCiphertextBlob(advanceEncryptContext.getCiphertextBlob());
           request.setAad(advanceEncryptContext.getAad());
           try {
               AdvanceDecryptResponse response = client.advanceDecrypt(request);
               System.out.printf("RequestId: %s%n", response.getRequestId());
               return response.getPlaintext();
           } catch (TeaException e) {
               System.out.printf("code: %s%n", e.getCode());
               System.out.printf("message: %s%n", e.getMessage());
               System.out.printf("requestId: %s%n", e.getData().get("requestId"));
               e.printStackTrace();
               throw new RuntimeException(e);
           } catch (Exception e) {
               System.out.printf("advance decrypt err: %s%n", e.getMessage());
               e.printStackTrace();
               throw new RuntimeException(e);
           }
       }
   

完整代碼樣例參見AdvanceEncryptAdvanceDecryptSample.java