关于此工具
基于哈希的消息认证码(HMAC,Hash-based Message Authentication Code,RFC 2104)是现代计算机安全中用于验证数据“完整性(Integrity)”与“真实性(Authenticity)”的行业密码学基石。与普通单向哈希(如纯 MD5/SHA256)不同,HMAC 将明文数据与只有通信双方知晓的“共享秘密密钥(Secret Key)”深度混合散列。任何第三方即便能够截获并篡改报文内容,但因缺乏私钥,绝无法计算出吻合的合法签名。本工具提供纯前端本地 HMAC 计算,支持 SHA-256、SHA-512、MD5 等全算法与多种输出编码。
如何使用本工具(操作步骤)
输入待签名原始报文与密钥
在上方输入框粘贴需要签名的明文请求体或 URL 参数串,并在密钥栏填入通信双方约定的共享私钥(Secret Key)。
挑选底层密码学哈希算法
选择目标散列算法(最常用标配为 SHA-256,高安全金融级可选 SHA-512,旧系统排查兼容可选 SHA-1 或 MD5)。
获取签名摘要并一键复制
系统利用浏览器底层硬件加速即刻生成签名散列值,支持十六进制 Hex(小写/大写)及 Base64 格式并一键复制使用。
覆盖主流开放平台与 Webhook 签名规范
生成的签名格式 100% 契合 GitHub Webhook、Stripe 支付回调、AWS Signature Version 4 以及微信支付接口鉴权标准。
支持 Hex 十六进制与 Base64 双格式输出
灵活切换常见的 64 位十六进制小写字符串或标准 Base64 编码字符串,满足不同网络框架对签名报头的特定要求。
纯本地离线计算,API 密钥绝无外泄
所有 HMAC 计算均在浏览器本地 Web Crypto API 沙箱中运行,机密 API Secret 绝无发送至任何外网云端服务器的隐患。
API 接口防重放与防时序攻击安全指南
- •必须在签名中包含时间戳防范重放攻击(Replay Attacks):如果黑客截获了合法请求报文与正确的 HMAC 签名,他可以直接原样重复发送该请求。防范标准做法是在报文中包含当前时间戳 `timestamp`,服务端校验其时间偏差不得超过 5 分钟。
- •校验签名必须使用恒定时间比较(Constant-Time Compare):在代码中切忌使用普通的 `if (userSig === realSig)` 进行字符串比较!因为普通字符串比较遇到第一个不匹配字符就会提前返回,黑客可以通过微秒级的响应耗时差异(时序攻击 Timing Attack)逐字节猜解出签名。在 Node.js 中必须使用 `crypto.timingSafeEqual()`。
- •参数排序归一化(Canonicalization):在对 URL 查询参数进行 HMAC 签名时,前后端必须约定统一的排序规则(通常按 ASCII 字典序升序排列后拼接),避免由于参数顺序微小差异导致签名不匹配失败。
代码与转换对比示例
同一报文在固定密钥下的不同 HMAC 算法输出对照
• 待签名报文 (Data) : "order_id=20260923&amount=99.00"
• 共享密钥 (Secret) : "my_super_secret_key_123"• HMAC-MD5 (Hex 32位): d3b07384d113edec49eaa6238ad5ff00
• HMAC-SHA1 (Hex 40位): 8f14e45fceea167a5a36dedd4bea2543
• HMAC-SHA256 (Hex 64位): 4f53cda18c2baa0c0354bb5f9a3ecbe5ed12...* 报文或密钥发生即使 1 个字符的变动,算出的 HMAC 签名会发生彻底的雪崩式突变。
现代编程语言生成 HMAC-SHA256 签名核心代码
const crypto = require('crypto');
const hmac = crypto.createHmac('sha256', 'secret_key');
hmac.update('message_payload');
console.log(hmac.digest('hex'));import hmac, hashlib
sig = hmac.new(b'secret_key', b'message_payload', hashlib.sha256).hexdigest()
print(sig)* 生产环境校验签名时,务必使用恒定时间比较函数(如 `timingSafeEqual`)以防范时序攻击。
常见问题解答
Q: 为什么说普通哈希拼接 `hash(key + message)` 是不安全的?
A: 因为针对 MD5、SHA-1、SHA-256 这类基于 Merkle-Damgård 结构的哈希函数,存在著名的“长度扩展攻击(Length Extension Attack)”。黑客在不知道密钥的情况下,可以直接在原报文后追加恶意数据并算出合法的散列值!而 HMAC 算法通过嵌套双重哈希结构在数学上彻底粉碎了该漏洞。
Q: HMAC 和数字签名(如 RSA/ECDSA 签名)有什么区别?
A: HMAC 是“对称机制”,通信双方拥有同一个共享密钥,计算性能极高(速度比非对称签名快上百倍);而 RSA/ECDSA 是“非对称机制”,发信方持有私钥签名,收信方持有公钥验签,适用于互不信任的公网跨企业开放鉴权场景。
Q: HMAC 密钥的长度应该多长才算安全?
A: 根据 RFC 2104 建议,HMAC 密钥的长度最好不要短于底层哈希函数的输出长度。例如对于 HMAC-SHA256,推荐密钥长度至少为 32 字节(256 比特,如 32 个随机字符),过短的弱密钥容易遭受字典爆破攻击。