HMAC 生成与签名验证器

通过 Web Crypto 在浏览器本地计算并验证符合 RFC 2104 标准的 HMAC-SHA256、SHA-384、SHA-512、SHA-1 及 MD5 签名。

无需上传无需注册即时结果
HMAC-SHA256 · SHA512 · MD5Hex · Base64 · Base64URL100% 本地处理 • 零上传
计算 HMAC
离线引擎就绪浏览器内 100% 隐私安全 • 零云端上传
100% 保护隐私 • 零服务器文件上传

为什么使用 Utiliome 免费的 HMAC 生成与签名验证器?

专为严格隐私保护、即时执行和零门槛体验而构建。无需订阅、无付费墙、无需注册账号。

符合 RFC 2104 与 FIPS 198-1 标准构造

针对 HMAC-SHA256、HMAC-SHA384、HMAC-SHA512、HMAC-SHA1 和 HMAC-MD5 实现标准分块大小的内部(0x36)与外部(0x5c)异或(XOR)密钥填充,并通过 IETF RFC 2202 与 RFC 4231 测试向量验证。

支持 UTF-8、Hex 与 Base64 密钥解码

将签名密钥解析为 UTF-8 文本、原始十六进制字节或符合 RFC 4648 标准的 Base64 字节缓冲区,确保二进制 API 密钥在派生 HMAC 之前被还原为精确的底层密钥字节。

恒定时间(Constant-Time)签名验证模式

使用 Web Crypto 的 crypto.subtle.verify 与定长按位异或(XOR)比较,将传入的 Webhook 或 API MAC 请求头与计算出的签名进行比对,防止泄露前缀计时侧信道信息。

支持 Hex、Base64 与 Base64URL Webhook 输出

在本地浏览器内存中完全离线生成小写/大写 Hex(适用于 GitHub、Stripe、Slack)、标准填充 Base64(适用于 Shopify、AWS)以及无填充 Base64URL(适用于 JWS/JWT 分段)摘要。

Utiliome 与传统云端工具对比

对比我们本地优先的 WebAssembly 引擎与传统云端转换工具。

特性 Utiliome (本地浏览器) 传统云端转换器
符合 RFC 2104 与 FIPS 198-1 标准构造 针对 HMAC-SHA256、HMAC-SHA384、HMAC-SHA512、HMAC-SHA1 和 HMAC-MD5 实现标准分块大小的内部(0x36)与外部(0x5c)异或(XOR)密钥填充,并通过 IETF RFC 2202 与 RFC 4231 测试向量验证。 仅提供基础选项,缺乏高级自定义能力
支持 UTF-8、Hex 与 Base64 密钥解码 将签名密钥解析为 UTF-8 文本、原始十六进制字节或符合 RFC 4648 标准的 Base64 字节缓冲区,确保二进制 API 密钥在派生 HMAC 之前被还原为精确的底层密钥字节。 依赖外部软件或繁琐的手动处理
数据隐私与本地处理 100% 浏览器本地运行(零服务器上传,绝不外泄) 将数据上传至第三方云服务器(存在泄露风险)
使用成本与账号要求 永久 100% 免费 · 无需注册登录 · 无水印 强制要求注册登录或购买付费会员
工作原理

只需 3 步轻松使用 HMAC 生成与签名验证器

无需安装任何软件。一切均在您的网页浏览器中直接运行。

1

提供精确的消息载荷

粘贴未经格式化的原始 HTTP 请求体或规范化签名字符串(严格保留空白字符与键名顺序),或直接拖入抓包获取的载荷文件。

2

配置密钥编码格式与哈希算法

输入共享密钥,选择其字节表示形式(UTF-8 纯文本、Hex 或 Base64),并选择 HMAC-SHA256、HMAC-SHA384、HMAC-SHA512、HMAC-SHA1 或 HMAC-MD5 算法。

3

复制 MAC 摘要或验证传入签名

复制生成的 Hex、Base64 或 Base64URL 摘要,或粘贴预期签名(需去除 sha256= 或 v0= 等传输前缀)以执行恒定时间签名验证。

计算与验证 Webhook 及 API HMAC 签名:实战指南

快速解答: 在 HMAC-SHA256 算法下,使用 4 字节密钥 Jefe(IETF RFC 4231 测试用例 2)对消息 what do ya want for nothing? 进行签名,无论密钥模式选用 UTF-8、Hex(4a656665)还是 Base64(SmVmZQ==),均会生成 Hex 结果 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 以及 Base64 结果 W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM=。

