HMACとは 認証の仕組みと実装

更新済み: 2026年08月31日 読了目安時間: ~

要約

ハッシュベースのメッセージ認証コード(HMAC)は、秘密鍵とハッシュ関数を組み合わせてデータの完全性と信頼性を検証する、二重層の暗号化技術です。送信者は生成されたコードをメッセージに添付し、受信者は同じ共有鍵でそのコードを再計算します。コードが一致する場合、そのメッセージは正規のものです。APIリクエストやWebhookの署名に広く使用されており、開発者は正当なユーザーをブロックしないよう、展開前に徹底的にテストする必要があります。

HMACとは?

ハッシュベースのメッセージ認証コード(HMAC)は、ハッシュ関数と秘密鍵を使用する暗号認証技術です。

HMACを使用すると、署名や非対称暗号を使用する方法とは対照的に、共有シークレットを使用して認証を実現し、データの正確性と信頼性を検証できます。

HMACの仕組みとは?

2者が通信を行う場合、各メッセージが本当に相手から送信されたものであり、途中で改ざんされていないことを確認する必要があります。また、インターネットを信頼しておらず、受信したパケットが改ざんされていないことを検証する方法を必要としています。このようなとき、HMACは有効な解決策となります。

HMACの仕組み:送信者は、メッセージと共有秘密鍵からメッセージ認証コード(MAC)を生成し、両方を送信します。受信者は同じ鍵でMACを再計算します。一致した場合、そのメッセージは真正であり、改ざんされていません。

 

コンポーネントタイプDescription
暗号鍵秘密キー送信者と受信者だけが知っている値。HMACはそれをハッシュに組み込むため、キーを持つユーザーだけが有効なコードを生成または検証できます。
ハッシュ関数アルゴリズムハッシュ関数は、入力を固定長のダイジェストに変換します。HMACは、標準の暗号化ハッシュ関数と連携して動作し、一般的にSHA-256が使用されます。両者が同じものに合意する必要があります。
秘密鍵(アグリーメント)共有シークレット通信を開始する前に、当事者双方が同じ鍵を保有している必要があり、その鍵は秘密にしておかなければなりません。これを持っている人なら誰でも、有効なコードを作成できます。

 

出力はメッセージ認証コード(MAC)と呼ばれる固定長のコードで、メッセージとともに送信されます。HMACはメッセージ自体を隠すものではありません。これにより、メッセージが共有鍵を持つ人物から送信されたこと、そして途中で改ざんされていないことが証明されます。1文字でも変更があれば全く異なるコードが生成されるため、改ざんを容易に検知できます。

HMACテスターツールは、このような機能の仕組みを示すのに役立ちます。以下のような入力を処理する場合を考えてみましょう。

  • 考えられるメッセージ:こんにちは、ご近所さん! 
  • 秘密鍵:123
  • アルゴリズム:SHA-256

結果のメッセージは「 056bc81c5ec3107ce2411f190dfd500b42c48351f6a3ede83601839dcdd0677d」となります。

HMACを数式で表すとどのようになりますか?

簡単な変換プロセスのように見えますが、複雑な数学を基盤としています。 この数学を理解することは、開発者にとって重要です。自分の仕事がどのようなもので、それがどのような保護を提供するかについて説明を求められた場合、言葉で説明するよりも図で示した方が効果的であることが往々にしてあります。

しかし、平均的なコンピューターユーザーの場合、このような数学を理解する必要はないかもしれません。メッセージが保護されていると知ることができれば、おそらくそれで十分でしょう。

HMACはどのように実装しますか?

一個人またはWeb開発者がHMACを使用するには、2つの重要なアイテムが必要となります。 また、これらのアイテムについて受信者との間で合意する必要があるため、同じツールを同時に使用することになります。

これらは必要な2つの項目です。

  1. 共有シークレット
  2. ハッシュツール

すべてのユーザーのすべてのアイテムを知っているのが、自分のサーバーだけであることが重要です。 また、そのデータは厳格に保護されなければなりません。メンバーの秘密鍵を知っている人は、サーバーを乗っ取ったり、不正なデータを送信したりすることができます。 

Webサイトとコーディングの環境はそれぞれ異なりますが、例を使用することで理解しやすくなります。Googleからの動的広告を介してWebサイトにアクセスするトラフィックに対して、HMACを使用するケースを考えてみましょう。 この場合、以下を実行します。

  1. Ad Managerでトークンを構築します。訪問と時刻の詳細を指定します。Googleの認証鍵を使用して「秘密鍵」を作成します。
  2. 実装します。新しいトークンをAuthorizationリクエストヘッダー内に含めるか、あるいはクエリ文字列またはフォームデータパラメーターとして渡すことができます。

