全部產品
Search
文件中心

:CertificatePrivateKeyDecrypt

更新時間:Jan 22, 2025

調用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

密碼編譯演算法,取值:

  • RSAES_OAEP_SHA_1
  • RSAES_OAEP_SHA_256
  • SM2PKE
    說明 SM2PKE密碼編譯演算法僅在中國內地使用託管密碼機的地區支援。更多資訊,請參見託管密碼機概述
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不存在

訪問錯誤中心查看更多錯誤碼。