密钥哈希消息认证码(HMAC,Keyed-Hash Message Authentication Code)能够同时证明数据完整性(载荷在传输途中未被篡改)与真实性(发送方持有共享密钥)。要复现服务商的签名,必须精确匹配三个核心参数:底层哈希原语、密钥的原始字节解码方式,以及待签名载荷的精确字节序列。

示例 1:IETF RFC 2104 / RFC 2202 / RFC 4231 测试用例 2

无论您以 UTF-8 文本 Jefe、原始十六进制 4a656665 还是 Base64 SmVmZQ== 的形式输入这个 4 字节密钥,它都会解码为完全相同的字节缓冲区 [0x4a, 0x65, 0x66, 0x65]。对 28 字节的 UTF-8 消息 what do ya want for nothing? 进行签名会得到以下结果:

{
  "keyUtf8": "Jefe",
  "keyHex": "4a656665",
  "keyBase64": "SmVmZQ==",
  "message": "what do ya want for nothing?",
  "signatures": {
    "hmac_md5_hex": "750c783e6ab0b503eaa86e310a5db738",
    "hmac_sha1_hex": "effcdf6ae5eb2fa2d27416d5f184df9c259a7c79",
    "hmac_sha256_hex": "5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843",
    "hmac_sha256_base64": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM=",
    "hmac_sha256_base64url": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM",
    "hmac_sha384_hex": "af45d2e376484031617f78d2b58a6b1b9c7ef464f5a01b47e42ec3736322445e8e2240ca5e69e2c78b3239ecfab21649",
    "hmac_sha512_hex": "164b7a7bfcf819e2e395fbe73b56e0a387bd64222e831fd610270cd7ea2505549758bf75c05a994a6d034f65f8f0e6fdcaeab1a34d4a6b4b636e070a38bce737"
  }
}

示例 2:Base64 与 Base64URL 的差异及 Webhook 规范化载荷

标准 Base64(RFC 4648 第 4 节)会输出 +、/ 及末尾的 = 填充符;而 URL 安全的 Base64URL(RFC 4648 第 5 节,广泛用于 JWS/JWT 签名和签名 URL)则用 - 替代 +,用 _ 替代 /,并去除 = 填充。在 HMAC-SHA256 下使用 UTF-8 密钥 key 对 The quick brown fox jumps over the lazy dog 进行签名,可以直观看到编码差异:

Key (UTF-8):     key
Message (UTF-8): The quick brown fox jumps over the lazy dog

HMAC-SHA256 Hex:       f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
HMAC-SHA256 Base64:    97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg=
HMAC-SHA256 Base64URL: 97yD9DBThCSxMpjmqm-xQ-9NWaFJRhdZl0edvC0aPNg

在验证生产环境的 Webhook 请求头时,请先按照各服务商的规范构造精确的待签名载荷,然后再去除请求头中的前缀进行比对:

GitHub (X-Hub-Signature-256: sha256=<hex>):
  Signed input = <raw_http_body>

Stripe (Stripe-Signature: t=1730419200,v1=<hex>):
  Signed input = 1730419200.<raw_http_body>

Slack (X-Slack-Signature: v0=<hex>):
  Signed input = v0:1730419200:<raw_http_body>

Shopify (X-Shopify-Hmac-Sha256: <base64>):
  Signed input = <raw_http_body>

RFC 2104 构造原理、密钥规范化规则与防时序攻击机制

快速解答: RFC 2104 将 HMAC 定义为 H((K_0 XOR opad) || H((K_0 XOR ipad) || m)),它根据哈希函数的内部压缩分块大小 B(MD5/SHA-1/SHA-256 为 64 字节;SHA-384/SHA-512 为 128 字节)而非摘要输出长度 L 来规范化密钥。

根据 IETF RFC 2104 与 NIST FIPS 198-1 的定义,HMAC 将任意迭代式密码学哈希函数 H 封装在双层嵌套结构中,从而有效防御 Merkle-Damgard 长度扩展攻击(Length-Extension Attack):

HMAC(K, m) = H( (K_0 XOR opad) || H( (K_0 XOR ipad) || m ) )

分块大小(`B`)与输出长度(`L`)及密钥规范化

手写实现 HMAC 代码时,一个常见的错误是按照摘要输出字节长度 L(而非压缩分块字节长度 B)来规范化密钥 K:

  • MD5 (L = 16)、SHA-1 (L = 20)、SHA-256 (L = 32): 内部分块大小 B = 64 字节(512 位)。
  • SHA-384 (L = 48)、SHA-512 (L = 64): 内部分块大小 B = 128 字节(1024 位)。

