密码学与证书 / 系统课时
使用 SM2 签名与验签
使用 SM2 签名与验签
SM2 签名和普通“消息 + 私钥 → 签名”的直觉大体一致,但它有一个特别值得工程师提前理解的地方:用户身份标识也会参与签名相关摘要计算。
这也是很多国密接口“明明 Key 和消息都一样,还是验签失败”的来源。
先看整体签名流程
签名方拥有:
text
SM2 私钥
SM2 公钥
用户标识 ID
消息 M流程可以先简化成:
text
用户 ID + 曲线参数 + 公钥
↓
ZA
ZA + 消息
↓ SM3
消息摘要 e
↓ SM2 私钥签名
Signature (r, s)验证方需要使用一致的信息重新计算并验证。
ZA 是什么,为什么要有它
可以把 ZA 理解成“把签名者身份和公钥参数绑定进来的摘要材料”。
它会和:
- 用户 ID;
- 椭圆曲线参数;
- 基点;
- 签名者公钥;
相关。
这样最终签名并不只是孤立地绑定消息,还绑定了签名者相关上下文。
现阶段不需要背 ZA 的逐字段拼接公式,但一定要知道它存在。
默认 ID 是联调事故高发区
某些密码库在没有显式传入用户 ID 时,会采用默认值;另一些库可能要求调用方主动配置。
于是很容易出现:
text
Java 端:使用默认 ID A
对端:使用业务 ID B两边消息、私钥、公钥、SM3 都没问题,但 ZA 不同,验签自然失败。
所以接口协议应该明确:
text
SM2 user ID 到底是什么?
按什么编码转换成字节?不要依赖库默认值完成跨系统协议。
签名值也有编码格式问题
SM2 签名核心同样得到两个整数:
text
r
s传输时可能使用:
text
ASN.1 DER也可能有协议要求固定长度拼接:
text
r || s如果一端返回 DER,一端按照固定 64 字节拆分,就会失败。
因此联调时要把:
text
算法
User ID
待签名数据
签名编码
Base64/HEX全部写进接口规范。
SM2 签名不是 SM2 加密反过来
再次强调:
text
SM2 加密
SM2 签名是不同算法流程。
不要写出类似:
text
privateKeyEncrypt(message)然后把结果叫“SM2 签名”。
应该直接使用密码库提供的标准 SM2 签名 API。
一个实用的联调排查顺序
当 SM2 验签失败,可以按下面顺序排:
text
1. 原始消息字节是否一致
2. 字符编码是否一致
3. SM2 User ID 是否一致
4. 公钥是否同一把
5. 签名是 DER 还是 r||s
6. Base64/HEX 是否多转一次
7. Provider 与曲线参数是否一致不要一失败就怀疑“国密算法有兼容问题”。
大多数业务联调故障最终都落在输入和编码约定上。
验签成功后还要做业务判断
验签成功只说明密码学验证成立。
支付回调仍然要继续检查:
- timestamp 是否过期;
- requestId 是否已处理;
- orderId 是否属于当前商户;
- 金额是否与原订单一致;
- 订单状态是否允许变化。
数字签名不能替代业务幂等和状态机。
本课小结
SM2 签名最需要额外记住的是 ZA 和用户 ID。签名与验签双方必须在消息字节、用户 ID、公钥、签名编码、Base64/HEX 表示上完全一致。
验签成功解决的是密码学身份与完整性验证,业务层仍然要继续完成防重放、幂等和订单规则校验。
按自己的节奏,确认真正理解。