HMAC 生成ツール（Base64）

HMAC を Base64 で計算する方法

1. HMAC モードと SHA-256 が選択されています。API が SHA-1、SHA-384、SHA-512、MD5 を使うなら、アルゴリズム で別のものを選びます。
2. 秘密鍵 を入力し、鍵の形式 を設定します。普通のシークレット文字列ならテキスト（UTF-8）、鍵がエンコードされたバイト列として渡されているなら16進数か Base64 です。
3. テキスト にメッセージを入力するか貼り付けます。または 入力 を ファイル に切り替えて、ペイロードのファイルそのものをドロップします。
4. 署名を Base64、Base64URL、16進数のいずれかでコピーします。すべてのアルゴリズム では、すべてのハッシュでの HMAC を一度に表示します。どれが使われているかドキュメントの記述があいまいなときに役立ちます。

空の鍵も受け付けて結果を出しますが、そのような HMAC は何も保護しないという注意が表示されます。

値の例

鍵 key とメッセージ The quick brown fox jumps over the lazy dog の場合：

HMAC-SHA256 の値を16進数で書くと f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8 で、Wikipedia の HMAC の記事でおなじみのテストベクターです。鍵のエンコードによって結果が変わります。テキスト a2V5 を鍵にすると 5O+7AtpguFrgIRw1qXGU+m0OaTs1oV1kwRQ/hI1WAUE= になりますが、a2V5 を Base64 として読むと key のバイト列になり、再び 97yD9DBT… になります。

Webhook の署名：Base64 か16進数か

プロバイダーは HMAC を使う点では一致していますが、出力のエンコードや署名の対象はまちまちです。ドキュメントが充実している例をいくつか挙げます。

このツールの値が16進数では一致するのにコードでは Base64 で比較している、あるいはその逆の場合、計算は正しく、エンコードが違うだけです。何が署名されるかはプロバイダーのドキュメントで確認してください。タイムスタンプの接頭辞は、古いリクエストのリプレイを防ぐためにあります。

コードで署名を検証する

生のバイト列を定数時間で比較し、本文は受け取ったとおりにハッシュしてください。

const crypto = require("crypto");

function verifyWebhook(rawBody, secret, signatureHeader) {
  const expected = crypto.createHmac("sha256", secret).update(rawBody).digest();
  const given = Buffer.from(signatureHeader, "base64");
  return given.length === expected.length && crypto.timingSafeEqual(given, expected);
}

rawBody を fox の文の Buffer、秘密鍵を key、署名を上の表の Base64 値にすると true を返します。生の本文の代わりに JSON.stringify(JSON.parse(body)) を渡すと、プロバイダーの JSON に、シリアライザーが落とす空白が 1 つでもあれば false になります。Express なら、Webhook のルートでは express.raw() で本文を読むということです。

Python で同じことをするには、hmac.new(key, body, hashlib.sha256).digest() を Base64 エンコードし、hmac.compare_digest で比較します。コマンドラインでは openssl dgst -sha256 -hmac 'key' -binary | base64 で同じ Base64 が得られます。鍵が16進数なら -mac HMAC -macopt hexkey:… を使ってください。強い鍵には、Base64 鍵生成ツール の HMAC シークレットのプリセットで 32 バイトのランダムな鍵を作れます。リクエストではなくトークンに署名するなら、JWT エンコーダー をご覧ください。

よくある質問