如何線上驗證數位簽章

為什麼重要

廠商 webhook 開始驗簽失敗，原因幾乎永遠是：金鑰錯、演算法錯、canonical 化錯、編碼錯。不必在驗證器里到處插 console.log，可把訊息與簽章貼進已知良好的驗證器比對結果——立刻知道是程式還是訊息本身有問題。

三個實際場景

操作說明

開啟 簽章驗證器。

1. 1

   貼上訊息

   被簽署的精確位元組。JWT 即 header.payload；AWS Sig V4 即 canonical string-to-sign。

2. 2

   貼上簽章

   Hex 或 Base64——依來源選。工具會嘗試常見格式自動判斷。

3. 3

   提供金鑰

   對稱：貼密鑰字串（或 Base64／hex）。非對稱：貼 PEM 格式公鑰。

4. 4

   選演算法

   HS256／HS384／HS512（HMAC）、RS256／RS512（RSA-PKCS1）、PS256（RSA-PSS）、ES256／ES384（ECDSA）。JWT 的 alg 名稱對應相同。

5. 5

   讀結果

   「有效」或「無效」，無效時一行理由（演算法不符、金鑰解析錯、簽章長度錯等）。

Message:    eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzEifQ
Signature:  L6S8LWkLzpcREMa8gxaaZbWwLNk0LgcBh6dRQpfIBrI
Key:        MyVeryLongSharedSecretValue1234567890
Algorithm:  HS256

Valid signature.

實用技巧

• 務必用廠商公布的參考向量測試。 多數提供已知良好的訊息＋簽章對，可確認工具對其演算法處理正確。
• JWT 請複製 header 確認 alg 與驗證器預期一致。 忽略未簽名 token（alg=none）——那是攻擊面。
• 新 RSA 設計優先 PSS。 PKCS#1 v1.5（RS256）仍可接受，密碼學社群較偏 RSASSA-PSS（PS256）。
• 盯緊 canonical 字串。 少一個 \n、標頭名小寫差異都會翻簽。與已知良好的封包 diff 找出差異。

常見陷阱

何時不適合用這套

• 簽發憑證屬 OpenSSL 或你的 CA。
• 驗證 TLS 伺服器憑證是瀏覽器工作；鏈驗證邏輯遠比單一簽章檢查複雜。
• 平台二進位簽章（Windows Authenticode、Apple Developer ID）需平台專用工具。

FAQ

下一步

1. 要自行計算 HMAC 可開 HMAC 產生器。
2. 若協定先對 body 雜湊再簽，可用 雜湊產生器。
3. 貼進驗證器前可用 編碼／解碼工具 解 JWT 各段。