<p><!--META { "title": "RFC 7519: JWT (JSON Web Token) の仕組みとプロトコル実装上の注意点", "primary_category": "ネットワークプロトコル", "secondary_categories": ["セキュリティ","認証・認可"], "tags": ["JWT","JSON Web Token","RFC 7519","JWS","JWE","OAuth 2.0"], "summary": "RFC 7519に定義されるJWTの仕組み、設計目標、詳細、セキュリティ考慮、実装上の注意点をネットワークエンジニアの視点から解説。", "mermaid": true, "verify_level": "L0", "tweet_hint": {"text":"RFC 7519 JWT (JSON Web Token) の仕組み、設計目標、詳細、セキュリティ、実装上の注意点をネットワークエンジニアの視点から解説。OAuth 2.0などの認証フローで不可欠な技術を深掘り。 #JWT #RFC7519 #ネットワークプロトコル","hashtags":["#JWT","#RFC7519","#ネットワークプロトコル"]}, "link_hints": ["https://datatracker.ietf.org/doc/html/rfc7519"] } --> 本記事は<strong>Geminiの出力をプロンプト工学で整理した業務ドラフト（未検証）</strong>です。</p> <h1 class="wp-block-heading">RFC 7519: JWT (JSON Web Token) の仕組みとプロトコル実装上の注意点</h1> <h2 class="wp-block-heading">背景</h2> <p>現代のウェブアプリケーションやAPIエコシステムでは、ステートレスな認証・認可が求められることが多くなっています。特に、マイクロサービスアーキテクチャ、シングルページアプリケーション（SPA）、モバイルアプリケーションでは、異なるサービス間でユーザーのアイデンティティや権限情報を安全かつ効率的に伝達するメカニズムが必要です。従来のセッションベースの認証では、セッション情報のサーバーサイド管理が必須となり、水平スケーリングやクロスドメインでの利用に課題がありました。</p> <h2 class="wp-block-heading">設計目標</h2> <p>RFC 7519「JSON Web Token (JWT)」は、これらの課題を解決するために以下の設計目標を持って考案されました。</p> <ul class="wp-block-list"> <li><p><strong>コンパクトさ</strong>: URL-safeな形式で、HTTPヘッダやクエリパラメータ、POSTパラメータとして簡単に送信できるサイズ。</p></li> <li><p><strong>自己完結性</strong>: トークン自体にユーザー情報や権限情報が含まれており、リソースサーバーが別途データベースを参照することなく、トークンの検証と認可判断が可能。</p></li> <li><p><strong>安全性</strong>: 署名または暗号化によって、トークンの完全性（Integrity）と機密性（Confidentiality）が保証される。これにより、トークンが改ざんされていないこと、および不正な傍受からの保護が実現される。</p></li> <li><p><strong>相互運用性</strong>: JSONベースの構造とBase64Urlエンコーディングを採用することで、異なるプログラミング言語やプラットフォーム間での容易な実装と利用が可能。</p></li> <li><p><strong>ステートレス性</strong>: サーバーサイドでセッション状態を保持する必要がなく、水平スケーリングを容易にする。</p></li> </ul> <h2 class="wp-block-heading">詳細</h2> <p>JWTは、JSON形式の情報を安全に表現するためのコンパクトなURI-safeな手段を提供します。JWTには主にJWS (JSON Web Signature) とJWE (JSON Web Encryption) の2つの形式があります。これらの詳細については、それぞれRFC 7515 (JWS) および RFC 7516 (JWE) で定義されています。</p> <h3 class="wp-block-heading">JWS (JSON Web Signature)</h3> <p>JWSは、デジタル署名またはMAC（Message Authentication Code）によってJWTの完全性を保証します。構造は以下の3つのコンポーネントをBase64Urlエンコードし、ドット <code>.</code> で連結したものです。</p> <pre data-enlighter-language="generic">BASE64URL(JWS Header) . BASE64URL(JWS Payload) . BASE64URL(JWS Signature) </pre> <p><strong>JWS Header 構造</strong>: JWS Headerは、トークンの署名アルゴリズムや鍵の種類などを記述するJSONオブジェクトです。</p> <div class="codehilite"> <pre data-enlighter-language="generic">alg:string (Algorithm) - 署名アルゴリズム (例: HS256, RS256)。RFC 7518で定義。 typ:string (Type) - トークンのタイプ (通常は "JWT")。 kid:string (Key ID, optional) - 鍵を識別するためのID。RFC 7517で定義されたJWKと関連。 </pre> </div> <p><strong>JWS Payload (Claims) 構造</strong>: JWS Payloadは、トークンが運ぶ情報を記述するJSONオブジェクトです。これらは「Claims」（クレーム）と呼ばれ、Registered Claims, Public Claims, Private Claimsの3種類があります。</p> <div class="codehilite"> <pre data-enlighter-language="generic">iss:string (Issuer, optional) - 発行者 (例: "auth.example.com")。RFC 7519で定義。 sub:string (Subject, optional) - 主題 (ユーザーIDなど)。RFC 7519で定義。 aud:string (Audience, optional) - 受信者 (APIサービスなど)。RFC 7519で定義。 exp:number (Expiration Time) - 有効期限 (Unix時間)。RFC 7519で定義。 nbf:number (Not Before, optional) - 有効開始時刻 (Unix時間)。RFC 7519で定義。 iat:number (Issued At, optional) - 発行時刻 (Unix時間)。RFC 7519で定義。 jti:string (JWT ID, optional) - 一意のJWT識別子 (リプレイ攻撃対策に利用)。RFC 7519で定義。 custom_claim:any (Private Claims) - 任意のカスタム情報。 </pre> </div> <p><strong>JWS Signature 構造</strong>: HeaderとPayloadをBase64Urlエンコードし、ドットで連結した文字列 (<code>BASE64URL(JWS Header) . BASE64URL(JWS Payload)</code>) を指定されたアルゴリズムと鍵で署名した結果です。</p> <h3 class="wp-block-heading">JWE (JSON Web Encryption)</h3> <p>JWEは、JWTの機密性を保証するために、トークン全体を暗号化します。構造は以下の5つのコンポーネントをBase64Urlエンコードし、ドット <code>.</code> で連結したものです。</p> <pre data-enlighter-language="generic">BASE64URL(JWE Header) . BASE64URL(JWE Encrypted Key) . BASE64URL(JWE IV) . BASE64URL(JWE Ciphertext) . BASE64URL(JWE Authentication Tag) </pre> <p>JWE Headerは暗号化アルゴリズムや鍵の管理方法などを指定し、Encrypted Keyは対称鍵暗号に使用する鍵を非対称鍵で暗号化したもの、IVは初期化ベクトル、Ciphertextは暗号化されたデータ、Authentication Tagは認証タグです。これにより、改ざん検出と機密保護が両立されます。</p> <h3 class="wp-block-heading">JWTの利用シーケンス</h3> <p>一般的なJWTの利用シーケンスは以下のようになります。</p> <div class="wp-block-merpress-mermaidjs diagram-source-mermaid"><pre class="mermaid"> sequenceDiagram participant C as クライアント participant "AS as 認証サーバー (Auth Server)" participant "RS as リソースサーバー (Resource Server)" C ->> AS: 1. 認証リクエスト |ユーザー名/パスワード| AS -->> C: 2. 認証成功 & JWT発行 Note right of AS: JWSを生成し、デジタル署名<br/>(またはJWEで暗号化) C ->> RS: 3. リソースリクエスト |AuthorizationヘッダにJWTを添付| Note right of C: Authorization: Bearer <JWT> RS ->> RS: 4. JWTの検証 |署名検証, 有効期限チェックなど| Note right of RS: ASの公開鍵で署名検証、クレーム検証 alt 検証成功 RS -->> C: 5. リソース提供 else 検証失敗 RS -->> C: 5. エラー応答 |例: 401 Unauthorized| end </pre></div> <h2 class="wp-block-heading">相互運用</h2> <p>JWTは、RFC 7519として標準化されており、関連するRFC 7515 (JWS), RFC 7516 (JWE), RFC 7517 (JWK), RFC 7518 (JWA) とともにエコシステムを形成しています。</p> <ul class="wp-block-list"> <li><p><strong>OAuth 2.0 (RFC 6749)</strong>: 認可フレームワークとしてOAuth 2.0が広く利用されていますが、そのアクセストークンやIDトークンの形式としてJWTが推奨されています。特にOpenID Connect (OIDC) Core 1.0ではIDトークンとしてJWTが必須です。</p></li> <li><p><strong>SAML (Security Assertion Markup Language)</strong>: XMLベースの認証・認可プロトコルであるSAMLと比較して、JWTはJSONベースであるため、よりコンパクトでウェブ環境との親和性が高いです。SAMLはXML署名やXML暗号化を使用するため、処理が重くなる傾向があります。</p></li> <li><p><strong>セッションクッキー</strong>: サーバーサイドで状態を管理するセッションクッキーと比較して、JWTは自己完結型であり、サーバーが状態を持つ必要がないため、マイクロサービスやCDN利用時のスケーラビリティに優れます。ただし、セッションを強制的に無効化するログアウトなどの機能の実装がより複雑になります。</p></li> </ul> <h2 class="wp-block-heading">セキュリティ考慮</h2> <p>JWTの利用には以下のセキュリティ考慮事項が不可欠です。</p> <ul class="wp-block-list"> <li><p><strong>リプレイ攻撃 (Replay Attacks)</strong>: JWSは認証情報を含むため、傍受されたトークンが再利用されるリスクがあります。これを防ぐためには、<code>exp</code> (Expiration Time) クレームによる有効期限の厳格なチェック、<code>jti</code> (JWT ID) クレームとサーバー側での使用済みトークンリスト（Allow/Deny List）の管理、またはOne-Time Nonceの利用が有効です。</p></li> <li><p><strong>署名アルゴリズムのダウングレード攻撃 (Algorithm Downgrade Attacks)</strong>: JWS Headerの<code>alg</code>パラメータを攻撃者が変更し、より脆弱なアルゴリズムや署名検証をスキップさせる（例: <code>alg: "none"</code>) アルゴリズムの使用を強制する試みです。実装は、信頼できるアルゴリズムのホワイトリストを保持し、受信したJWTの<code>alg</code>クレームがそのホワイトリストに含まれているかを確認する必要があります。特に、<code>"none"</code>アルゴリズムの使用は明示的に拒否するべきです。</p></li> <li><p><strong>鍵更新と鍵管理 (Key Rotation and Management)</strong>: 署名鍵や暗号化鍵は定期的に更新（ローテーション）されるべきです。JWK Set (JSON Web Key Set, RFC 7517) を利用することで、公開鍵の配布と管理を効率的に行えます。鍵の漏洩が発生した場合に備え、迅速な鍵無効化と再発行のプロセスが必要です。</p></li> <li><p><strong>0-RTTの再送リスク (0-RTT Replay Risk)</strong>: TLS 1.3 (RFC 8446) の0-RTTモードでJWTを含むリクエストを送信する際、リクエストが再送されるリスクがあります。0-RTTで送信されるデータは、暗号化されていてもリプレイ攻撃に対して脆弱であるため、冪等ではない操作（ユーザーのパスワード変更など）にJWTを使用する場合は、注意が必要です。0-RTTを許可しない、またはリプレイが許容される操作に限定するといった対策が必要です。</p></li> <li><p><strong>情報漏洩</strong>: JWSのPayloadはBase64Urlエンコードされるだけであり、暗号化はされません。機密情報を含める場合は、JWEを使用して暗号化する必要があります。</p></li> </ul> <h2 class="wp-block-heading">実装メモ</h2> <p>ネットワークエンジニアとしてJWTを実装または運用する際に考慮すべき点を挙げます。</p> <ul class="wp-block-list"> <li><p><strong>MTU/Path MTU (Maximum Transmission Unit / Path MTU Discovery)</strong>: JWTはHTTPヘッダの<code>Authorization</code>フィールドなどに挿入されて送信されます。JWTのサイズが大きすぎると、HTTPリクエストのヘッダサイズが増加し、基盤となるTCP/IPパケットがMTUを超える可能性があります。これにより、IPフラグメント化が発生し、ネットワーク機器の負荷増大やパケットロスのリスクが高まります。Path MTU Discovery (PMTUD) が適切に動作しない環境では、通信障害の原因となることもあります。JWTのペイロードは必要最小限に抑え、大規模なデータを運ぶ際にはJWTではなく、参照渡し（JWTにはIDのみを含み、実際のデータは別途APIで取得）を検討すべきです。</p></li> <li><p><strong>HTTP/2 (RFC 7540) とヘッダ圧縮</strong>: HTTP/2ではHPACK (RFC 7541) によるヘッダ圧縮が行われますが、頻繁に変わるJWTは圧縮効率が低下する可能性があります。HTTP/3 (RFC 9114) ではQPACKによる圧縮が導入されており、この点も考慮されます。特に、多数のカスタムクレームを含む大きなJWTは、継続的に送信されるとネットワーク帯域を消費し、効率を低下させる可能性があります。</p></li> <li><p><strong>HOL blocking回避とキュー制御</strong>: JWT自体が直接HOL (Head-of-Line) blockingを引き起こすわけではありませんが、JWTの検証処理が遅延すると、アプリケーション層でリクエスト処理のボトルネックとなる可能性があります。リソースサーバーはJWTの検証を高速に行うためのキャッシュメカニズム（公開鍵のキャッシュなど）や、適切な非同期処理・キューイングにより、リクエストの並列処理とスループットの維持を図るべきです。</p></li> <li><p><strong>優先度</strong>: 認証・認可に関わるJWTの検証は、セキュリティ上、そしてアプリケーションの機能遂行上、非常に高い優先度で処理されるべきです。システムの設計において、JWT検証コンポーネントが十分なリソース（CPU、メモリ）と優先度を持つように考慮する必要があります。</p></li> </ul> <h2 class="wp-block-heading">まとめ</h2> <p>RFC 7519によって定義されるJWTは、ステートレスな認証・認可の要件を満たす強力なメカニズムです。そのコンパクトさ、自己完結性、安全性、相互運用性から、現代の分散システムやウェブアプリケーションにおいて広く採用されています。しかし、その実装と運用には、リプレイ攻撃、アルゴリズムダウングレード、鍵管理、0-RTTのセキュリティリスクといった固有の注意点が存在します。</p> <p>ネットワークエンジニアとしては、JWTのサイズがネットワークパフォーマンスに与える影響（MTU、ヘッダ圧縮）、そしてJWT検証の遅延がアプリケーションのスループットに与える影響を理解し、適切な設計と最適化を行うことが重要です。セキュリティとパフォーマンスの両面から、JWTの特性を深く理解し、堅牢なシステム構築に貢献していく必要があります。</p>