在与 ipad(0x36 重复 B 次)和 opad(0x5c 重复 B 次)进行异或运算之前,原始密钥字节 K 会被规范化为精确的 B 字节分块 K_0:

  1. 短密钥 (len(K) < B): 在 K 的右侧追加 B - len(K) 个零字节(0x00)。
  2. 分块对齐密钥 (len(K) == B): 直接使用 K,不做修改(K_0 = K)。
  3. 超长密钥 (len(K) > B): 先用 H(K) 对 K 进行一次哈希计算,生成 L 字节的摘要,然后在右侧追加 B - L 个零字节(0x00)以补齐至 B 字节。

根据 RFC 2104 第 3 节建议,密钥应至少包含 L 字节的密码学熵(HMAC-SHA256 至少需要 32 个 CSPRNG 随机字节,HMAC-SHA512 至少需要 64 个 CSPRNG 随机字节)。长度小于 L 的密钥会使抵抗暴力破解的有效安全性降低到哈希函数的生日界限以下。

密钥编码陷阱与恒定时间验证

  • 十六进制字符串 vs 原始十六进制字节: 如果某个 API 下发了 64 个字符的十六进制密钥(例如 4a656665...),请确认其官方 SDK 在调用 importKey 之前,是将该字符串直接当作 64 个 ASCII UTF-8 字节(0x34 0x61...)处理,还是先将其 Hex 解码为 32 个原始字节(0x4a 0x65...)。在联调排查时,只需在 UTF-8、Hex 和 Base64 之间切换密钥编码选项,即可快速定位因密钥解码方式不一致导致的签名失败。
  • 恒定时间验证(Constant-Time Verification): 切勿在服务端代码中使用普通的字符串相等运算符(如 computedHex === headerHex)来校验不受信任的 MAC。标准字符串比较会在遇到第一个不匹配的字节时立即返回 false,这会产生纳秒级的计时预言机(Timing Oracle),使远程攻击者能够逐字节暴力破解出合法的 MAC(仅需 256 * L 次尝试,而非 2^(8*L) 次)。本工具在浏览器端通过 crypto.subtle.verify('HMAC', cryptoKey, signatureBuffer, messageBuffer)(或对解码后的字节数组执行定长按位异或累加)完成校验,其安全机制与 Node.js 的 crypto.timingSafeEqual 及 Python 的 hmac.compare_digest 完全一致。

HMAC 生成器 vs 加密哈希生成器 vs JWT 生成器:该如何选择?

快速解答: 当需要使用共享密钥对原始载荷(HTTP 请求体、规范化字符串、Webhook 事件)进行签名或验签时,请使用 HMAC 生成器;当需要计算无密钥的字符串或文件摘要时,请使用加密哈希生成器;当需要构建采用 HS256、HS384 或 HS512 签名的结构化 RFC 7519 JSON Web Token 时,请使用 JWT 生成器。

虽然无密钥哈希摘要、原始 HMAC 和对称签名的 JSON Web Token 底层都共享 SHA-2 密码学原语,但它们分别解决不同协议层的安全需求:

功能特性 HMAC 生成与签名验证器(本工具) 加密哈希生成器 JWT 生成器
密码学原语 密钥消息认证码 (RFC 2104 / FIPS 198-1) 无密钥消息摘要 (FIPS 180-4 / RFC 1321) JWS / JWT 令牌封装 (RFC 7515 / RFC 7519)
是否需要密钥 是(UTF-8、Hex 或 Base64 共享密钥) 否 是(对称密钥或 RSA/ECDSA 非对称密钥对)
安全保障 身份真实性 + 数据完整性 仅校验意外损坏 / 公开数据完整性 经过认证的结构化声明 (iss、sub、exp)
支持的算法 HMAC-SHA256、SHA384、SHA512、SHA1、MD5 MD5、SHA-1、SHA-256、SHA-384、SHA-512 HS256、HS384、HS512(及非对称 JWS 算法套件)
输出格式 Hex、Base64、Base64URL 小写/大写 Hex、Base64 <header>.<payload>.<signature> (Base64URL)

