密码学与证书 / 系统课时

使用 SM2 签名与验签

使用 SM2 签名与验签

SM2 签名和普通“消息 + 私钥 → 签名”的直觉大体一致,但它有一个特别值得工程师提前理解的地方:用户身份标识也会参与签名相关摘要计算。

这也是很多国密接口“明明 Key 和消息都一样,还是验签失败”的来源。

先看整体签名流程

签名方拥有:

text
SM2 私钥
SM2 公钥
用户标识 ID
消息 M

流程可以先简化成:

text
用户 ID + 曲线参数 + 公钥
          ↓
         ZA

ZA + 消息
   ↓ SM3
消息摘要 e
   ↓ SM2 私钥签名
Signature (r, s)

SM2 的 ZA、消息摘要与签名验签关系

验证方需要使用一致的信息重新计算并验证。

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 表示上完全一致。

验签成功解决的是密码学身份与完整性验证,业务层仍然要继续完成防重放、幂等和订单规则校验。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 SM2 签名与验签

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通