BASE64URL(JWS Header) . BASE64URL(JWS Payload) . BASE64URL(JWS Signature)

alg:string (Algorithm)        - 署名アルゴリズム (例: HS256, RS256)。RFC 7518で定義。
typ:string (Type)             - トークンのタイプ (通常は "JWT")。
kid:string (Key ID, optional) - 鍵を識別するためのID。RFC 7517で定義されたJWKと関連。

iss:string (Issuer, optional)     - 発行者 (例: "auth.example.com")。RFC 7519で定義。
sub:string (Subject, optional)    - 主題 (ユーザーIDなど)。RFC 7519で定義。
aud:string (Audience, optional)   - 受信者 (APIサービスなど)。RFC 7519で定義。
exp:number (Expiration Time)      - 有効期限 (Unix時間)。RFC 7519で定義。
nbf:number (Not Before, optional) - 有効開始時刻 (Unix時間)。RFC 7519で定義。
iat:number (Issued At, optional)  - 発行時刻 (Unix時間)。RFC 7519で定義。
jti:string (JWT ID, optional)     - 一意のJWT識別子 (リプレイ攻撃対策に利用)。RFC 7519で定義。
custom_claim:any (Private Claims) - 任意のカスタム情報。

BASE64URL(JWE Header) . BASE64URL(JWE Encrypted Key) . BASE64URL(JWE IV) . BASE64URL(JWE Ciphertext) . BASE64URL(JWE Authentication Tag)

sequenceDiagram
    participant C as クライアント
    participant "AS as 認証サーバー (Auth Server)"
    participant "RS as リソースサーバー (Resource Server)"

    C ->> AS: 1. 認証リクエスト |ユーザー名/パスワード|
    AS -->> C: 2. 認証成功 & JWT発行
    Note right of AS: JWSを生成し、デジタル署名
(またはJWEで暗号化)
    C ->> RS: 3. リソースリクエスト |AuthorizationヘッダにJWTを添付|
    Note right of C: Authorization: Bearer 
    RS ->> RS: 4. JWTの検証 |署名検証, 有効期限チェックなど|
    Note right of RS: ASの公開鍵で署名検証、クレーム検証
    alt 検証成功
        RS -->> C: 5. リソース提供
    else 検証失敗
        RS -->> C: 5. エラー応答 |例: 401 Unauthorized|
    end