文档中心

非对称密钥签名验证

最近更新时间：2023.06.21 16:55:02

首次发布时间：2023.06.21 16:55:02

AsymmetricVerify

描述：使用非对称密钥进行签名验证。
请求方法：Post
请求业务参数：

名称	类型	是否必选	示范值	描述
Action	是	string	AsymmetricVerify	接口名，取值：AsymmetricVerify
Version	是	string	2021-02-18	版本号，取值：2021-02-18
KeyringName	String	否	test_keyring-1	密钥环的别名。长度为 2 - 31 个字符合法字符：[a-zA-Z0-9-_] 二选一： KeyringName 和KeyName KeyID
KeyName	String	否	test_key-1	密钥的别名。长度为 2 - 31 个字符合法字符：[a-zA-Z0-9-_]
KeyID	String	否	39a0e7c6-b7dd-4c83-b400-3449bb95403a	密钥ID
Message	bytes	是	Base64-encoded binary data object	验签消息。当MessageType取值为RAW时：如果指定原始签名数据，会使用Algorithm中对应的哈希算法，对原始消息生成摘要，之后再进行签名。当MessageType取值为DIGEST时：最大长度为32字节。 raw: Minimum length of 1. Maximum length of 4096.
MessageType	string	否	RAW	消息类型，取值： RAW（默认值）：原始数据。 DIGEST：原始数据的消息摘要。KMS不会对原始数据的消息摘要进行数据处理，将直接使用私钥进行签名。
Algorithm	string	是	RSA_PSS_SHA_256	注意：签名算法需要与Sign接口返回的算法保持一致。
Signature	bytes	是	Base64-encoded binary data object	待验证的签名值。 Length Constraints: Minimum length of 1. Maximum length of 6144.

返回业务参数：

名称	类型	描述
ResponseMetaData	ResponseMetaData	返回公共参数
Result	SignatureValid	bool	签名验证是否通过。取值： true：签名验证通过。 false：签名验证未通过。
KeyID	String	所使用的密钥ID

名称

类型

描述

ResponseMetaData

返回公共参数

Result

SignatureValid

bool

签名验证是否通过。取值：

true：签名验证通过。
false：签名验证未通过。

KeyID

String

所使用的密钥ID

请求示例：

https://kms.volcengineapi.com?Action=AsymmetricVerify&Version=2021-02-18&KeyringName=test_keyring-1&KeyName=test_key-1&Message=MessageToBeSigned=&Algorithm=RSA_PSS_SHA_256&MessageType=RAW& Signature=OuodVCE1zYpDFg1QvgOHtVQxkQWhfpE8i8NibiJ1pL8ILgAE+TogQZuIglAoo=

返回示例：

{
    "ResponseMetadata": {
        "RequestId": "202107121937490102252431000312DA6D",
        "Action": "AsymmetricVerify",
        "Version": "2021-02-18",
        "Service": "kms",
        "Region": "cn-north-1"
    },
    "Result": {
     "SignatureValid":"true",
     "KeyID": "39a0e7c6-b7dd-4c83-b400-3449bb95403a"
    }
}

AsymmetricVerify

密钥管理系统

非对称密钥签名验证

AsymmetricVerify