ガイド

オフライン JWT デコード・Base64URL・セマンティック JSON Diff ガイド

送信ゼロのブラウザメモリ上で JWT のヘッダーとクレームをデコードし、パディングなし Base64URL 変換やキー順を問わないセマンティック JSON Diff、ログ秘匿化を実行。

読了目安 4分

クイックアンサー: JWT のヘッダーとペイロードは Base64URL で符号化された UTF-8 JSON にすぎないため、ブラウザメモリ内で送信ゼロのまま安全にデコードできます。API 差分比較にはキー順と空白を無視するセマンティック JSON Diff を活用し、ログ共有前には Bearer トークンを自動マスクしてください。

本番環境の JWT をオンラインデコーダーへ貼り付ける危険性

有効期限内の JSON Web Token には、ユーザー ID、メールアドレス、テナント権限、さらにはそのまま API を叩けるセッション権限が含まれています。ネットワーク経由のオンライン解析サイトへ貼ると、アクセスログや監視ツールにトークンが残る恐れがあります。

JWT の 3 要素(header.payload.signature)のうち前 2 つは暗号化されていない Base64URL UTF-8 JSON であるため、中身を確認するだけなら外部通信は一切不要です。

  • RFC 4648 第 5 節の Base64URL は +・/ を -・_ に置き換え、末尾の = パディングを省きます。
  • ブラウザメモリでのデコードにより alg・typ・sub・exp・カスタムクレームを即座に確認できます。
  • なお暗号学的な署名検証はブラウザ上の簡易表示ではなく、必ず鍵を持つ認証サーバーや JWKS 検証器側で実施してください。

JWT の自動判定デコードとパディングなし Base64URL エンコード

Base64・JWT デコーダーをデコードモード(autoDetectJwt オン)にして 3 部構成の Base64URL JWT を貼り付けると、header と payload の JSON および signature 文字列を自動抽出して整形 JSON で表示します。

エンコードモードへ切り替え urlSafe をオンにすれば OAuth の state や URL クエリ向けのパディングなし Base64URL を生成でき、標準の +/ 形式や UTF-8・ASCII 文字セットの復号にもそのまま対応します。

json
{
  "header": {
    "alg": "HS256",
    "typ": "JWT"
  },
  "payload": {
    "sub": "user_123",
    "name": "Maya Lin",
    "local": "true"
  },
  "signature": "dGVzdF9zaWduYXR1cmU"
}

ブラウザメモリ内で JWT と Base64URL をデコード

行比較ではなくセマンティック JSON Diff で API レスポンスを比較

検証環境と本番環境の JSON レスポンスを比べる際、キーの出力順やインデントが違うだけで通常の行単位 Diff は大量の偽陽性で埋め尽くされます。テキスト・JSON 差分比較で semanticJsonDiff を有効にすると、両ペインを JSON として構文解析したうえで値と構造の差分だけを抽出します。

// コメントや末尾カンマを含む JSONC の場合は先に JSON 整形・修復(repairTrailingCommas)で整えられます。設定を TOML へ書き出す場合、TOML 仕様には null 型がないため JSON → TOML 変換が null キーを警告付きで自動スキップします。

セマンティック JSON Diff や並べて差分比較を実行

比較モードキー順序の入れ替わり空白・圧縮フォーマット差適した用途
行単位 Diff(既定)削除と追加として表示空白無視オフ時は差分表示コードパッチ、.env、プレーンテキスト
行単位 Diff + 空白無視削除と追加として表示行内のインデント空白を無視YAML、SQL、Markdown 文書
セマンティック JSON Diff自動的に無視自動的に無視API レスポンス、JWT クレーム、JSON 設定

デバッグログを共有する前に JWT と DB 接続文字列をサニタイズ

トークンの中身や JSON 差分をローカルで確認したあと、エラーログや HTTP トレースを Slack や AI チャットへ貼り付ける前に必ず機密情報をマスクしてください。

サーバーログ AI サニタイズに通せば、Authorization ヘッダーの JWT([[JWT-01]])、IP アドレス、API キー、Postgres・Redis 接続文字列をローカルで確実に置換できます。

共有前にログ内の JWT やシークレットをローカルで秘匿化

参考文献

よくある質問

Base64・JWT デコーダーは JWT の暗号学的署名も検証しますか?

いいえ。秘密鍵や公開鍵の入力・送信を避けるため、ローカルで Base64URL ヘッダーとペイロード JSON を復号し署名文字列を表示するのみです。署名検証は必ずバックエンド側で行ってください。

通常の Base64 と Base64URL の違いは何ですか?

Base64URL は + を -、/ を _ に置き換え、通常は末尾の = パディングを省略するため、URL パラメータや HTTP ヘッダーに安全に埋め込めます。

セマンティック JSON Diff が左右ともに有効な JSON を求めるのはなぜですか?

キー順や改行に左右されない構造比較を行うため、双方をいったん JSON オブジェクトへパースするからです。コメントや末尾カンマがある場合は先に JSON 整形・修復で整えてください。

関連フォーマット

関連比較ページ

関連ガイド