AsymmetricVerify -

注意事項

非KMS執行個體中的密鑰：進行密碼運算時，僅支援通過阿里雲SDK調用OpenAPI。
KMS執行個體中的密鑰：進行密碼運算時，支援如下兩種方式。
- 方式一（推薦）：通過KMS執行個體SDK調用KMS執行個體API。詳細介紹，請參見KMS執行個體SDK、KMS執行個體API。
- 方式二：通過阿里雲SDK調用OpenAPI，但認證方式僅支援可信實體為阿里雲服務的RAM角色。詳細資料，請參見建立可信實體為阿里雲服務的RAM角色。

QPS限制

本介面的單使用者QPS限制為200次/秒。超過限制，API調用將會被限流，這可能影響您的業務，請合理調用。

詳細說明

僅支援Usage為SIGN/VERIFY的非對稱金鑰。支援的簽名演算法如下表：

KeySpec	Algorithm	說明
RSA_2048	RSA_PSS_SHA_256	RSASSA-PSS using SHA-256 and MGF1 with SHA-256
RSA_2048	RSA_PKCS1_SHA_256	RSASSA-PKCS1-v1_5 using SHA-256
RSA_3072	RSA_PSS_SHA_256	RSASSA-PSS using SHA-256 and MGF1 with SHA-256
RSA_3072	RSA_PKCS1_SHA_256	RSASSA-PKCS1-v1_5 using SHA-256
EC_P256	ECDSA_SHA_256	ECDSA on the P-256 Curve(secp256r1) with a SHA-256 digest
EC_P256K	ECDSA_SHA_256	ECDSA on the P-256K Curve(secp256k1) with a SHA-256 digest
EC_SM2	SM2DSA	SM2橢圓曲線數位簽章演算法

說明按照國家標準GBT32918，計算SM2簽名值時，Digest參數不是對原始訊息直接計算SM3摘要，而是對Z(A)和M的拼接值計算的摘要，其中M是待簽名的原始訊息，Z(A)是GBT32918中定義的使用者A的雜湊值。

本文將提供一個樣本，使用密鑰ID為5c438b18-05be-40ad-b6c2-3be6752c****、密鑰版本ID為2ab1a983-7072-4bbc-a582-584b5bd8****的非對稱金鑰，通過簽名演算法RSA_PSS_SHA_256對摘要資訊ZOyIygCyaOW6GjVnihtTFtIS9PNmskdyMlNKiuyjfzw=產生的簽名值M2CceNZH00ZgL9ED/ZHFp21YRAvYeZHknJUc207OCZ0N9wNn9As4z2bON3FF3je+1Nu+2+/8Zj50HpMTpzYpMp2R93cYmACCmhaYoKydxylbyGzJR8y9likZRCrkD38lRoS40aBBvv/6iRKzQuo9EGYVcel36cMNg00VmYNBy3pa1rwg3gA4l3cy6kjayZja1WGPkVhrVKsrJMdbpl0ApLjXKuD8rw1n1XLCwCUEL5eLPljTZaAveqdOFQOiZnZEGI27qIiZe7I1fN8tcz6anS/gTM7xRKE++5egEvRWlTQQTJeApnPSiUPA+8ZykNdelQsOQh5SrGoyI4A5pq****==進行驗證。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	AsymmetricVerify	要執行的操作。取值：AsymmetricVerify。
KeyId	String	是	5c438b18-05be-40ad-b6c2-3be6752c****	主要金鑰（CMK）的通用唯一識別碼。說明該參數也可以被指定為主要金鑰綁定的別名。更多資訊，請參加見別名使用說明。
KeyVersionId	String	是	2ab1a983-7072-4bbc-a582-584b5bd8****	密鑰版本ID。密鑰版本的通用唯一識別碼。
Algorithm	String	是	RSA_PSS_SHA_256	簽名演算法。
Digest	String	是	ZOyIygCyaOW6GjVnihtTFtIS9PNmskdyMlNKiuy****=	使用Algorithm中對應的雜湊演算法，對原始訊息產生的摘要。說明使用Base64編碼。
Value	String	是	M2CceNZH00ZgL9ED/ZHFp21YRAvYeZHknJUc207OCZ0N9wNn9As4z2bON3FF3je+1Nu+2+/8Zj50HpMTpzYpMp2R93cYmACCmhaYoKydxylbyGzJR8y9likZRCrkD38lRoS40aBBvv/6iRKzQuo9EGYVcel36cMNg00VmYNBy3pa1rwg3gA4l3cy6kjayZja1WGPkVhrVKsrJMdbpl0ApLjXKuD8rw1n1XLCwCUEL5eLPljTZaAveqdOFQOiZnZEGI27qIiZe7I1fN8tcz6anS/gTM7xRKE++5egEvRWlTQQTJeApnPSiUPA+8ZykNdelQsOQh5SrGoyI4A5pq****==	待驗證的簽名值。說明使用Base64編碼。
DryRun	String	否	false	是否開啟DryRun模式。 true：開啟 false（預設值）：關閉 DryRun模式用於測試API調用，驗證您是否具有相應資源的許可權，以及請求參數是否配置正確。DryRun模式開啟後，KMS會始終返回失敗並提示失敗原因。失敗原因包含如下： DryRunOperationError：不配置DryRun參數時，請求會成功。 ValidationError：請求中指定的參數有誤。 AccessDeniedError：您無權在KMS資源上執行該操作。

