用 Node.js 校验签名时,别用 === 比较密钥

举报
yd_235245466 发表于 2026/11/18 11:23:47 2026/11/18
【摘要】 用 Node.js 校验签名时,别用 === 比较密钥写接口鉴权的时候,比较两个字符串是不是相等,多数人顺手就写了 ===。校验 API 签名、比对 webhook 密钥、检查会话 token,都是这个写法。功能上没问题,测试也全过,但它有一个不跑压测看不出来的毛病:=== 在第一个不一样的字节处就返回 false。这意味着攻击者可以通过测量响应时间,一个字节一个字节地猜出密钥内容。第一位...

用 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 篡改检测等,脚本可原样运行。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。