w
ドキュメント コアツール Jwt Parser

基本的な使い方

このガイドでは、JWT Parser ツールを使って JSON Web Token を解析する基本的な手順を説明します。

ステップ 1: ツールにアクセスする

メインのツールページから JWT Parser ツールへ移動するか、URL /jwt-parser に直接アクセスします。

ステップ 2: JWT トークンを入力する

方法 1: 手動入力

  1. 「JWT Token」テキストエリアをクリックします
  2. JWT トークンを貼り付けるか入力します
  3. 入力と同時にツールが自動でトークンを解析します

方法 2: サンプルを読み込む

  1. 「Load Example」ボタンをクリックします
  2. サンプル JWT トークンが自動で読み込まれます
  3. これはテストやツール機能の学習に便利です

ステップ 3: 解析結果を確認する

有効な JWT トークンを入力すると、3 つの主要セクションが表示されます。

ヘッダー情報

  • アルゴリズム: 使用されている署名アルゴリズム（例: HS256、RS256）
  • タイプ: トークンの種類（通常は「JWT」）
  • 追加クレーム: その他のヘッダークレーム

ペイロードデータ

  • 標準クレーム: iss、sub、aud、exp、nbf、iat、jti
  • カスタムクレーム: アプリケーション固有のデータ
  • 有効期限: トークンの有効期限（指定されている場合）

署名

  • 生の署名: base64url エンコードされた署名
  • 検証メモ: このツールは署名を検証しないことを示す注意

ステップ 4: 追加機能を使う

結果をコピーする

  1. 「Copy Result」ボタンをクリックします
  2. 解析された情報がクリップボードにコピーされます
  3. お好みのテキストエディタやドキュメントに貼り付けます

内容をクリアする

  1. 「Clear All」をクリックしてすべての内容を削除します
  2. 新しいトークンで最初からやり直します

履歴を見る

  • 以前に解析したトークンは履歴セクションに表示されます
  • 任意の履歴項目をクリックするとそのトークンを再読み込みできます
  • 「Clear History」を使うと保存済みトークンをすべて削除できます

出力を理解する

ヘッダー例

{
  "alg": "HS256",
  "typ": "JWT"
}

ペイロード例

{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022,
  "exp": 1516242622
}

よくあるクレームの説明

  • sub (Subject): トークンの主体
  • iat (Issued At): トークンが発行された時刻
  • exp (Expiration): トークンの有効期限
  • aud (Audience): トークンの想定受信者
  • iss (Issuer): トークンの発行者

エラーハンドリング

無効な形式

無効な JWT 形式を入力すると、次のエラーメッセージが表示されます。

  • "Invalid JWT format. JWT should have 3 parts separated by dots."

解析エラー

トークンを解析できない場合は、次のメッセージが表示されます。

  • "Failed to parse JWT token"

よくある問題

  • ドットが足りない: JWT は 3 つの部分を分けるためにちょうど 2 つのドットが必要です
  • 無効な base64: 各部分は有効な base64url エンコードである必要があります
  • 不正な JSON: ヘッダーとペイロードは有効な JSON でなければなりません

ベストプラクティス

セキュリティ

  • このツールはテスト用トークンまたは自分が所有するトークンにのみ使用してください
  • 機密性の高い本番トークンは決して共有しないでください
  • 安全でプライベートな環境でのみ使用してください

開発ワークフロー

  1. 開発環境でテストトークンを生成します
  2. 解析して構造とクレームを検証します
  3. 結果を使って認証の問題をデバッグします
  4. プロジェクトを切り替えるときは履歴をクリアします

トークン管理

  • 重要なテストトークンは記録を残しておきます
  • 頻繁に分析するトークンには履歴機能を活用します
  • プライバシーを守るため定期的に履歴を削除します

次のステップ

基本を理解したら、より高度な利用パターンを学ぶために高度な機能を確認し、安全なトークンの扱い方についてはセキュリティに関する考慮事項を参照してください。

このページは役に立ちましたか？