認証トークンの基礎:Basic認証・Bearer・JWT・Base64の関係

API を呼ぶとき、Authorization ヘッダーに「何か」を付けます。Basic、Bearer、JWT、Base64 は別々の話ではなく、層が違うだけです。

全体像:どの層の話かを分ける

名前が似ているので混乱しやすいですが、次のように層が違います。

名前何の話か
Basic / BearerAuthorization ヘッダーの書き方(認証の方式)
JWTBearer で送る「トークン」の中身の形式のひとつ
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)が出たときの確認手順

  1. ヘッダーの書き方:Bearer と トークンのあいだにスペースが1つあるか。Bearer を付け忘れていないか。
  2. トークンの前後:コピーしたときに、改行や空白が混ざっていないか。
  3. 有効期限:JWTデコードで exp を日本時間で見て、期限が切れていないか。
  4. 時計のずれ:nbf(これより前は無効)や iat(発行時刻)が、サーバーの時計より未来になっていないか。サーバー間で時計が数秒〜数分ずれていると、発行直後のトークンが拒否されることがある。
  5. 秒かミリ秒か:exp を自前で作るとき、ミリ秒の値を入れていないか(日時トラブルの原因まとめ)。
  6. 発行元と宛先:iss(発行者)や aud(宛先)が、API 側の期待する値と一致しているか。
  7. 環境の違い:開発用のトークンを本番で、または別のサービス用のトークンを使っていないか。

関連ツール