这个工具做什么
HMAC 是「带密钥的哈希消息认证码」,规范写在 RFC 2104 里。它把一段密钥与一段消息一起送进哈希函数,输出一段固定长度的值。与普通哈希最大的不同是:没有密钥的人算不出同样的结果。因此接收方只要持有同一把密钥,就能验证这条消息确实来自持有密钥的一方,并且在传输过程中没有被改动。
这个页面支持四种底层哈希:MD5、SHA-1、SHA-256、SHA-512。选不同的算法,得到的 HMAC 长度不同,但计算结构完全一样。密钥可以按 UTF-8 文本输入,也可以按十六进制输入;后者适合密钥本身就是随机字节的场景,例如接口文档给出的是 6b6579 这样一串十六进制数。
结果同时给出十六进制与 Base64 两种写法。它们是同一串字节的两种表示,内容完全等价,只是不同系统要求的格式不同:有的接口要求小写十六进制,有的要求 Base64,还有的要求对 Base64 再做一次 URL 编码。工具还提供期望值比对,把对方给出的值粘贴进去,就能立刻看到是否一致,省去逐字符核对。
四种算法都用纯 JavaScript 实现,接收字节数组,没有调用浏览器提供的加密接口,也不加载任何外部脚本。因此断网、内网、或把页面拷到没有网络的机器上,功能都完整可用。所有运算在本地内存中完成,密钥与消息不会被发送出去。
怎么用
先选算法,再选密钥格式,然后分别填入密钥与消息,结果会自动更新。判断算法时以对方系统的文档为准,不要凭经验猜:同一个密钥和消息,用 SHA-256 与 SHA-1 算出的值完全不同。如果文档只写了「HMAC」没有写算法,可以先按 SHA-256 试,再逐个换算法与对方的值比对。
- 密钥选「文本」时按 UTF-8 编码成字节,中文密钥每个字通常占 3 个字节,复制时多带的一个空格也会参与计算。
- 密钥选「十六进制」时,空格、换行、制表符、冒号和连字符会被忽略,其余字符必须是 0-9 或 a-f。出现非法字符或字符个数为奇数时,会指出具体位置并停止计算。
- 「载入示例」填入一组公开的测试向量:密钥
key,消息The quick brown fox jumps over the lazy dog,算法 SHA-256。算出的十六进制应以f7bc83f4开头,可用来确认页面工作正常。 - 两个输出块各有「复制」按钮,复制的是完整结果,不带算法名或前缀。
比对时把对方的签名粘贴进「期望值比对」,工具会去掉所有空白并忽略大小写后比较。它同时接受十六进制与 Base64 两种写法,命中时会说明是与哪一种一致;不一致时会把本次算出的实际值完整列出来,方便对照是哪一段不同。注意这里只做字符串层面的比对,不判断对方的值在密码学上是否安全。
结果怎么解读
输出长度只由算法决定:MD5 输出 16 字节,写成十六进制是 32 个字符;SHA-1 输出 20 字节,40 个字符;SHA-256 输出 32 字节,64 个字符;SHA-512 输出 64 字节,128 个字符。Base64 是对同样的字节做编码,长度约为字节数的 1.33 倍,末尾可能带一个或两个等号。两种写法可以互相转换,不存在哪个更安全的问题。
HMAC 的内部结构值得了解,因为它解释了「为什么密钥长度不影响输出长度」。算法先把密钥补零或截断到哈希函数的分组长度:MD5、SHA-1、SHA-256 是 64 字节,SHA-512 是 128 字节。如果密钥比分组还长,就先对密钥做一次哈希,再把结果当作密钥。然后用密钥分别与 0x36、0x5c 逐字节异或,得到内层与外层的填充块,先算「内层填充 + 消息」的摘要,再算「外层填充 + 内层摘要」的摘要,第二次的结果就是 HMAC。
这个「两次哈希」的设计不是为了增加长度,而是为了阻断长度扩展攻击。普通哈希在已知摘要和消息长度时,攻击者可以在消息后面追加内容并推算出新的摘要;HMAC 的外层把内层结果整个再包一层,追加内容就无法得到合法的外层摘要。所以即便底层使用的是 MD5 或 SHA-1,HMAC 结构本身仍能抵抗这类攻击,但底层算法的碰撞问题依然存在,新系统应优先选择 SHA-256。
把同一个消息配不同密钥,结果会完全不同;改动消息里的一个字符,结果也会整体变化。这正是它可用于校验的原因:接收方重算一遍,只要任何一处不同,值就对不上。反过来,如果两个值一致,只能说明「持有同一密钥的人对同一段消息算出了同样的结果」,并不能说明消息本身的内容是否合理。
常见的几种情况
和对方的结果对不上
按可能性从高到低排查:算法是否一致;密钥格式是否一致(对方给的是十六进制字符串,还是这串字符本身的 UTF-8 字节,两者结果完全不同);密钥首尾是否多了空格或换行;消息是否被做过 URL 编码、JSON 序列化或换行转换。最有效的办法是把消息换成一段纯 ASCII 的短字符串,逐步排除编码因素。
对方要求 Base64,但值里出现了加号和斜杠
标准 Base64 的字母表包含 + 与 /,放进 URL 或表单时需要额外处理。有的系统改用 URL 安全字母表,把 + 换成 -、/ 换成 _ 并去掉补位。本页输出的是标准 Base64,若对方要求 URL 安全形式,需要自行替换字符,替换不改变字节内容,所以摘要本身仍然有效。
密钥很短,还能用吗
可以用,但不建议。HMAC 对短密钥没有额外保护,密钥越短越容易被穷举。常规建议是密钥长度不小于底层哈希的输出长度,例如用 SHA-256 时使用 32 字节以上的随机密钥。另外,密钥应当是随机字节而不是可读短语;如果一定要用短语,至少保证足够长且不可猜测。
值对上了,接口仍然返回签名错误
说明签名本身算对了,问题多半在协议层。常见原因有:参与签名的字段顺序或拼接分隔符与文档不一致;时间戳超出允许的窗口,被判定为重放;请求体在实际发送时被框架重新序列化,导致空白或字段顺序变化;HTTP 头里的签名与你计算的对象不是同一份内容。这类问题需要对照接口文档逐项核对,而不是继续在算法上找原因。
使用限制与提醒
单次计算中,消息上限为 200,000 字符,密钥上限为 4,096 字符。超过上限时工具会提示当前长度并停止计算,结果区保留上一次的内容,不会用截断后的数据算出一个看似正常的值。更长的消息建议在服务端或本地脚本中处理。
HMAC 不能替代数字签名。它只能证明「某个持有密钥的人算过这段消息」,无法证明是谁:任何拿到密钥的人都能生成合法值,因此它无法提供不可否认性。需要向第三方证明某条消息确实由某个身份发出时,应当使用非对称的数字签名,签名者持有私钥,验证者只需要公钥。
HMAC 也不解决重放与保密问题。攻击者截获一条带合法 HMAC 的请求后,可以原样重发;要防重放,协议里必须加入时间戳、随机数或递增序号,并由服务端记录已用过的值。消息本身仍是明文,需要保密时应先加密再认证,或使用同时提供加密与认证的算法组合。
最后是使用环境。生产密钥不应粘贴到公共电脑、共享浏览器或来路不明的网页里。本页虽然不联网、不上传,但浏览器扩展、剪贴板同步、输入法云同步都可能在页面之外带走内容。在正式环境里生成和校验签名,应当在受控的服务器或本地脚本中完成,本工具更适合调试联调阶段的问题。