JWS Compact Serialization形式で送信されるRFC 7519 JSON Web Tokenは、パディングのない3つのBase64URL文字列をピリオドで連結した <header>.<payload>.<signature> で構成されます。Authorization: Bearer <token> のようなHTTPヘッダー値をコピーした場合、デコーダーは先頭の Bearer スキームプレフィックスを自動的に除去してから . で分割します。
以下の標準的なHS256署名付きコンパクトトークンを例に見てみましょう。
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
1. デコードされたJOSE保護ヘッダー
最初のセグメント(eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9)をBase64URLデコードすると、暗号化アルゴリズムとメディアタイプを表す27バイトのUTF-8データが生成されます。
{
"alg": "HS256",
"typ": "JWT"
}
2. デコードされたクレームペイロードとNumericDateタイムスタンプ
2番目のセグメント(eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ)をBase64URLデコードすると、JSONクレームセットが明らかになります。
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
ここで iat(1516239022)は、UTCの 2018-01-18T01:30:22Z に変換されます。ライフサイクル境界がすべて含まれた本番用のアクセストークンを検査する場合、インスペクターは現在のシステムクロックと照らし合わせて各 NumericDate クレームを評価します。
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"iat": 1735689600,
"nbf": 1735689600,
"exp": 1735693200
}
iat(1735689600): 発行日時2025-01-01T00:00:00Znbf(1735689600): 有効開始日時2025-01-01T00:00:00Zexp(1735693200): 有効期限日時2025-01-01T01:00:00Z(正確に3,600秒のTTL)
3. ローカルでのHMAC-SHA256署名検証
デコード処理は、最初の2つのセグメントが有効なBase64URLエンコードされたJSONであることしか証明せず、クレームが改ざんされていないことは証明しません。最初の例に対して共有シークレット your-256-bit-secret を指定すると、検証ツールは正確なASCII署名入力文字列(eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ)と43文字のBase64URL署名(SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c)を crypto.subtle.verify("HMAC", key, signatureBytes, signingInputBytes) に渡します。デコードされたJSONペイロードを1ビットでも書き換えると、期待される32バイトのMACタグが変化し、即座に署名不一致として検出されます。