Googleは、このプロセスを迅速かつ簡単なものにしています。開発者は、わずか数分で簡単なチュートリアルにアクセスしてコードをコピーできます。

Google広告の訪問者には、コードの暗記やデコードは求められません。ユーザーのサーバーはWebサイト内のコーディング要件を理解し、トークンの設定と変換はユーザーに一切認識されません。

HMACの実装のテストが重要である理由

それでも、この環境をデプロイする前には入念にテストすべきです。コーディングエラーを発見した場合は、サイトへのアクセスをブロックすべきです。放置すると、アクセスが不正行為として識別されることになります。公開する前に、複数のデバイスでシステムをテストすることをお勧めします。

HMACを使うべき状況とは?

ほとんどの企業には機密情報があります。たとえば、何らかの支払いを受けている場合は、クレジットカードのデータがあるでしょう。また、従業員がいれば、社会保障番号の情報が窃取される可能性があります。これらの情報を保護するのにHMACは役立ちます。

HMACのメリットを最も享受できる業界はどれですか?

しかし、さらに深い問題を抱えている企業もあります。医療などの規制が厳しい環境にある場合、または軍需品などの企業秘密を扱う場合は、従来のセキュリティ対策にとどまらない対策を導入する意義が十分にあります。

HMACは、メッセージの送信者とメッセージが改ざんされていないことの両方を検証するもので、自社の資産を可能な限り慎重に保護していることをより確実に証明する必要がある企業にとって理想的です。

HMACを使用するOktaの支援

Oktaは、開発者がAPIやアプリケーションのセキュリティを確保できるよう支援します。Okta API Access ManagementがAPIを呼び出せるユーザーと対象をどのように制御するか、またはOkta WorkflowsでOktaがHMAC署名アルゴリズムを使用する方法をご覧ください。

よくある質問(FAQ)

HMACとは何か、また他の認証方式とどう違うのですか?

HMAC(ハッシュベースのメッセージ認証コード)は、暗号化ハッシュ関数と秘密鍵を組み合わせて、メッセージの信頼性と完全性の両方を検証します。非対称暗号化やデジタル署名に依存するアプローチとは異なり、HMACは共有秘密鍵を使用するため、対称認証技術となります。

HMACが機能するために必要な2つのコンポーネントは何ですか?

HMACでは、両者が共有する秘密鍵と、メッセージと鍵を組み合わせて固定長のコードを生成するSHA-256などの暗号化ハッシュ関数が必要です。

HMACは何を防ぐためのものですか?

HMACは、メッセージの完全性と真正性を保護します。メッセージが改ざんされたり、共有キーを持たない人物から送信されたりした場合、受信者が再計算したコードは一致しません。その強度も、秘密鍵を非公開にし、強力なハッシュ関数を使用することによって決まります。

HMACを使用する前に、両者は何について合意する必要がありますか?

通信を行う両当事者は、事前に2つの事項について合意しておく必要があります:コードの生成と検証に使用される共有秘密鍵。すべてのメッセージの処理に使用される特定のハッシュアルゴリズムです。

HMAC秘密鍵のセキュリティ対策が不適切な場合、どのようなリスクがありますか?

秘密鍵が漏洩すると、攻撃者は有効なコードを生成して本物に見せかけた偽のメッセージを送信したり、メッセージを検知されることなく改ざんしたりする可能性があります。鍵を安全に保管し、アクセスできるユーザーを制限して、定期的にローテーションしてください。

HMACの実装をリリース前にテストすることが重要な理由とは?

HMACの設定が正しくないと、正当なユーザーが不正な行為者として誤ってフラグ付けされ、サイトへのアクセスをブロックされる可能性があります。本番稼働前に複数のデバイスで徹底的なテストを行うことで、こうしたアクセス上の問題を未然に防ぐことができます。

参考文献

HMAC: Keyed-Hashing for Message Authentication(1997年2月、Network Working Group.

HMAC and Key Derivation(Practical Cryptography for Developers)

HMAC Generator/Tester Tool(FreeFormatter)

How API Request Signing Works (And How to Implement HMAC in NodeJS)(2016年、Andrew Hoang)

アイデンティティ施策を推進