JWTとは
JWT(JSON Web Token、「ジョット」と読みます)は、ログイン情報や権限などを JSON 形式で安全にやり取りするためのトークンです。OAuth 2.0 / OpenID Connect のアクセストークンや ID トークン、Firebase Authentication、Auth0、AWS Cognito などで広く使われています。
JWTは . で区切られた3つのパートでできています。
| パート | 内容 |
|---|---|
| ヘッダー | 署名アルゴリズム(alg)やトークンの種類(typ) |
| ペイロード | ユーザーIDや有効期限などの情報(クレーム) |
| 署名 | 改ざんされていないことを確認するための署名 |
ヘッダーとペイロードは URL-safe Base64 でエンコードされているだけで、暗号化はされていません。誰でも中身を読めるので、パスワードなどの秘密情報をペイロードに入れてはいけません。
主なクレーム
| クレーム | 意味 |
|---|---|
iss | 発行者(Issuer) |
sub | 主体・ユーザーID(Subject) |
aud | 受信者(Audience) |
exp | 有効期限(Expiration Time)。UNIX時間(秒) |
nbf | 有効開始日時(Not Before) |
iat | 発行日時(Issued At) |
jti | トークンの一意なID |
exp・iat・nbf を日本時間で読む
JWT の日時のクレーム(exp / iat / nbf)は、どれも 1970年1月1日 0時0分0秒(UTC)からの経過秒数(UNIX時間)です。日本時間にするには9時間を足します。たとえば exp が 1700000000 なら、日本時間では 2023-11-15 07:13:20 です。このツールはペイロードの日時を自動で日本時間に直して表示します。手で変換したいときは UNIX時間変換 を使ってください。
| クレーム | 意味 | 見るポイント |
|---|---|---|
exp | この時刻を過ぎたら無効 | 現在時刻より前なら期限切れ |
nbf | この時刻より前は無効 | 現在時刻より後なら「まだ使えない」 |
iat | 発行した時刻 | exp - iat が有効期間(3600 なら1時間) |
ログインできないときの確認手順
expが現在時刻より前になっていないか確認する(期限切れ)。nbfやiatが未来になっていないか確認する。サーバー間の時計のずれが原因のことがあります。expが13桁なら、ミリ秒で作られている可能性がある。JWT では秒(10桁)が決まりです。aud(受信者)やiss(発行者)が、検証する側の設定と一致しているか確認する。
サーバー間の時計の小さなずれは、検証ライブラリの leeway(PyJWT)や clockTolerance(Node の jsonwebtoken)で数十秒ほど許容できます。
JWT のヘッダーとペイロードは Base64URL で符号化されています。手で確かめたいときは Base64エンコード・デコード(URL-safe に対応)が使えます。
よくある質問
本番のトークンを貼り付けても大丈夫ですか?
当ツールはトークンをサーバーに送信せず、ブラウザ内でデコードします。ただし、有効なアクセストークンは漏れると悪用される恐れがあるため、どのツールでも取り扱いには注意し、確認後はクリアすることをおすすめします。
署名の検証はできますか?
このツールはデコード(中身の表示)専用で、署名の検証は行いません。署名の検証には秘密鍵・公開鍵が必要なため、サーバー側のライブラリで行ってください。
「401 Unauthorized」の原因を調べたい
まず exp(有効期限)が過ぎていないか、aud や iss がAPIの設定と一致しているかを確認してください。サーバーとクライアントの時計のずれにも注意しましょう。
exp が13桁になっています
JavaScript の Date.now() はミリ秒(13桁)を返すため、そのまま exp に入れると、秒として読んだときに数万年先の日付になります。Math.floor(Date.now() / 1000) で秒に直してから足してください。
exp を過ぎていないのに期限切れと言われます
発行側と検証側のサーバー時刻がずれているか、タイムゾーンの扱いを取り違えている可能性があります。UNIX時間は常に UTC 基準なので、日本時間にそのまま足し引きしないでください。