密码学与证书 / 系统课时

完成首次签名验证流程

完成首次签名验证流程

第一次验签应同时看到有效消息被接受和错误输入被拒绝。本篇在内存中生成测试密钥,对一段 UTF-8 消息签名,并分别修改消息、签名和公钥,建立以后排查接口问题时可以复用的最小验证闭环。

学习目标

  • 完成消息字节、签名和公钥的完整验证流程。
  • 用三个负面用例确认验证结果覆盖正确对象。
  • 区分验签失败与输入解析异常。

固定消息字节边界

密码接口处理字节,不处理“视觉上相同的文字”。字符串先按 UTF-8 转成 Buffer,再交给签名接口;验证方必须获得相同字节。终端显示不出末尾换行、不同 Unicode 形式或隐藏字符,这些差异都会改变待验证内容。

签名与消息可以分开传输,但验证需要消息、签名和可信公钥三个输入。私钥只在签名方使用。验证成功后不要再次改写消息再交给业务逻辑;业务执行的内容应与已经验证的内容保持一致。

签名方和验证方对同一消息字节操作,消息签名公钥共同决定校验结果

同时运行正面和负面用例

将以下完整程序保存为 first-sign.cjs,执行 node first-sign.cjs。它采用 Node.js 的一次性签名接口;官方文档规定 verify 返回验证结果,无法解析的密钥等输入仍可能抛异常。

js
const { generateKeyPairSync, sign, verify } = require('node:crypto');

const pair = generateKeyPairSync('ed25519');
const other = generateKeyPairSync('ed25519');
const message = Buffer.from('订单=42', 'utf8');
const signature = sign(null, message, pair.privateKey);
// 复制后变更,保留原始输入供有效用例使用。
const changedMessage = Buffer.from(message);
changedMessage[0] ^= 1;
const changedSignature = Buffer.from(signature);
changedSignature[0] ^= 1;
console.log('valid:', verify(null, message, pair.publicKey, signature));
console.log('changed message:', verify(null, changedMessage, pair.publicKey, signature));
console.log('changed signature:', verify(null, message, pair.publicKey, changedSignature));
console.log('wrong key:', verify(null, message, other.publicKey, signature));
// 确定性检查不能代替服务器的重放保护。
console.log('repeat equal:', signature.equals(sign(null, message, pair.privateKey)));

预期输出:

text
valid: true
changed message: false
changed signature: false
wrong key: false
repeat equal: true

输出说明三个输入都参与验证,且同一标准实现、密钥与消息的重复签名一致。这个测试使用随机生成的密钥,签名本身每次运行不同;不要把它当作跨实现的固定测试向量,也不要打印秘密材料来比较。

用错误分类缩小范围

若有效用例为 false,先比较实际消息长度和字节,再检查传入的是签名原始字节还是 Base64 文本。长度正确不代表内容正确:64 个 ASCII 字节不一定是一个有效的 64 字节签名。

若程序在公钥导入阶段就抛异常,密码学验证尚未发生。先确定公钥容器、编码和算法类型,再检查签名。为了让无效请求成为受控拒绝,可以在外层处理输入错误;但内部日志应区分解析错误与数学验证失败。

让测试闭环成为接入门槛

接入网络后,至少保留相同的有效、改消息、改签名和错密钥用例。客户端和服务端单独在本地成功并不能证明传输正确;应让客户端产生的数据直接进入服务端的真实解析与验证路径。

固定向量用于检验实现一致性,随机密钥闭环用于检验 API 使用,真实协议负面用例用于检验消息覆盖范围。三者目的不同。首次流程真正完成的标志,是你能解释每个拒绝结果来自哪项输入变化。

增加末尾换行是一个容易手动复现的字节变化:接收端显示内容看似相同,长度却多一个字节。应先修复生产者与接收者的字节契约,而不是在验证前自动删除空白,悄悄改变已经签署的消息。

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

目录与阅读设置

记录一个想法

完成首次签名验证流程

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

登录哪都通