JWTとは?構造、署名、安全な使い方

ドットで区切られた3つのbase64urlチャンク。ヘッダー、ペイロード、署名です。各部分が何を証明し、何を証明しないか、そしてJWTをセキュリティホールにする5つのミスを学びます。

📂 開発者の基礎知識 ⏱ 約11分 📶 中級 🛠️ 対応ツール:JWTデコーダ

このガイドで学べること

  • JWTを読んで3つの部分の名前を言える
  • 署名が何を証明し、何を証明しないかを説明できる
  • 標準クレーム(exp、iss、aud、sub)を正しく使える
  • JWTがサーバー側セッションより優れる場合(と劣る場合)を判断できる
  • 5つの定番のJWTセキュリティミスを避けられる
このガイドの内容
  1. JWTとは何か
  2. 構造:3つの部分
  3. 署名と検証の仕組み
  4. 標準クレーム
  5. JWTを使うべきとき、使うべきでないとき
  6. よくあるミス
  7. 試す:JWTデコーダ
  8. よくある質問

JWTとは何か

A JSON Web Token (JWT) は、署名付きのクレームを2者間で渡すための、コンパクトでURLセーフな方法です。見た目は次のようになります:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IlZhbGV2IiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

ドットで区切られた3つのブロック: header.payload.signature。サーバーはログイン後にこれを作成してあなたに渡し、あなたはリクエストごとにこれを送り返します。通常は次の Authorization: Bearer <token> ヘッダーに入れて送ります。サーバーは署名を検証し、中のクレームを信頼します。データベースを調べることはありません。この「検索不要」という性質こそが全体のポイントであり、この後見るように、主な弱点でもあります。

構造:3つの部分

各部分は base64urlエンコードされたJSONです (base64の +// → -/_ 、パディングを除去したものなので、URLの中でも生き残ります)。上の例をデコードすると次のようになります:

// Header — how the token is signed
{ "alg": "HS256", "typ": "JWT" }

// Payload — the claims (statements about the user)
{ "sub": "1234567890", "name": "Valev", "admin": true, "iat": 1516239022 }

// Signature — HMAC-SHA256 over header.payload, with a secret key
部分内容秘密?
ヘッダー署名アルゴリズム(alg)とタイプ(typ)いいえ — 誰でも読めます
ペイロードクレーム:あなたが誰で、何ができて、いつ期限切れになるかいいえ — 誰でも読めます
署名ヘッダー + ペイロードのハッシュ。秘密鍵付きはい — 発行者のみが作れます
ペイロードはエンコードされており、暗号化されていません。 トークンを手に入れた者は誰でもデコードしてすべてのクレームを読むことができます。ユーザーID、メールアドレス、管理者フラグなどです。JWTにパスワード、秘密、機密性の高い個人データを入れてはいけません。ペイロードを秘密にしなければならない場合は、プレーンなJWTではなくJWE(暗号化JWT)が必要です。

署名と検証の仕組み

署名を作成するために、発行者は次のものを取ります base64url(header) + "." + base64url(payload) に署名します:

HMAC-SHA256(secret, header + "." + payload)   // HS256: shared secret
RS256: sign with a private key, verify with a public key

検証は同じ計算を逆に行うものです。サーバーは受け取ったヘッダーとペイロードに対して、自分の秘密鍵を使って署名を再計算し、比較します。ペイロードの1文字でも変更された場合、たとえば "admin": false を true に変えた場合、署名は一致しなくなり、トークンは拒否されます。

2つのアルゴリズムの系統が重要です。 対称(HS256):1つの共有秘密で署名と検証を行います。シンプルですが、秘密を持つ者は誰でもトークンを偽造できるため、発行者のみが持つべきです。 非対称(RS256/ES256):秘密鍵で署名し、公開鍵で検証します。検証者は別のサービスでもよいため、「Googleでログイン」のようなフェデレーションが可能になります。

標準クレーム

クレーム意味重要な理由
iss発行者 — トークンを作成した者他人が発行したトークンを拒否する
subサブジェクト — 誰のトークンか(ユーザーID)アプリが依拠するアイデンティティ
audオーディエンス — トークンの対象サービスあるアプリ用のトークンが別のアプリで再利用されるのを防ぐ
exp有効期限 — それ以降は無効になるUnix時間盗まれたトークンの被害を限定する
iat発行時刻パスワード変更前に作られたトークンを検出する
nbf有効開始時刻後になって初めて有効になるトークン

これらに加えて、アプリは独自のクレームを追加します。ロール、権限、表示名などです。ペイロードは小さく保ちましょう。トークンはリクエストごとに送信されるため、5 KBのトークンはすべての呼び出しに対する税金になります。

JWTを使うべきとき、使うべきでないとき

JWTが輝くのは、データベースへの往復なしに検証しなければならない場合や、セッションストアを共有しないサービス間での場合です。API、マイクロサービス、シングルサインオンなどがそうです。検証者に必要なのは鍵だけです。

ひとつ重要な点で劣ります。 簡単に取り消すことができません。 サーバー側セッションは、ユーザーがログアウトしたりパスワードを変更したりした瞬間に削除できます。一方、JWTは有効期限が切れるまで有効なままです。削除するものがないからです。標準的な緩和策は、有効期限を短くすること(数日ではなく数分)とリフレッシュトークンです。リフレッシュトークンは長寿命のトークンで、ログインエンドポイントにのみ送信され、新しい短寿命のJWTを発行してもらいます。または取り消しリストを使う方法もありますが、これはJWTが避けようとしていたデータベース検索を静かに復活させてしまいます。

経験則:アプリが1つでデータベースが1つなら、従来のセッションCookieのほうがシンプルで安全です。サービスが多数ある場合や、トークンが信頼境界を越えなければならない場合にJWTを使いましょう。

よくあるミス

  • クライアントでデコードしたトークンを信頼すること。 デコードは何も証明しません。証明するのは署名検証だけです。デコードされたペイロードの中の admin: true は、署名が確認されるまでは事実ではなく、クレームにすぎません。
  • を受け入れること。 alg: none. 署名なしのトークンは拒否しなければなりません。いまだにそれを受け入れるライブラリは、JWTの脆弱性の中で最も古いもののひとつであり、今でも見られます。
  • 弱い秘密鍵や漏洩した秘密鍵。 HS256で秘密鍵に secret を使うと数秒で偽造できます。長くランダムな秘密鍵を使い、ローテーションし、決してコミットしないでください。
  • 有効期限なし(exp). )。盗まれたトークンはその後ずっと使えてしまいます。短い exp を設定し、リフレッシュトークンを使いましょう。
  • ペイロードに秘密を入れること。 Base64urlは暗号化ではありません。誰でも読めます。上の注釈を参照してください。
  • トークンをlocalStorageに保存すること。 クロスサイトスクリプティング(XSS)の穴がひとつでもあれば、攻撃者はそれを読み取れます。HttpOnly Cookieのほうがブラウザトークンの安全な置き場所です。

