てもとツール
ツール紹介

JWTの中身を安全に確認する使い方|ヘッダーとペイロードを読む

JWTを貼るだけで、ヘッダーとペイロードを読める形に展開します。有効期限の切れも判定し、日時は人が読める形で表示。署名を送らず手元だけで中身を確認する使い方を画面つきで紹介します。

公開 読了目安 約3分

この記事の要点

  • JWTのヘッダーとペイロードを読める形にする
  • 有効期限の切れをその場で判定する
  • iatやexpを人が読める日時で表示する
  • 貼り付けたトークンは手元だけで処理する
目次

JWT を貼るだけで、ヘッダーとペイロードを読める形に展開します。有効期限が切れているかどうかも、その場で分かります。

iatexp のような時刻は、人が読める日時で表示されます。貼り付けたトークンは外部へ送らず、手元だけで処理します。

JWTの中身を確認するときの注意

JWT は、ドット区切りの長い文字列です。そのままでは中身が読めず、こんな場面で困ります。

  • ペイロードの subrole に何が入っているか確認したい
  • トークンの有効期限が切れていないか調べたい
  • 中身を確認したいが、外部サイトに貼るのは避けたい

JWTデコードツールは、この確認を手元だけで肩代わりします。

JWTデコードツールの使い方

ツールを開くと、JWT の入力欄が出ます。

JWTトークンの入力欄がある初期画面

トークンを貼ると、ヘッダーとペイロードが読める形で並びます。exp があれば、有効期限の切れも判定されます。

JWTを貼り、ヘッダーとペイロードが展開され「期限切れ」と表示された画面

iatexp は「2024/01/01 00:00:00」のような日時で添えられます。数値のまま読み解く必要がありません。

エラーもその場で分かる

正しくない文字列を貼ると、その旨がすぐ表示されます。3つの部分に分かれていない入力は、エラーとして知らせます。

壊れた文字列を入れたときのエラー表示

コピー漏れや欠けを、貼った時点で気づけます。

署名は送らず手元で確認する

このツールは、JWT のデコード(中身の展開)だけを行います。署名の検証はしないため、秘密鍵を入れる必要がありません。

署名部分と「署名の検証は行わない」注記が表示された画面

トークンを外部に送らずに中身を読めるので、確認だけしたい場面に向きます。

こんな場面で使える

  • APIのデバッグ:ペイロードのクレームを、その場で確かめます。
  • 有効期限の確認exp が切れていないかを判定します。
  • 仕様の確認:発行されたトークンの中身を、読める形で見ます。

使用例

たとえば、API のリクエストが弾かれた原因を調べる場面を思い浮かべてみます。

手元のトークンを貼ると、ペイロードと有効期限が出ます。「期限切れ」と出れば、原因が期限だと切り分けられます。

トークンは手元で展開されるので、外に出さずに確認できます。

安心して使えるポイント

貼り付けたトークンは、どこにも送信されません。すべて手元のブラウザの中だけで展開します。

本番のトークンでも、外に出さずに中身を確かめられます。

関連ツール

補足: 開発者の方へ

JWT はヘッダー・ペイロード・署名を . でつないだ文字列で、各部は Base64URL でエンコードされています。本ツールはヘッダーとペイロードを Base64URL デコードし、JSON として整形します。exp は現在時刻と比較して期限切れを判定し、iat / nbf / exp はエポック秒として日時に変換します。署名の検証には秘密鍵や公開鍵が必要なため、このツールはデコードのみに限っています。

まとめ

JWT は、そのままでは中身が読めない文字列です。トークンを貼れば、ヘッダーとペイロードを読める形に展開できます。

有効期限の切れも判定されます。まずは確認したいトークンを貼って、中身を読んでみてください。

JWTデコードツールを開く

あわせて読みたい

同じテーマ・関連ツールの記事です。