加密/哈希

HMAC 计算器

使用密钥计算 HMAC 消息认证码,支持 SHA-1/SHA-256/SHA-384/SHA-512

输入文本
密钥
算法:
HMAC 结果
等待输入...

什么是 HMAC?

HMAC(Hash-based Message Authentication Code,基于哈希的消息认证码)是一种使用密钥和哈希函数计算消息认证码的算法。与普通哈希不同,HMAC 需要密钥参与计算,只有持有相同密钥的双方才能生成或验证相同的 HMAC 值,常用于 API 签名、JWT 签名和防篡改校验。

支持的算法

  • SHA-1:160 位输出,兼容旧系统
  • SHA-256:256 位输出,推荐使用
  • SHA-384:384 位输出
  • SHA-512:512 位输出,更高安全强度

使用场景

  • API 签名:验证请求来自合法客户端且未被篡改
  • JWT 签名:HS256/HS384/HS512 等算法基于 HMAC
  • Webhook 校验:验证回调数据的真实性
  • 数据完整性:在传输或存储时验证数据未被修改

安全提示

密钥应妥善保管,不要泄露或提交到代码仓库。生产环境建议使用环境变量或密钥管理服务存储密钥。

用共享密钥对 UTF-8 文本计算 HMAC 标签,哈希函数可选 SHA-1、SHA-256、SHA-384 或 SHA-512,结果按十六进制展示。适合在联调时复现服务端或 Webhook 发送方算出的签名,并排查 HS256 令牌与接口签名对不上的原因。

两轮哈希与一个分组长度

按 RFC 2104 与 FIPS 198-1,标签的构造是 H((K ^ opad) || H((K ^ ipad) || M)),其中 ipad 是重复的字节 0x36、opad 是 0x5c。密钥先被归一化成一个哈希分组:SHA-1 与 SHA-256 为 64 字节,SHA-384 与 SHA-512 为 128 字节,不足补零、超长则先哈希缩短。这一点在结果框里能直接看到两个后果:标签长度恒等于所选摘要长度(20、32、48 或 64 字节),因为外层只处理一对固定大小的数据块;密钥超过分组长度后不再带来额外作用,所以在选 SHA-256 时,200 字节的密钥与它的 SHA-256 摘要会得到完全相同的标签。

密钥框收的是字符,不是十六进制字节

消息与密钥两处的字符串都会先经 TextEncoder 转成 UTF-8 字节再交给 crypto.subtle.sign,因此密钥就是你所输入的字面字符。一串 64 个字符的十六进制密钥会被当成 64 个 ASCII 字节参与运算,而不是别处意义上的 32 字节原始密钥;中文口令每个汉字占 3 字节。工具没有密钥格式开关,也没有 Base64 密钥和 MD5 选项。空值校验用的是 trim(),但参与签名的是未经裁剪的原串,所以在文本框末尾多敲一个换行,标签的每个字节都会变,而界面看起来毫无异常。大写勾选只是在签名完成后改写十六进制字母的大小写。

与环境另一端的签名逐字节对齐

要验证对方的签名,必须把被签名的那串字节原样喂进来。HS256 的待签内容是 base64url(header)、一个点号、再拼上 base64url(payload) 的纯 ASCII 字符串,把它换成十六进制后应与 JWT 第三段一致。GitHub 在 X-Hub-Signature-256 里给同一个十六进制值加了 sha256= 前缀,且是对原始请求体计算的,因此把 JSON 重新格式化会改变空白与键序,标签随之变化。长度也可作自检:SHA-1 是 40 个字符,SHA-256 是 64 个,SHA-384 是 96 个,SHA-512 是 128 个;长度不符说明对方用的算法与这里所选的不一致。

实操示例

复现工具内置示例的 SHA-256 标签

输入
消息:Hello, DevToolbox! | 密钥:my-secret-key | 算法:SHA-256
输出
953537baf822bdc213ea5076e123c542fb87986940e35c9b238f8247088a3538

消息在 UTF-8 下是 18 字节,密钥是 13 字节,远短于 SHA-256 的 64 字节分组,所以密钥补零后直接参与内外两轮哈希。输出恒为 32 字节,即 64 个十六进制字符;勾选「大写」只把字母变成 953537BA...3538 的形式。若在消息末尾多加一个换行,结果会变成 ef961f26...bf3605。

边界与常见误用

  • 两个输入都按 UTF-8 文本处理,若密钥是以原始字节或十六进制字节下发的,就必须还原成签名端实际哈希的那串字符才能对上。
  • Web Crypto 只提供 SHA-1、SHA-256、SHA-384、SHA-512,老系统里的 HMAC-MD5 标签无法在此校验。
  • 密钥为空或全是空白就被拒绝,而 RFC 2104 本身允许零长度密钥,这类标签得换别的方式计算。
  • 需要安全上下文(HTTPS 或 localhost);在普通 HTTP 页面里 crypto.subtle 为 undefined,不会产生任何标签。
  • 结果只输出十六进制,且在停止输入 300 毫秒后才重算:没有 Base64 形式、没有截断长度选项,也不做与期望值的比对。

