CertificatePrivateKeySign - 使用X.509数字证书私钥为消息签名

使用指定证书生成数字签名。

接口说明

请求参数中签名算法需要跟密钥类型对应。签名算法和密钥类型对照表如下：

Algorithm	Key Spec
RSA_PKCS1_SHA_256	RSA_2048
RSA_PSS_SHA_256	RSA_2048
ECDSA_SHA_256	EC_P256
SM2DSA	EC_SM2

本文将提供一个示例，使用 ID 为12345678-1234-1234-1234-12345678****的证书，通过ECDSA_SHA_256签名算法为原始数据VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4=生成数字签名。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
CertificateId	string	是	证书 ID。证书管家中证书的全局唯一标识符。	12345678-1234-1234-1234-12345678****
Algorithm	string	是	签名算法。取值： RSA_PKCS1_SHA_256 RSA_PSS_SHA_256 ECDSA_SHA_256 SM2DSA 说明 SM2DSA 签名算法仅在中国内地使用托管密码机的地域支持。更多信息，请参见托管密码机概述。	ECDSA_SHA_256
MessageType	string	是	消息类型。取值： RAW（默认值）：原始数据。 DIGEST：原始数据的消息摘要（哈希值）。	RAW
Message	string	是	待签名数据。使用 Base64 编码。例如：待签名数据的十六进制内容为`[0x31, 0x32, 0x33, 0x34]`，则对应的 Base64 编码为`MTIzNA==`。当 MessageType 取值为 RAW 时，数据内容需小于 4KB。如果待签名数据内容大于 4KB，您可以将 MessageType 指定为 DIGEST，将 Message 指定为本地计算的消息摘要（又称哈希值）。证书管家将使用您自己的证书应用系统计算消息摘要，使用的消息摘要算法须与指定签名算法需要的消息摘要算法保持一致。具体如下： RSA_PKCS1_SHA_256、RSA_PSS_SHA_256 和 ECDSA_SHA_256 对应的消息摘要算法为 SHA-256。 SM2DSA 对应的消息摘要算法为 SM3。说明当证书密钥规格为 EC_SM2，并且 MessageType 为 DIGEST 时，Message 值为 GB/T 32918.2-2016 6.1 中描述的`e`。	VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4=

返回参数

名称	类型	描述	示例值
	object
SignatureValue	string	签名值。使用 Base64 编码。	ZOyIygCyaOW6Gj****MlNKiuyjfzw=
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	5979d897-d69f-4fc9-87dd-f3bb73c40b80
CertificateId	string	证书 ID。	12345678-1234-1234-1234-12345678****

示例

正常返回示例

JSON格式

{
  "SignatureValue": "ZOyIygCyaOW6Gj****MlNKiuyjfzw=",
  "RequestId": "5979d897-d69f-4fc9-87dd-f3bb73c40b80",
  "CertificateId": "12345678-1234-1234-1234-12345678****"
}

错误码

HTTP status code	错误码	错误信息	描述
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.	-

访问错误中心查看更多错误码。