ガイド

よくある JWT エラーと対処

JWT を扱うときによく出会うエラーと、その原因・対処法です。

invalid signature：署名が一致しない — 鍵が違うか header.payload が改ざんされています。検証鍵とアルゴリズムを確認してください。
token expired：exp の時刻を過ぎた — 新しいトークンを再発行するか、リフレッシュトークンで更新してください。
malformed token：点（.）で区切られた3部でない、または base64url が壊れている — 前後の空白・引用符・'Bearer ' 接頭辞を除去してください。
algorithm mismatch：期待した alg と異なる（例：none、HS↔RS の混同）— 許可アルゴリズムを固定し none を拒否してください。

トークンを自分でデコードしてみましょう貼り付けるだけでヘッダー・ペイロード・クレームがすぐに展開されます。

デコーダーを開く

関連項目

JWTとは何か

JWT（JSON Web Token）は、当事者間で情報を安全にやり取りするための、署名された小さなJSONトークン形式です。

JWTの3部構造

すべてのJWTは header.payload.signature の3部で構成され、各部はbase64urlでエンコードされます。

JWTセキュリティチェックリスト

JWTを安全に使うための重要な原則を短くまとめました。

JWT とセッション認証

トークン（JWT）認証とサーバーセッション（クッキー）認証の違いと選び方です。

アクセストークンとリフレッシュトークン

短命のアクセストークンと、それを再発行するリフレッシュトークンの役割です。

JWS と JWE（署名 vs 暗号化）

JWT は通常は署名された JWS で、内容を隠すには暗号化された JWE を使います。その違いです。

JWT の保存先：localStorage vs クッキー

ブラウザで JWT をどこに保存するかで XSS・CSRF のリスクが変わります。

カスタムクレーム（公開 vs 非公開）

登録クレーム（iss・exp など）以外に自分で定義するクレームの種類と衝突回避法です。

OAuth 2.0・OpenID Connect における JWT

JWT が OAuth 2.0 と OpenID Connect でどんな役割を果たすかをまとめます。