調用CertificatePrivateKeyDecrypt介面使用指定認證解密資料。
使用限制:請求參數中密碼編譯演算法需要跟密鑰類型對應。
密碼編譯演算法和密鑰類型對照表如下:
Algorithm |
Key Spec |
RSAES_OAEP_SHA_1 |
RSA_2048 |
RSAES_OAEP_SHA_256 |
RSA_2048 |
SM2PKE |
EC_SM2 |
本文將提供一個樣本,使用ID為12345678-1234-1234-1234-12345678****的認證,通過RSAES_OAEP_SHA_256密碼編譯演算法對資料ZOyIygCyaOW6Gj****MlNKiuyjfzw=進行解密。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
| Action | String | 是 | CertificatePrivateKeyDecrypt | 要執行的操作。取值:CertificatePrivateKeyDecrypt。 |
| CertificateId | String | 是 | 12345678-1234-1234-1234-12345678**** | 認證ID。認證管家中認證的通用唯一識別碼。 |
| Algorithm | String | 是 | RSAES_OAEP_SHA_256 | 密碼編譯演算法,取值:
|
| CiphertextBlob | String | 是 | ZOyIygCyaOW6Gj****MlNKiuyjfzw= | 待解密資料。 使用Base64編碼。 |
關於公用請求參數的詳情,請參見公用參數。
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
| RequestId | String | 5979d897-d69f-4fc9-87dd-f3bb73c40b80 | 本次調用請求的ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。 |
| CertificateId | String | 12345678-1234-1234-1234-12345678**** | 認證ID。 |
| Plaintext | String | VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4 | 解密後的資料。 使用Base64編碼。 |
樣本
請求樣本
http(s)://[Endpoint]/?Action=CertificatePrivateKeyDecrypt
&CertificateId=12345678-1234-1234-1234-12345678****
&Algorithm=RSAES_OAEP_SHA_256
&CiphertextBlob=ZOyIygCyaOW6Gj****MlNKiuyjfzw=
&公用請求參數
正常返回樣本
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CertificatePrivateKeyDecryptResponse>
<RequestId>5979d897-d69f-4fc9-87dd-f3bb73c40b80</RequestId>
<CertificateId>12345678-1234-1234-1234-12345678****</CertificateId>
<Plaintext>VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4</Plaintext>
</CertificatePrivateKeyDecryptResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "5979d897-d69f-4fc9-87dd-f3bb73c40b80",
"CertificateId" : "12345678-1234-1234-1234-12345678****",
"Plaintext" : "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4"
}
錯誤碼
| HttpCode | 錯誤碼 | 錯誤資訊 | 描述 |
| 400 | InvalidParameter | The specified parameter is not valid. | 參數非法。 |
| 404 | Certificate.NotFound | The specified certificate is not found. | 指定的認證不存在。 |
| 404 | InvalidAccessKeyId.NotFound | The Access Key ID provided does not exist in our records. | 提供的 Access Key ID不存在 |
訪問錯誤中心查看更多錯誤碼。