用 Node.js 校验签名时,别用 === 比较密钥
用 Node.js 校验签名时,别用 === 比较密钥
写接口鉴权的时候,比较两个字符串是不是相等,多数人顺手就写了 ===。校验 API 签名、比对 webhook 密钥、检查会话 token,都是这个写法。功能上没问题,测试也全过,但它有一个不跑压测看不出来的毛病:=== 在第一个不一样的字节处就返回 false。
这意味着攻击者可以通过测量响应时间,一个字节一个字节地猜出密钥内容。第一位对了的请求,比第一位就错的请求多花一点时间。单次测量区分不出来,但攻击者可以重复上万次取平均。这个攻击叫 timing attack,对公网接口是真实存在的威胁。
Node 自带的解法是 crypto.timingSafeEqual():无论两个 buffer 差在哪里,比较耗时都一样,攻击者测不出差异。下面这些点都是我在 Node v22.22.0 上逐条跑过的。
直接用会抛错
timingSafeEqual 只接受等长的两个 buffer,长度不等直接抛错:
const crypto = require('node:crypto');
crypto.timingSafeEqual(Buffer.from('a'), Buffer.from('ab'));
// RangeError: Input buffers must have the same byte length
// code: 'ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH'
这不是坑,是设计:长度不相等本身就泄漏信息,API 强迫你先处理长度。但签名校验场景里,攻击者提交的签名长度是任意的,所以正确写法是先比长度,再恒时比较:
function verifySignature(payload, receivedSigHex, secret) {
const expected = crypto.createHmac('sha256', secret).update(payload).digest();
const received = Buffer.from(receivedSigHex, 'hex');
if (expected.length !== received.length) return false;
return crypto.timingSafeEqual(expected, received);
}
错误长度的签名在这里被静默拒绝,正常长度的走恒时比较。我跑了一个完整测试:正确签名通过、篡改一位的签名被拒绝、错误长度的签名不抛错只返回 false,三项都符合预期。
不要拿用户的 secret 直接比
一个常见误用是把用户提交的密码或密钥和库里存的直接比:
// 别这样
timingSafeEqual(Buffer.from(inputSecret), Buffer.from(realSecret))
如果攻击者能控制两个输入中的一个,比如把超长输入灌进来,Buffer.from 的长度本身就成了可测的信号。规范做法是双方都对内容做 HMAC,比较两个定长摘要——HMAC 把任意长度输入压成 32 字节,长度信号就消失了:
const expected = crypto.createHmac('sha256', serverSecret).update(inputSecret).digest();
const actual = crypto.createHmac('sha256', serverSecret).update(storedSecret).digest();
return crypto.timingSafeEqual(expected, actual);
生成 token 用 randomBytes,别用 Math.random
配套的还有 token 生成。Math.random() 不是密码学安全的,生成的 token 可预测。用 crypto.randomBytes:
const token = crypto.randomBytes(32).toString('base64url');
// 43 个字符,256 位熵
我验证过:32 字节经 base64url 编码后固定是 43 个字符,只含 A-Z a-z 0-9 - _,可以直接放进 URL 或 header。
什么时候需要在意这件事
不是所有比较都要换。内部脚本、构建工具、本地配置比对,=== 没有任何问题——攻击面不存在。需要换的是这几类:
- 校验外部提交的签名或密钥(支付回调、webhook、开放 API)
- 比对会话 token、API key、重置密码的临时令牌
- 任何攻击者可以高频重试、且比较对象包含秘密的路径
timingSafeEqual 的代价是每次调用都要先转 buffer、检查长度,代码多一点,但也就多了两行。
示例在 Node.js v22.22.0 上通过 13 项验证,包括长度不等抛错、错误码断言、HMAC 篡改检测等,脚本可原样运行。
- 点赞
- 收藏
- 关注作者
评论(0)