FIRST CH TOOLS / 開発 / 24 JWT DECODER
JWTデコーダー&有効期限チェッカー
JWTを貼り付けると、内部のJSONと有効期限までの残り時間を表示します。処理は端末内で完結します。
できることと詳しい説明
ヘッダーとペイロードを整形したJSONで表示し、有効期限(exp)までの残り時間をバーで示します。期限切れ・時計のズレ・alg: none・秒とミリ秒の取り違えといった、認証時に起こりやすい問題もその場で指摘します。共有鍵や公開鍵を入れれば署名の検証(HS / RS / PS / ES / EdDSA)もできます。貼り付けたトークンや鍵は、端末外へ送信しません。
ヘッダーとペイロードを整形JSONで表示します
JWTを貼ると、ここにヘッダー(署名の方式)・ペイロード(中身)・署名が出ます。試すだけなら
—
クレームの意味と日時を読み下します
鍵を入れると署名を検証します(鍵は端末から出ません)
公開鍵を配布しているサービス(Auth0・Firebase・Cognito・Keycloak など)は https://<発行者>/.well-known/jwks.json にJWKSを置いています。その中身をそのまま貼り付ければ、ヘッダーの kid に合う鍵を選んで検証します(このページはネットワークへ取りに行かないので、内容はご自身でコピーしてください)。証明書しか手元にない場合は openssl x509 -pubkey -noout -in cert.pem で公開鍵を取り出せます。
時計のズレで変わる判定を画像で共有
有効期間15分の架空のトークンを、exp の前後5つの時刻で、主なライブラリの既定の許容ズレ(0秒・60秒・5分)ごとに判定した表です。判定はこのページと同じ計算です。上に貼ったトークンや鍵はカードに入りません。
How to Use
- トークンを貼るJWTをそのまま貼り付けます。Authorization: Bearer … の形や、前後の引用符・途中の改行が入っていても取り除いて読みます。
- 状態を見る有効期限の状態と残り時間が入力欄のすぐ下に表示され、その下の1行に「有効です。あと14分で失効します」のような結論が出ます。バーは発行(iat)から失効(exp)までのどこにいるかを表します。「クレーム一覧」タブで各クレームの意味と日時を確認できます。
- 署名を確かめる「署名の検証」タブに共有鍵(HS256など)か公開鍵(RS256など)を入れると、その場で署名を検証します。デコードだけでは、改ざんされているかどうかは分かりません。
About This Tool
JWT は ヘッダー・ペイロード・署名の3つを base64url で符号化してドットでつないだ文字列です。base64url は暗号化ではありません。トークンを持っている人は誰でも中身を読めます。だからこそ、パスワード・APIキー・クレジットカード番号のような秘密情報をペイロードに入れてはいけません。このページは、そのこの仕組みを利用し、通信を一切せずに端末の中だけでデコードしています。
デコードと検証は別物です。デコードは誰にでもできますが、そのトークンが本物か(署名された後に書き換えられていないか)を確かめるには鍵が要ります。このページの「署名の検証」タブは、ブラウザ標準の Web Crypto を使って HS256/384/512(共有鍵)・RS256/384/512・PS256/384/512・ES256/384/512(公開鍵)・EdDSA を検証します。入力した鍵もネットワークへは出ません。ただし本番環境の秘密鍵をどこかに貼り付ける習慣そのものが危険なので、検証には検証用の鍵を使ってください。
有効期限(exp)は1970年1月1日からの「秒数」です。JavaScriptの Date.now() はミリ秒を返すため、1000で割り忘れたまま exp に入れてしまう事故が非常に多く、その場合トークンは事実上何万年も失効しません。このページは桁が大きすぎる時刻を検出して指摘します。逆に、期限切れなのに通ってしまう・まだ有効なのに弾かれるといった症状は、たいていサーバー間の時計のズレが原因です。許容するズレ(leeway)を切り替えて、境界のどちら側にいるか確認できます。
実例: exp を45秒過ぎたトークンの判定は、検証側のライブラリで分かれます。RFC 7519 は exp・nbf の判定に「通常は数分以内」の小さな猶予(leeway)を認めており、許容するズレの既定値はライブラリごとに違います。Node.js の jsonwebtoken は clockTolerance を指定しなければ0秒、PyJWT の leeway も既定は0、Spring Security の Resource Server は60秒、.NET の Microsoft.IdentityModel(TokenValidationParameters.DefaultClockSkew)は300秒(5分)です。このため、有効期間15分のトークンが exp を45秒過ぎた時点では、jsonwebtoken・PyJWT は期限切れとして拒み、Spring Security と .NET はまだ受け入れます(上の比較カードと「この例を上で開く」はこの条件をこのページの判定で計算したもの)。「あるサーバーでは通るのに別のサーバーでは401になる」ときは、時計そのもののズレに加えて、この既定値の違いを疑ってください。
alg: none は歴史的に最も有名なJWTの脆弱性です。攻撃者が署名を消して alg を none に書き換えたトークンを送り、検証側のライブラリがそれを「署名不要」と解釈してしまう、という筋書きでした。同じ系統の問題に、RS256のトークンをHS256に書き換えて公開鍵を共有鍵として使わせる攻撃があります。受け取る側は期待するアルゴリズムを自分で決め打ちして検証するのが原則で、トークンの alg を信用してはいけません。
JWTの中身のうち iss(発行者)・aud(想定する受け手)・exp・nbf・iat・sub・jti は RFC 7519 が定めた登録済みクレームです。aud を検証しないと、同じ鍵を信頼している別のサービスへトークンを使い回されるおそれがあります。「クレーム一覧」タブでは、これらに加えて OpenID Connect の azp・nonce・auth_time・amr などにも説明を付けています。
5つのセグメントを持つ文字列は JWE(暗号化されたトークン)で、読めるのはヘッダーだけです。中身の復号には受信者の秘密鍵が必要なので、このページでは開けません(開けたら暗号化の意味がありません)。
画面の欄に貼ったトークンはブラウザの外へ出ません。URLパラメータで直接呼び出すこともできます: /jwt/?token=eyJhbGciOi… / /jwt/?token=…&tab=claims。ただしURLに入れた値はページを開くリクエストとしてサーバーへ届き、ブラウザの履歴や共有先にも残ります。この呼び出し方は開発中のトークンや自動化からの利用に留めてください。
出典(2026-11-09確認)
- exp・nbf は「数分以内」の猶予を認める(§4.1.4・§4.1.5)、NumericDate は秒数(§2): RFC 7519「JSON Web Token (JWT)」 rfc-editor.org/rfc/rfc7519.html
- jsonwebtoken(Node.js): 判定は clockTimestamp >= payload.exp + (options.clockTolerance || 0)=既定0秒 github.com/auth0/node-jsonwebtoken/blob/master/verify.js
- PyJWT: jwt.decode の leeway の既定は0 pyjwt.readthedocs.io/en/stable/api.html
- Spring Security: 「By default, Resource Server configures a clock skew of 60 seconds.」 docs.spring.io/spring-security/reference/servlet/oauth2/resource-server/jwt.html
- Microsoft.IdentityModel.Tokens(v8.23.0 の資料): DefaultClockSkew は「300 seconds (5 minutes)」 learn.microsoft.com/…/tokenvalidationparameters.defaultclockskew
From AI Agents
このデコード・有効期限判定・署名検証のロジックは、MCP(Model Context Protocol)サーバー @first-ch/tools-mcp の jwt_decode ツールとしても提供しており、ブラウザを使わずAIエージェントから直接呼び出せます。導入方法の詳細は AIエージェント向けの使い方 を参照してください。
導入
claude mcp add firstch-tools -- npx -y @first-ch/tools-mcp
呼び出し例
# デコードして有効期限を見る jwt_decode(token="eyJhbGciOiJIUzI1NiJ9...") # 共有鍵で署名を検証する jwt_decode(token="eyJ...", key="your-256-bit-secret") # 公開鍵(PEM / JWK / JWKS)で検証する jwt_decode(token="eyJ...", key="-----BEGIN PUBLIC KEY-----\n...") # 時計のズレを60秒まで許容して判定する jwt_decode(token="eyJ...", clockTolerance=60)