返回資料

名稱	類型	樣本值	描述
KeyVersionId	String	2ab1a983-7072-4bbc-a582-584b5bd8****	對明文資料進行加密的主要金鑰版本號碼。
KeyId	String	5c438b18-05be-40ad-b6c2-3be6752c****	主要金鑰的通用唯一識別碼。說明如果請求中的KeyId參數使用的是主要金鑰的別名，在響應中會返回別名對應的主要金鑰標識符。
Value	Boolean	true	簽名驗證是否通過。
RequestId	String	475f1620-b9d3-4d35-b5c6-3fbdd941423d	本次調用請求的ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。

樣本

請求樣本

http(s)://[Endpoint]/?Action=AsymmetricVerify
&KeyId=5c438b18-05be-40ad-b6c2-3be6752c****
&KeyVersionId=2ab1a983-7072-4bbc-a582-584b5bd8****
&Algorithm=RSA_PSS_SHA_256
&Digest=ZOyIygCyaOW6GjVnihtTFtIS9PNmskdyMlNKiuy****=
&Value=M2CceNZH00ZgL9ED/ZHFp21YRAvYeZHknJUc207OCZ0N9wNn9As4z2bON3FF3je+1Nu+2+/8Zj50HpMTpzYpMp2R93cYmACCmhaYoKydxylbyGzJR8y9likZRCrkD38lRoS40aBBvv/6iRKzQuo9EGYVcel36cMNg00VmYNBy3pa1rwg3gA4l3cy6kjayZja1WGPkVhrVKsrJMdbpl0ApLjXKuD8rw1n1XLCwCUEL5eLPljTZaAveqdOFQOiZnZEGI27qIiZe7I1fN8tcz6anS/gTM7xRKE++5egEvRWlTQQTJeApnPSiUPA+8ZykNdelQsOQh5SrGoyI4A5pq****==
&DryRun=false
&公用請求參數

正常返回樣本

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AsymmetricVerifyResponse>
    <KeyVersionId>2ab1a983-7072-4bbc-a582-584b5bd8****</KeyVersionId>
    <KeyId>5c438b18-05be-40ad-b6c2-3be6752c****</KeyId>
    <Value>true</Value>
    <RequestId>475f1620-b9d3-4d35-b5c6-3fbdd941423d</RequestId>
</AsymmetricVerifyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "KeyVersionId" : "2ab1a983-7072-4bbc-a582-584b5bd8****",
  "KeyId" : "5c438b18-05be-40ad-b6c2-3be6752c****",
  "Value" : true,
  "RequestId" : "475f1620-b9d3-4d35-b5c6-3fbdd941423d"
}

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	InvalidParameter	The specified parameter is not valid.	參數非法。
404	Forbidden.AliasNotFound	The specified Alias is not found.	指定的別名找不到
404	Forbidden.KeyNotFound	The specified Key is not found.	指定的密鑰不存在。

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