密码学与证书 / 系统课时
设计可验证的签名数据
设计可验证的签名数据
数字签名真正处理的不是“业务对象”,而是最终的一串字节。同一个 JSON,如果字段顺序、空格、换行或字符编码不同,签名结果就会不同。
为什么双方明明数据一样却验签失败
例如发送方得到:
text
orderId=A10001&amount=100¤cy=CNY接收方却得到:
text
amount=100¤cy=CNY&orderId=A10001业务语义相同,但字节不同,所以摘要和签名都不同。
先定义 canonical string
canonical string 可以理解为“双方唯一认可的待签名格式”。例如约定:
- HTTP 方法转大写;
- 路径保持协议规定形式;
- 参数按字段名排序;
- 空值处理规则固定;
- 字符集统一 UTF-8;
- Body 先计算 SHA-256;
- 字段使用固定换行符拼接。
最终可能是:
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。
本课小结
可靠签名协议的第一步不是选算法,而是让双方对“签哪串字节”没有歧义。规范化、上下文绑定和可观测的摘要,是后续签名工程稳定运行的基础。
按自己的节奏,确认真正理解。