試す:JWTデコーダ

トークンをJWTデコーダに貼り付けると、ヘッダー、ペイロード、人間が読める日付に分割される様子が見られます。このガイドで説明する構造を理解する最速の方法です。

JWTデコーダを開く →

さらに学ぶ

よくある質問

JWTは暗号化されていますか?

いいえ。標準のJWT(JWS)は署名付きであって暗号化されていません。ペイロードはbase64urlで、誰でもデコードできます。暗号化は別のフォーマットであるJWEで、内容そのものを秘密にしなければならない場合に使います。

ユーザーがログアウトしたときにJWTを取り消すにはどうすればよいですか?

直接削除することはできません。expまで有効なままです。実践的な答えは、リフレッシュトークンと組み合わせた短い有効期限か、機密性の高いエンドポイントでチェックする、取り消されたトークンID(jtiクレーム)のサーバー側デニーリストです。

JWTとセッションCookie、どちらを選ぶべきですか?

データベースを持つ単一のアプリにはセッションCookieが適しています。シンプルで、即座に取り消せます。JWTは、検証者がセッションストアを共有できないAPIやマイクロサービス、またはトークンがサービス境界を越える場合に適しています。多くのシステムは両方を使います。ブラウザにはセッション、サービス間通信にはJWTです。

ブラウザではJWTをどこに保存すべきですか?

HttpOnly、Secure、SameSiteのCookieに入れましょう。JavaScriptからは読めないため、XSSで盗めません。localStorageは便利ですが、ページ上のあらゆるスクリプト(注入されたものも含む)から読めてしまいます。

秘密なしでJWTをデコードできますか?

はい。ヘッダーとペイロードのデコードに鍵はまったく不要です。鍵が必要なのは署名の検証だけです。だからJWTデコーダツールはトークンの内容を即座に表示できるのであり、ペイロードに秘密を入れてはいけない理由でもあります。