JWTとは?構造、署名、安全な使い方
ドットで区切られた3つのbase64urlチャンク。ヘッダー、ペイロード、署名です。各部分が何を証明し、何を証明しないか、そしてJWTをセキュリティホールにする5つのミスを学びます。
このガイドで学べること
- JWTを読んで3つの部分の名前を言える
- 署名が何を証明し、何を証明しないかを説明できる
- 標準クレーム(exp、iss、aud、sub)を正しく使える
- JWTがサーバー側セッションより優れる場合(と劣る場合)を判断できる
- 5つの定番のJWTセキュリティミスを避けられる
- JWTとは何か
- 構造:3つの部分
- 署名と検証の仕組み
- 標準クレーム
- JWTを使うべきとき、使うべきでないとき
- よくあるミス
- 試す:JWTデコーダ
- よくある質問
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) | いいえ — 誰でも読めます |
| ペイロード | クレーム:あなたが誰で、何ができて、いつ期限切れになるか | いいえ — 誰でも読めます |
| 署名 | ヘッダー + ペイロードのハッシュ。秘密鍵付き | はい — 発行者のみが作れます |
署名と検証の仕組み
署名を作成するために、発行者は次のものを取ります 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(JWS)は署名付きであって暗号化されていません。ペイロードはbase64urlで、誰でもデコードできます。暗号化は別のフォーマットであるJWEで、内容そのものを秘密にしなければならない場合に使います。
ユーザーがログアウトしたときにJWTを取り消すにはどうすればよいですか?
直接削除することはできません。expまで有効なままです。実践的な答えは、リフレッシュトークンと組み合わせた短い有効期限か、機密性の高いエンドポイントでチェックする、取り消されたトークンID(jtiクレーム)のサーバー側デニーリストです。
JWTとセッションCookie、どちらを選ぶべきですか?
データベースを持つ単一のアプリにはセッションCookieが適しています。シンプルで、即座に取り消せます。JWTは、検証者がセッションストアを共有できないAPIやマイクロサービス、またはトークンがサービス境界を越える場合に適しています。多くのシステムは両方を使います。ブラウザにはセッション、サービス間通信にはJWTです。
ブラウザではJWTをどこに保存すべきですか?
HttpOnly、Secure、SameSiteのCookieに入れましょう。JavaScriptからは読めないため、XSSで盗めません。localStorageは便利ですが、ページ上のあらゆるスクリプト(注入されたものも含む)から読めてしまいます。
秘密なしでJWTをデコードできますか?
はい。ヘッダーとペイロードのデコードに鍵はまったく不要です。鍵が必要なのは署名の検証だけです。だからJWTデコーダツールはトークンの内容を即座に表示できるのであり、ペイロードに秘密を入れてはいけない理由でもあります。