签名验签说明

注意事项

字段值为null或者为""时不参与拼接

data字段为业务数据的原始字符串(JSON字符串)，不做二次编码

签名结果统一使用Base64编码

请求头Sign-Algorithm固定为RSA(标识使用RSA签名)

为了防止格式错误导致验签失败，在配置 RSA 公钥信息时，请务必注意以下两点：
1.去除首尾标记：请删除内容中的 -----BEGIN PUBLIC KEY----- 和 -----END PUBLIC KEY-----。
2.去除所有换行：请将公钥内容中的换行符（回车）全部删掉，使其缩减为一行连续的字符串后再进行复制粘贴，注意前后不要出现空格。

1. 算法与密钥规范

项目	说明
签名算法	SHA256WITHRSA
密钥长度	2048 bit
密钥格式	PKCS#8

2. 参与加签的字段

仅以下字段参与签名计算：

appId

data

serialNo

timestamp

3. 加签规则

字段筛选：从请求报文中取出 appId、data、serialNo、timestamp 四个字段。

排序规则：按字段名进行升序排序。

拼接规则：按排序后的顺序，将字段名和字段值进行拼接（例如：appId=xxx&data=xxx&serialNo=xxx&timestamp=xxx）。

签名计算：使用服务商自己的私钥对拼接后的字符串进行 SHA256WITHRSA 签名，得到 Base64 编码的签名值，放入请求报文的 signature 字段。

拼接示例

假设字段值如下：

{
  "appId": "app_001",
  "data": "{\"orderId\":\"ORD123456\"}",
  "serialNo": "202310210001",
  "timestamp": "1697875200000"
}

按字段名升序排序后顺序为：appId → data → serialNo → timestamp
拼接字符串为：

appId=app_001&data={"orderId":"ORD123456"}&serialNo=202310210001&timestamp=1697875200000

使用 PKCS#8 格式的 2048 bit 私钥，对该字符串进行 SHA256WITHRSA 签名，得到 signature。

4.验签规则

服务端使用付临门的公钥对请求报文中的 signature 进行验签。

4.1参与验签的字段

code

data

msg

4.2验签规则

字段筛选：从响应报文中取出 code、data、msg三个字段。

排序规则：按字段名进行升序排序。

拼接规则：按排序后的顺序，将字段名和字段值进行拼接（例如：code=xxx&data=xxx&msg=xxx）。

签名计算：使用公钥对拼接后的字符串进行 SHA256WITHRSA 验签

1. 算法与密钥规范#

2. 参与加签的字段#

3. 加签规则#

拼接示例#

4.验签规则#

4.1参与验签的字段#