相关工具

先分清:你是要算出一个标签,还是要判定收到的那个

你手上的情况本页的 HMAC 计算器更该用的东西
对方把签名发过来了,你只需要回答「对不对」结果框里就一串可点击复制的值:没有粘贴对方签名的输入框,页面也不做任何比对,那 64 个十六进制字符只能逐位拿眼睛对。把比对写进代码——Node 里 crypto.timingSafeEqual(Buffer.from(本地, "hex"), Buffer.from(对方, "hex")),两个缓冲区长度不等时它直接抛错。本站的 JWT 解析器帮不上忙:它自己写明只解析内容、不验证签名。
接收方要的是 Base64 的标签,不是十六进制这里只输出十六进制(可以切成大写),要交给 Base64 接口,就得先把它还原成 32 字节再到别处编码。openssl dgst -sha256 -hmac "$KEY" -binary | base64 把原始标签直接输出成 Base64,密钥放进变量后是一行命令,而不是一次换算。
密钥昨晚轮换了,200 条留存的回调要重新核一遍一次一段消息、一把密钥、一个标签。换消息时密钥还留在框里,但没有队列、没有选文件的入口,也没有导出,每条正文都要粘一次,每个标签都要点一次复制。交给 shell 循环:for f in deliveries/*.json; do openssl dgst -sha256 -hmac "$SECRET" "$f"; done。dgst 直接读文件原始字节,不会像 $(cat ...) 那样把末尾换行吃掉。
你想复现身份验证器里那 6 位动态码HMAC-SHA1 在这里停在完整的 20 字节、40 个字符上。RFC 4226 那步——取末字节低四位的偏移、31 位掩码、模 10^6——得你自己动手。oathtool --totp -b <Base32密钥> 把时间步、动态截断和补零一次做完;本页既不做截断,也不收 Base32 密钥。
所谓的「密钥」其实是一个人自己敲的密码密钥框里打进去什么字符就是什么字节,没有任何拉伸:八个字母的密码就是 8 个字节,猜一次的成本就是一个 HMAC。先用本站的 PBKDF2 工具正经拉伸:十六进制盐由你给,默认 210000 次迭代(可填 1000 到 2000000)。但派生出的字节没法当字符塞进这里的密钥框,签名要和派生放在同一处做。
正文本身就不能让人看见这里只解决「是谁、有没有被改」,不解决「别人看不看得懂」:正文和标签一起明文上路,拦到请求的人能读那份 JSON,也能改它。换成本站的 AES-GCM 工具——口令派生的密钥、12 字节 IV、16 字节标签,既藏起来又能验篡改;只有正文本来就公开、只需防改动时,才轮到 HMAC 出面。

一个具体场景

字段多少位,算法就被定死了

一个下午在两个合作方之间来回切,最容易栽在这个下拉框上。它会保留你上一次的选择:刚给要 128 个字符标签的甲方案完 SHA-512,接着处理乙方的报文,顺手点「示例」看布局——它只填了 Hello, DevToolbox! 和 my-secret-key,SHA-512 还停在原处,于是又出来 128 个字符,正好是乙方那个 64 位字段的两倍宽,页面上没有任何提示。先把下拉切回 SHA-256,再粘进那段 640 字节的正文;对方字段存的是小写,就别勾「大写」,否则标签一模一样,字符串比较照样失败。要是对方给的宽度跟四个算法都对不上,说明它在截断标签,本页跟不了。

常见问题

HMAC 和普通哈希有什么区别?
普通哈希任何人都能算;HMAC 是带密钥的哈希——只有持有密钥的一方才能生成和验证。所以 API 请求签名、Webhook 验证(GitHub、Stripe)都用 HMAC:接收方用共享密钥重算一遍比对,就能确认请求确实来自持有密钥的一方且未被篡改。
为什么比较 HMAC 要用恒定时间比较?
普通的 === 比较在第一个不匹配的字符处提前返回,攻击者可以通过测量耗时逐字节猜出正确签名(时序攻击)。代码里请用 crypto.timingSafeEqual 或语言提供的恒定时间比较函数。
HMAC 能代替密码哈希来存密码吗?
不能。HMAC 计算太快,GPU 暴力破解成本很低。存密码要用专门的慢哈希(bcrypt、Argon2id、PBKDF2)。HMAC 的定位是"消息认证",不是"口令存储"。

内容复核: