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 請求主體(Request Body)或正規化簽章字串(嚴格保留空白字元與鍵值順序),或直接拖入擷取的載荷檔案。

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 次)進行互斥或(XOR)運算之前,原始金鑰位元組 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() 等中介軟體(Middleware)會解析並重新序列化 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。