密码学与证书 / 系统课时
处理签名传输编码
处理签名传输编码
64 字节签名经 HTTP 或 JSON 传输时通常要变成文本,编码错误会在密码计算之前破坏协议。本篇采用无填充 Base64url,给出严格解码和往返检查,并用长度与规范性负面测试确定服务端接受边界。
学习目标
- 区分签名原始字节、Base64 与 Base64url 文本。
- 实现长度和规范表示检查,拒绝模糊输入。
- 验证传输解码后的字节与原签名完全一致。
先固定编码契约
标准 Base64 使用加号和斜杠,Base64url 使用短横线和下划线;是否带等号填充必须由协议规定。编码仅改变表示,不提供保密或真实性。64 字节签名采用本课的无填充 Base64url 后固定为 86 个字符。
RFC 4648定义这些字母表及编码规则。不要把十六进制字符串、PEM 正文或 Base64 文本的 UTF-8 字节直接交给验签接口;验证所需的是恢复后的 64 字节签名。
解码器宽容不等于协议宽容
通用解码 API 可能接受多个字母表、空白或缺少填充等输入。Node.js Buffer 的 Base64 相关接口也有兼容行为。接口协议应先检查允许字符与长度,再解码并重新编码,要求结果与收到的文本一致。
重新编码检查还能发现未使用位非零的非规范文本。这类文本可能解码为相同字节,但会让缓存、审计与去重把一个签名当成多种字符串。规范表示有助于统一协议输入,并不应被误用为防重放机制。
完成严格往返测试
以下完整程序保存为 signature-encoding.cjs,执行 node signature-encoding.cjs。它将 Base64url 验证与密码学验证分开,拒绝填充、截断和非规范末尾字符。
const { generateKeyPairSync, sign, verify } = require('node:crypto');
function decodeSignature(text) {
if (typeof text !== 'string' || !/^[A-Za-z0-9_-]{86}$/.test(text)) {
throw new Error('encoding');
}
const bytes = Buffer.from(text, 'base64url');
// 重新编码拒绝非零的未使用位和其他非规范表示。
if (bytes.length !== 64 || bytes.toString('base64url') !== text) {
throw new Error('canonical');
}
return bytes;
}
const pair = generateKeyPairSync('ed25519');
const message = Buffer.from('transport check');
const signature = sign(null, message, pair.privateKey);
const wire = signature.toString('base64url');
const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
// 最后一个字符只含两个有效位;改变未使用位仍可得到相同字节。
const nonCanonical = wire.slice(0, -1) + alphabet[alphabet.indexOf(wire.at(-1)) + 1];
console.log('text chars:', wire.length);
console.log('same bytes:', decodeSignature(wire).equals(signature));
console.log('verified:', verify(null, message, pair.publicKey, decodeSignature(wire)));
for (const [name, value] of [['padding', wire + '='], ['truncated', wire.slice(1)],
['noncanonical', nonCanonical]]) {
try { decodeSignature(value); console.log(name + ': accepted'); }
catch { console.log(name + ': rejected'); }
}预期输出:
text chars: 86
same bytes: true
verified: true
padding: rejected
truncated: rejected
noncanonical: rejected签名每次运行不同,但字符数、字节数和验证结果稳定。这里并未输出原始签名,所以不存在需要替换的动态日志字段。若选择带填充 Base64,应修改完整契约和测试,而不是让这个解码器同时猜两种协议。
传输边界要独立诊断
客户端只编码一次,服务端只解码一次。重复编码会使文本明显变长,重复解码则把已经正确的随机字节误作字符。URL 参数还可能把标准 Base64 的加号解释为空格,这也是选择 Base64url 时需要消除的传输歧义。
生产入口限制字段总长度和字符集合,再处理密钥查找与验签。对外可以统一返回认证失败,内部则区分编码拒绝与签名不匹配。保留少量长度、算法和错误类别信息即可,不应为了定位编码问题输出私钥或完整敏感正文。
若协议允许不同签名表示,就必须说明接受后用于存储和比较的标准形式。本课选择在入口拒绝其他表示,使日志与数据库都只有一种签名文本。更新编码约定时应使用版本迁移,不能临时放宽正则却保留旧测试结论。
严格编码检查也应覆盖数据库读取路径:人工编辑或迁移导入可能绕过 HTTP 入口。恢复为字节后再交给验签,避免持久化列中的文本被直接当成密码接口的二进制参数。