选择合适的开发工具

  • 调试无密钥文件摘要、W3C SRI 子资源完整性哈希,或 ETag / 缓存键? 此类场景不涉及密钥,请使用加密哈希生成器。
  • 构建或检查 Bearer 认证令牌(HS256、HS384、HS512)? 根据 RFC 7515 规范,HS256 JWT 的签名段严格等于 HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))) 的无填充 Base64URL 输出。虽然您也可以在本工具中将 <base64url_header>.<base64url_payload> 粘贴为消息并选择 Base64URL 输出来直接验证 JWT 的第三段签名,但如果您需要编辑 JSON 头部、校验 exp/nbf 时间戳并组装完整的三段式令牌,请使用 JWT 生成器。
  • 对称 HMAC vs 非对称签名: 由于 HMAC 是对称算法,任何能够验证签名的服务都同时持有能够伪造新签名的完整密钥。建议将 HMAC 用于点对点 Webhook 和受信任的内部微服务;当需要让不受信任的第三方在不具备签名权限的前提下验证令牌时,请在 JWT 生成器中使用非对称密钥算法(RS256、ES256、EdDSA)。
常见问题

HMAC 生成与签名验证器 常见问题解答与技术指南

了解使用 Utiliome 免费在线 在线 hmac 生成器 的一切须知。

为什么密钥和 JSON 字段看起来完全一致,我的 Webhook HMAC 签名验证还是失败?

超过 90% 的 Webhook HMAC 校验失败都源于以下两个原因。第一,诸如 Express 的 express.json() 等中间件会解析并重新序列化 JSON,从而改变了发送方签名时原始 TCP 字节流中的空白字符、Unicode 转义或键名顺序——因此请务必对未经解析的原始请求缓冲区(Raw Body)进行签名,并按服务商要求拼接时间戳前缀(例如 Stripe 的 <timestamp>.<body> 或 Slack 的 v0:<timestamp>:<body>)。第二,请检查服务商提供的密钥是否需要先从 Base64 或 Hex 解码为原始字节,而不是直接作为 UTF-8 字符串读取。

与符合 RFC 2104 的 HMAC-SHA256 相比,为什么直接拼接计算 SHA256(secret + message) 是不安全的?

MD5、SHA-1、SHA-256 和 SHA-512 均采用 Merkle-Damgard 构造,其最终输出的摘要会暴露完整的内部压缩状态。一旦获知 SHA256(secret || message) 的结果以及 secret 的字节长度,攻击者无需知道 secret 本身即可推算出 SHA256(secret || message || padding || attacker_suffix)(即长度扩展攻击)。RFC 2104 HMAC 通过将内部哈希摘要输入到第二层带密钥的外部哈希 H((K_0 XOR opad) || inner_hash) 中,彻底消除了这一漏洞。

如果我的 HMAC 密钥长度超过 64 或 128 字节会发生什么?

根据 RFC 2104 第 2 节规定,如果密钥长度严格超过哈希函数的内部分块大小 B(对于 MD5、SHA-1 和 SHA-256 为 len(K) > 64 字节;对于 SHA-384 和 SHA-512 为 len(K) > 128 字节),算法会先使用 H(K) 对密钥进行一次哈希运算,将其压缩为 L 字节,然后再在右侧用 0x00 字节填充至 B 字节。浏览器原生的 Web Crypto(crypto.subtle.importKey)以及所有符合 RFC 标准的服务端密码学库都会自动完成这一预哈希步骤。

针对 GitHub、Stripe、Slack、Shopify 和 JWT HS256,我应该分别选择哪种输出编码?

GitHub(X-Hub-Signature-256)、Stripe(Stripe-Signature 中的 v1)以及 Slack(X-Slack-Signature 中的 v0)均在各自的 sha256=、v1= 或 v0= 前缀之后传输小写 Hex 格式的 HMAC-SHA256 摘要。Shopify(X-Shopify-Hmac-Sha256)和 AWS Signature v1/v2 使用标准带填充的 Base64。而 JSON Web Token(HS256、HS384、HS512)则根据 RFC 7515 要求使用无填充的 Base64URL——如需组装完整令牌,请参阅 JWT 生成器。

MD5 和 SHA-1 的碰撞攻击是否已经攻破了 HMAC-MD5 和 HMAC-SHA1?

并未直接攻破。针对无密钥 MD5 和 SHA-1 的碰撞攻击依赖于攻击者能够针对公开的固定初始向量(IV)自由选择消息分块;而 HMAC 通过保密的 K_0 XOR ipad 与 K_0 XOR opad 步骤隐藏了内部 IV 状态(详见 IETF RFC 6151)。尽管如此,NIST SP 800-131A 以及各大 Webhook 服务商(例如 GitHub 已弃用基于 SHA-1 的 X-Hub-Signature)均已在新系统中淘汰 HMAC-MD5 和旧版 HMAC-SHA1——除非为了兼容遗留协议,否则请一律优先选择 HMAC-SHA256 或 HMAC-SHA512。