HMAC 签名生成与验证

输入消息和密钥,计算 HMAC-SHA256 等签名,粘贴收到的签名即可比对;内置 GitHub、Stripe、Slack、Shopify Webhook 和钉钉、飞书机器人的签名规则,自动拼接待签名字符串并给出请求头或网址写法。密钥只在浏览器本地使用,不会上传。

HMAC 是什么

HMAC(基于哈希的消息认证码)用一个只有双方知道的密钥对消息做哈希。接收方用同样的密钥重新计算,结果一致就说明消息确实来自持有密钥的一方,并且传输中没有被修改。Webhook 回调、开放平台接口签名、JWT 的 HS256 都使用 HMAC。

  • 签名对不上的常见原因:①消息不是原始字节——Webhook 要用收到的原始请求体签名,先解析成 JSON 再序列化会改变空格和键的顺序;②多了或少了换行;③密钥格式不对,平台给的十六进制或 Base64 密钥被当成了文本;④输出格式不同,十六进制和 Base64 不能直接比较;⑤时间戳单位错了,钉钉用毫秒,飞书用秒。
  • 服务端比较要用恒定时间:用普通的字符串相等比较签名,可能通过响应时间被逐字符猜出,应使用 Node.js 的 crypto.timingSafeEqual、Python 的 hmac.compare_digest、Go 的 hmac.Equal。
  • 检查时间戳防重放:Stripe、Slack 等把时间戳也放进签名里,服务端应拒绝超过 5 分钟的请求,防止截获的请求被重复发送。
  • 密钥长度:密钥至少和哈希输出一样长(HMAC-SHA256 用 32 字节以上的随机密钥)。

不带密钥的普通哈希值请用 哈希值计算,查看 JWT 中的签名信息可以用 JWT 解码工具。

HMAC 签名生成与验证常见问题

HMAC 签名生成与验证怎么使用?

选择“通用”或某个平台的签名规则,填写消息、时间戳和密钥;通用模式下可以选择密钥格式、算法和输出格式;右侧显示签名、待签名字符串和请求头写法,在“要验证的签名”中粘贴收到的签名即可比对。

HMAC 和普通哈希有什么区别?

HMAC 需要密钥,没有密钥的人无法生成正确的签名,可以证明消息来源;普通哈希任何人都能计算。

钉钉机器人的签名怎么算?

把“毫秒时间戳 + 换行 + 密钥”作为消息,用密钥做 HMAC-SHA256,结果 Base64 编码后再做网址编码。

飞书机器人的签名怎么算?

把“秒级时间戳 + 换行 + 密钥”作为 HMAC-SHA256 的密钥,对空消息签名,再 Base64 编码。

GitHub Webhook 怎么验证?

用 Webhook 密钥对原始请求体做 HMAC-SHA256,十六进制结果前加 sha256= 与 X-Hub-Signature-256 请求头比较。

HMAC 签名生成与验证的结果应怎样理解?

平台规则按各平台公开文档实现,平台调整规则时请以官方文档为准;只计算签名,不会发送任何请求。

输入内容会保存或发给外部服务吗?

消息和密钥只在浏览器本地计算,不会上传。

没有结果或操作失败时先检查什么?

签名对不上时,先确认消息是收到的原始请求体,没有多余的空格或换行,再确认密钥格式和时间戳单位。

相关工具

Webhook 发送测试 · GitHub Actions 工作流生成器 · 哈希值计算 · README 生成器 · 全部开发工具