22      windows

Encrypt__API 參考_密鑰管理服務-阿裏雲

通過使用客戶主密鑰加密的明文轉換為密文。加密功能有兩個基本用例：

• 可以加密最多為4KB任意數據,諸如RSA密鑰，數據庫密碼，或其他敏感的客戶信息。
• 如果您是從一個region遷移加密數據到另一個region，可以使用這個API在新的region中加密在前一個region中用來加密數據的DataKey明文。這提供了新region認可的一個加密後的CiphertextBlob，可以調用新region中的Decrypt進行解密。

• 請求格式

    KeyId="string"&Plaintext=blob&EncryptionContext=json

• 請求參數
  • KeyId
    • 含義 : key的全局唯一標識符
    • 類型 : String
    • 是否必須 : 是
  • Plaintext
    • 含義 : 要加密的明文
    • 類型 : String
    • 是否必須 : 是
  • EncryptionContext
    • 含義: key/value對的json字符串，如果指定了該參數，則在調用Decrypt API時需要提供同樣的參數，參見EncryptionContext說明
    • 有效值: 參見EncryptionContext說明
    • 類型: String
    • 是否必須: 否
• 請求示例

https://kms.cn-hangzhou.aliyuncs.com/?Action=Encrypt
&KeyId=<your-key-id>
&Plaintext=<data need encrypt>
&EncryptionContext=<json string>
&<其他公共參數>

• 返回格式

{
    "CiphertextBlob": blob, 
    "KeyId": "string",
    "RequestId":"string"
}

• 返回參數

  • KeyId
    • 含義 : key的全局唯一標識符
    • 類型 : String
  • CiphertextBlob
    • 含義 : 加密後的密文
    • 類型 : String
  • RequestId
    • 含義 : 隨機的訪問Id
    • 類型 : String

• 返回示例

//json response
{
    "KeyId": "your-key-id",
    "CiphertextBlob": "CiphertextBlob",
    "RequestId": "475f1620-b9d3-4d35-b5c6-3fbdd941423d"
}
//xml response
<KMS>
    <KeyId>your-key-id</KeyId>
    <CiphertextBlob>CiphertextBlob</CiphertextBlob>
    <RequestId>475f1620-b9d3-4d35-b5c6-3fbdd941423d</RequestId>
</KMS>