全体像:どの層の話かを分ける
名前が似ているので混乱しやすいですが、次のように層が違います。
| 名前 | 何の話か |
|---|---|
| Basic / Bearer | Authorization ヘッダーの書き方(認証の方式) |
| JWT | Bearer で送る「トークン」の中身の形式のひとつ |
| Base64 | 文字にするためのエンコード方式。Basic 認証でも JWT でも部品として使われる |
つまり、「Bearer トークンとして JWT を送る」のように、組み合わせて使います。
Basic 認証
ユーザー名とパスワードを : でつなぎ、Base64 にして送る、最も単純な方式です。
Authorization: Basic dXNlcjpwYXNz
この dXNlcjpwYXNz を Base64 デコードすると user:pass になります。Base64 は暗号化ではないので、通信を傍受されれば、パスワードがそのまま読まれます。Basic 認証は、必ず HTTPS と組み合わせます。
Bearer トークン
Authorization: Bearer ここにトークン の形です。「Bearer」は「持っている人」という意味で、このトークンを持っている人を本人とみなす方式です。トークンの中身は決まっておらず、ランダムな文字列でも、JWT でもかまいません。
- ランダムな文字列:サーバーが、持っている一覧と照らし合わせて確認する
- JWT:トークン自体に情報が入っていて、署名を確認すれば照合の一覧がなくても判断できる
トークンは「持っているだけで使える」ので、漏れたときの被害はパスワードと同じです。URL のクエリに付けると、アクセスログやブラウザの履歴に残るため、ヘッダーで送るのが原則です。
JWT の構造
JWT は、ピリオドで区切られた3つの部分でできています。
ヘッダー.ペイロード.署名
| 部分 | 中身 |
|---|---|
| ヘッダー | 署名の方式(alg)など |
| ペイロード | ユーザーの ID や、有効期限(exp)などの情報(クレーム) |
| 署名 | ヘッダーとペイロードが改ざんされていないことを確かめるための値 |
ヘッダーとペイロードは、Base64URL(Base64 の + と / を - と _ に置き換え、末尾の = を省いたもの)でエンコードされた JSON です。JWTデコードに貼り付けると、中身がそのまま読めます。
よくある勘違い
JWT は暗号化されている? → されていない
署名があるのは、改ざんを見つけるためです。内容を隠す仕組みではありません。ペイロードは誰でも読めるので、パスワード、個人情報、秘密の設定を入れてはいけません。
署名を確認しないで中身を信じてはいけない
ペイロードは誰でも書き換えて作れます。サーバーは、必ず署名を確認してから中身を使います。署名方式(alg)をトークン側の指定に任せず、サーバー側で使う方式を固定することが大切です。過去には、alg を none(署名なし)にして通してしまう実装の問題がありました。
JWT はログアウトで簡単に無効にできない
JWT は、サーバーが一覧を持たなくても有効かを判断できる分、発行したあとに取り消しにくいという弱点があります。有効期限(exp)を短くする、取り消しの一覧を別に持つ、などの対策を取ります。
401 と 403 のちがい
| ステータス | 意味 | よくある原因 |
|---|---|---|
| 401 Unauthorized | 認証されていない(誰か分からない) | トークンがない・期限切れ・署名が不正・形式の誤り |
| 403 Forbidden | 誰かは分かったが、権限がない | そのリソースを使える権限(ロール)がない |
401 は「ログインし直せば通るかもしれない」、403 は「ログインし直しても権限がなければ通らない」と考えると見分けられます。
認証エラー(401)が出たときの確認手順
- ヘッダーの書き方:
Bearerと トークンのあいだにスペースが1つあるか。Bearerを付け忘れていないか。 - トークンの前後:コピーしたときに、改行や空白が混ざっていないか。
- 有効期限:JWTデコードで
expを日本時間で見て、期限が切れていないか。 - 時計のずれ:
nbf(これより前は無効)やiat(発行時刻)が、サーバーの時計より未来になっていないか。サーバー間で時計が数秒〜数分ずれていると、発行直後のトークンが拒否されることがある。 - 秒かミリ秒か:
expを自前で作るとき、ミリ秒の値を入れていないか(日時トラブルの原因まとめ)。 - 発行元と宛先:
iss(発行者)やaud(宛先)が、API 側の期待する値と一致しているか。 - 環境の違い:開発用のトークンを本番で、または別のサービス用のトークンを使っていないか。