22      微信

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>