密码学与证书 / 系统课时

设计可验证的签名数据

设计可验证的签名数据

数字签名真正处理的不是“业务对象”,而是最终的一串字节。同一个 JSON,如果字段顺序、空格、换行或字符编码不同,签名结果就会不同。

为什么双方明明数据一样却验签失败

例如发送方得到:

text
orderId=A10001&amount=100&currency=CNY

接收方却得到:

text
amount=100&currency=CNY&orderId=A10001

业务语义相同,但字节不同,所以摘要和签名都不同。

业务对象到规范化签名串的数据流

先定义 canonical string

canonical string 可以理解为“双方唯一认可的待签名格式”。例如约定:

  1. HTTP 方法转大写;
  2. 路径保持协议规定形式;
  3. 参数按字段名排序;
  4. 空值处理规则固定;
  5. 字符集统一 UTF-8;
  6. Body 先计算 SHA-256;
  7. 字段使用固定换行符拼接。

最终可能是:

text
POST
/api/payment
1700000000
550e8400-e29b-41d4-a716-446655440000
8f434346...

数字签名只认这段字节,不理解“这是订单对象”。

不建议直接签 Map.toString()

下面这种做法非常脆弱:

java
sign(params.toString().getBytes(StandardCharsets.UTF_8));

Map 顺序、序列化格式或语言实现变化后都可能导致结果不同。更稳妥的做法是先把规范化逻辑独立成函数,再把最终 UTF-8 字节交给签名算法。

java
static String canonicalize(String method, String path,
                           long timestamp, String nonce,
                           String bodyHash) {
    return String.join("\n",
            method.toUpperCase(), path,
            Long.toString(timestamp), nonce, bodyHash);
}

把上下文一起签进去

如果只签 Body,合法签名可能被搬到另一个接口使用。高风险接口通常还会绑定:

text
method
path
timestamp
nonce
bodyHash
调用方身份或租户

这样签名不仅绑定“内容”,也绑定“这条内容应该出现在哪里”。

联调时先比较摘要

双方可以记录:

text
algorithm
keyId
canonical SHA-256
signature Base64

如果 canonical SHA-256 已经不同,问题一定发生在签名前的数据处理阶段,不必先怀疑 RSA、ECDSA 或 SM2。

本课小结

可靠签名协议的第一步不是选算法,而是让双方对“签哪串字节”没有歧义。规范化、上下文绑定和可观测的摘要,是后续签名工程稳定运行的基础。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计可验证的签名数据

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

登录哪都通