轉加密
更新時間 2024-12-20 13:36:43
最近更新時間: 2024-12-20 13:36:43
分享文章
接口功能介紹
轉加密接口
接口約束
請保證賬戶余額大于0
URI
POST /v1/cmkManage/reEncrypt
路徑參數
無
Query參數
無
請求參數
請求頭header參數
請參見請求消息頭
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ciphertextBlob | 是 | String | 待轉加密的密文。該參數可以為對稱加密或非對稱加密返回的密文數據： 對稱加密：調用Encrypt、GenerateDataKey、GenerateDataKeyWithoutPlaintext或GenerateAndExportDataKey接口返回的密文數據 非對稱加密：可以是調用GenerateAndExportDataKey接口返回的公鑰加密數據，也可以是外部系統使用非對稱公鑰加密的數據 |
ODZhOWVmZDktM2QxNi00ODk0LWJkNGYtMWZjNDNmM2YyYWJmS7FmDBBQ0BkKsQrtRnidtPwirmDcS0ZuJCU41x | |
| destinationKeyId | 是 | String | 對密文解密后再次加密時使用的對稱主密鑰ID | db4e73de-def5-4702-9dbb-6387f05ae0d8 | |
| sourceEncryptionAlgorithm | 否 | String | CiphertextBlob是公鑰加密結果時，指定公鑰加密的算法，取值范圍： RSAES_OAEP_SHA_256 RSAES_OAEP_SHA_1 |
RSAES_OAEP_SHA_1 | |
| sourceKeyId | 否 | String | 解密密文時使用的主密鑰ID 說明：當CiphertextBlob是非對稱加密返回的公鑰加密數據時需要指定該參數 |
474e569e-8814-474a-948b-dbcf6d853eff | |
| sourceKeyVersionId | 否 | String | 用于解密密文的密鑰版本標識符 說明：當CiphertextBlob是非對稱加密返回的公鑰加密數據時需要指定該參數 |
db4e73de-def5-4702-9dbb-6387f05ae0d8 |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | String | 返回碼，取值范圍： 200：成功 400：參數缺失或錯誤 401：用戶驗證錯誤 404：操作目標不可用 500：系統內部錯誤 |
200 | |
| errorCode | 是 | String | 錯誤碼 | KMS.0514 | |
| msg | 是 | String | 調用結果信息 | 轉加密成功 | |
| data | 是 | Object | 接口返回結果 | returnObj |
表 returnObj
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ciphertextBlob | 是 | String | 加密秘文 | itIb4kN84JKrbv8P5ZTZJyn3cbu0SLvblB5/csedLEchgF5ijFx9nEc5Y0DpzWba | |
| cmkUuid | 是 | String | 密鑰唯一標識id | 474e569e-8814-474a-948b-dbcf6d853eff | |
| keyVersionId | 是 | String | 密鑰版本id | f2ffbff9-940a-41a4-ba9a-fe1fd8f22792 |
請求示例
請求頭header
{
"Content-Type": "application/json",
"requestDate": "20221101T154654Z",
"ctyun-eop-request-id": "89bf1559-a96e-4bc9-98fc-394d169a42e4",
"Eop-Authorization":"91ef73a6329545c294be1d5c763bdf7e?Headers=ctyun-eop-request-id;eop-date?Signature=2mc3zggaqLEGTSVy2H8lWsFEm+BNJf0CrcomDSOxPfc=",
"regionId":"60a39fca876e11ea91cf0242ac110002"
}
請求體body
{
"ciphertextBlob":"ODZhOWVmZDktM2QxNi00ODk0LWJkNGYtMWZjNDNmM2YyYWJmS7FmDBBQ0BkKsQrtRnidtPwirmDcS0ZuJCU41x",
"destinationKeyId":"db4e73de-def5-4702-9dbb-6387f05ae0d8",
"sourceEncryptionAlgorithm":"RSAES_OAEP_SHA_1",
"sourceKeyId":"474e569e-8814-474a-948b-dbcf6d853eff",
"sourceKeyVersionId":"db4e73de-def5-4702-9dbb-6387f05ae0d8"
}
響應示例
{
"code": "200",
"errorCode": null,
"msg": "轉加密成功",
"data": {
"cmkUuid": "6b1f657c-816b-4534-a41a-903e7a60e703",
"keyVersionId ": "a857cc58-ab6f-40ac-b9e7-fa1781209a76",
"ciphertextBlob":"itIb4kN84JKrbv8P5ZTZJyn3cbu0SLvblB5/csedLEchgF5ijFx9nEc5Y0DpzWba"
}
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功。 |
| 400 | 表示參數缺失或錯誤。 |
| 401 | 表示用戶驗證錯誤。 |
| 404 | 表示操作目標不可用。 |
| 500 | 表示系統內部錯誤。 |
錯誤碼
請參考 錯誤碼說明。
