HMAC生成ツール

使い方

1. メッセージにデータを入力します。バイナリのデータは、メッセージの形式で16進数かBase64を選んでください。
2. 秘密の鍵を鍵に入力し、鍵の形式で書き方を選びます。
3. HMACの値の4行を読みます。必要な値をコピーするか、使っているシステムの値と比べてください。
4. 他のシステムと値が違う場合は、まずバイト列を確かめてください。改行コードや文字コードが違うと、HMACも変わります。

HMACとは

HMAC（RFC 2104）は、メッセージ認証コードです。秘密の鍵を知っている人だけが作れる短い値です。通常のハッシュ関数Hを、メッセージと鍵に対して2回使って作ります。そのため、同じハッシュ関数を表の4行で使えます。鍵が必要なので、HMACが一致すれば、メッセージが変更されておらず、鍵を持つ人から来たことが示せます。

HMACはメッセージを隠しません。メッセージを持つ人なら誰でも読めます。HMACは、そのメッセージが正しいかを確かめさせるだけです。

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

ipad = 0x36のバイトをB回繰り返したもの
opad = 0x5CのバイトをB回繰り返したもの
B    = Hのブロック長：SHA-1とSHA-256は64バイト、SHA-384とSHA-512は128バイト

使うハッシュ関数と鍵

HMAC-SHA-256が一般的な選択で、多くのWebhookやAPIが使っています。HMAC-SHA-512は同じ仕組みで出力が長いものです。HMAC-SHA-1は古いシステムには残っていますが、新しい設計では選びません。

鍵はランダムで、少なくともハッシュの出力と同じ長さが望ましいです。単語や短い文を鍵にすると推測されやすく、推測された鍵のHMACには価値がなくなります。

16進数とBase64

どちらの形式も同じバイト列を表します。16進数は1バイトを2桁で書くため、SHA-256は64桁になります。Base64は3バイトを4文字で書くため、SHA-256は44文字になり、その最後は詰め物の=です（RFC 4648）。

• HMAC-SHA-1：16進数40桁、Base64 28文字
• HMAC-SHA-256：16進数64桁、Base64 44文字
• HMAC-SHA-384：16進数96桁、Base64 64文字
• HMAC-SHA-512：16進数128桁、Base64 88文字

よくある質問