1. 签名简介

本文档旨在介绍商户、合作方与我司系统之间进行报文双向认证的签名机制。这一机制确保了交易请求和应答的安全性和完整性。

1.1 签名机制概述

● 私钥与公钥管理：商户、合作方需保存自己的私钥，并持有我司系统的公钥；我司系统则保存自己的私钥，并持有商户、合作方的公钥。
● 交易请求签名：商户、合作方在发起交易请求时，使用自己的私钥对请求进行签名。
● 交易请求验签：我司系统在接收到交易请求后，使用商户、合作方的公钥对签名进行验证。
● 交易应答签名：我司系统在返回交易应答时，使用自己的私钥对应答进行签名。
● 交易应答验签：商户、合作方在接收到交易应答后，使用我司系统的公钥对签名进行验证。

1.2 签名原理详解

签名原理涉及以下步骤：

参数收集与排序：获取所有公共请求参数，包括bizContent业务参数，排除字节类型参数（如文件、字节流），并剔除值为空的参数（包括null和空字符串）。按照参数名的ASCII码顺序进行排序，若参数名相同，则按第二个字符的ASCII码顺序排序，依此类推。

待签名字符串生成：将排序后的参数与其对应值组合成参数=参数值的格式，并使用&字符连接，形成待签名字符串。

签名生成：使用RSA2私钥（2048位，SHA256WITHRSA）对待签名字符串进行签名，生成签名串sign。商户需自行生成密钥对，私钥由商户保存，公钥提供给我司系统用于验签。

2. 签名流程示例

2.1 私钥示例

以下是一个示例私钥，用于说明签名流程不可用于其他地方

2.2 请求参数示例

2.3【生成待签名字符串】

2.4【生成签名】

2.5【完整请求参数】

3. 验签原理

获取请求中所有参数和签名值sign，错误同步返回请不要验签。

剔除值为空的参数（包含null与空字符串），按照第一个字符的键值 ASCII 码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值 ASCII 码递增排序，以此类推。

生成待验签字符串：使用与加签相同的方法（key=value&）拼接参数，得到字符串 stringA。务必确保嵌套对象的处理方式完全一致。

详情见加/验签DEMO。

2.2 加签验签说明

1. 签名简介#

1.1 签名机制概述#

1.2 签名原理详解#

2. 签名流程示例#

2.1 私钥示例#

2.2 请求参数示例#

2.3【生成待签名字符串】#

2.4【生成签名】#

2.5【完整请求参数】#

3. 验签原理#