JWTデコーダー

JWT(JSON Web Token)を貼り付けると、ヘッダーとペイロードの中身、有効期限(exp)などを確認できます。トークンはブラウザ内だけで処理され、外部に送信されません。

ヘッダー
ペイロード

          
署名(未検証)

        

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時間)

ログインできないときの確認手順

  1. exp が現在時刻より前になっていないか確認する(期限切れ)。
  2. nbf や iat が未来になっていないか確認する。サーバー間の時計のずれが原因のことがあります。
  3. exp が13桁なら、ミリ秒で作られている可能性がある。JWT では秒(10桁)が決まりです。
  4. 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 基準なので、日本時間にそのまま足し引きしないでください。

関連する解説記事