HMAC 是什么
HMAC(Hash-based Message Authentication Code)是「带密钥的哈希」:同样的消息,密钥不同结果就完全不同;没有密钥就算知道算法也伪造不出来。它同时保证完整性(消息被改过签名就对不上)和身份(只有持密钥的一方能算出正确值)。
常见对接场景
- Webhook 验签:GitHub、Stripe 都在请求头里带 HMAC 签名,服务端用同一个密钥重算比对。
- 开放平台 API:把参数按字典序拼接后用 HMAC-SHA256 签名,防止参数被篡改。
- 对象存储直传:临时凭证里的签名串,本质也是 HMAC 链。
签名对不上怎么排查
- 参数顺序:很多平台要求按 key 的字典序拼接,顺序错了签名一定错。
- 编码:中文要先统一 UTF-8;URL 编码用大写百分号还是小写、空格用 + 还是 %20,都可能影响。
- 换行与空白:多行待签名串里的 \\n 和实际换行要一致,末尾多一个空格就全错。
- 密钥格式:有的平台给的是 Base64 或 Hex 字符串,需要先解码成字节再当密钥,本工具的上方下拉框就是干这个的。
安全提醒
计算全部在浏览器本地完成,密钥不会发送到任何服务器。但仍建议不要在公用电脑或录屏状态下粘贴生产密钥,调试完及时更换临时密钥。
功能说明
HMAC 签名在线计算
对接第三方 API 时,最常卡住的一步就是签名:文档写了「用 HMAC-SHA256 对拼接串签名」,但算出来和对方的示例值对不上。这个页面把四种常用算法一次全算出来,配合三种输出格式,可以快速比对到底是算法不对、密钥解读方式不对,还是待签名串本身的空白有问题。
为什么一次算四种
很多平台的文档写着 SHA256,实际代码用的是 SHA1(历史遗留);也有平台在 v1 用 SHA1、v2 换成 SHA256。一次列出四种,对照对方的示例值就能立刻确定是哪一种,不用来回改代码重跑。
三种输出格式的区别
- Hex:十六进制小写,最常见,请求头里的签名多为这种。
- Base64:标准 Base64,含 + 和 /,放进 URL 时要额外编码。
- Base64URL:把 + 换成 -、/ 换成 _、去掉尾部 =,可以直接放进 URL 和 JWT。
和普通哈希的区别
普通哈希(SHA256、MD5)没有密钥,任何人拿到原文都能算出同样结果,只能校验完整性;HMAC 掺入了密钥,没有密钥算不出正确值,因此能同时验证「谁发的」。所以校验 Webhook 来源要用 HMAC,不要用普通哈希。
使用步骤
1. 在「密钥 Secret」中填写需要处理的数值。
2. 在「待签名字符串」中粘贴要处理的内容。
3. 点击「Hex」按钮执行。
4. 在结果区核对输出结果,需要留档时手动复制。
常见问题
HMAC签名生成器能做什么?
计算 HMAC 签名:一次给出 HMAC-SHA1 / SHA256 / SHA384 / SHA512 四种结果。全部处理在浏览器本地完成,无需注册、无需安装。
计算结果的依据是什么?
按页面标注的公式与通用口径计算,页面上会给出取值说明。不同机构、不同地区可能存在细则差异,结果用于参考与快速估算。
结果和实际数值有出入怎么办?
先核对单位与口径(是否含税、是否按自然月、是否四舍五入),大部分偏差来自这里。确认输入无误仍有差异,说明该场景存在地方性或行业性规则。
填的数值会被保存吗?
不会。所有输入只在当前页面内存中参与计算,不上传、不留存,刷新页面即清空。
你可能还想问
这个工具需要联网才能用吗?
第一次打开页面需要联网加载,之后的计算与处理都在本地完成,断网也能继续操作。数据不经过服务器,也不受网络波动影响。
处理结果怎么保存或分享?
结果区支持一键复制,也可按页面提供的下载入口保存到本地;页面不做云端存储,关掉浏览器后需要重新处理。
速查在线工具箱