ガイド
オフライン JWT デコード・Base64URL・セマンティック JSON Diff ガイド
送信ゼロのブラウザメモリ上で JWT のヘッダーとクレームをデコードし、パディングなし Base64URL 変換やキー順を問わないセマンティック JSON Diff、ログ秘匿化を実行。
クイックアンサー: 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 文字セットの復号にもそのまま対応します。
{
"header": {
"alg": "HS256",
"typ": "JWT"
},
"payload": {
"sub": "user_123",
"name": "Maya Lin",
"local": "true"
},
"signature": "dGVzdF9zaWduYXR1cmU"
}行比較ではなくセマンティック JSON Diff で API レスポンスを比較
検証環境と本番環境の JSON レスポンスを比べる際、キーの出力順やインデントが違うだけで通常の行単位 Diff は大量の偽陽性で埋め尽くされます。テキスト・JSON 差分比較で semanticJsonDiff を有効にすると、両ペインを JSON として構文解析したうえで値と構造の差分だけを抽出します。
// コメントや末尾カンマを含む JSONC の場合は先に JSON 整形・修復(repairTrailingCommas)で整えられます。設定を TOML へ書き出す場合、TOML 仕様には null 型がないため JSON → TOML 変換が null キーを警告付きで自動スキップします。
| 比較モード | キー順序の入れ替わり | 空白・圧縮フォーマット差 | 適した用途 |
|---|---|---|---|
| 行単位 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 接続文字列をローカルで確実に置換できます。
参考文献
よくある質問
Base64・JWT デコーダーは JWT の暗号学的署名も検証しますか?
いいえ。秘密鍵や公開鍵の入力・送信を避けるため、ローカルで Base64URL ヘッダーとペイロード JSON を復号し署名文字列を表示するのみです。署名検証は必ずバックエンド側で行ってください。
通常の Base64 と Base64URL の違いは何ですか?
Base64URL は + を -、/ を _ に置き換え、通常は末尾の = パディングを省略するため、URL パラメータや HTTP ヘッダーに安全に埋め込めます。
セマンティック JSON Diff が左右ともに有効な JSON を求めるのはなぜですか?
キー順や改行に左右されない構造比較を行うため、双方をいったん JSON オブジェクトへパースするからです。コメントや末尾カンマがある場合は先に JSON 整形・修復で整えてください。
関連フォーマット
関連比較ページ
関連ガイド
- なぜサーバー送信型のオンライン整形ツールは危険なのか — ゼロアップロード設計の仕組み.env・JWT・顧客 CSV・契約書を外部変換サイトへ貼る危険性と、DevTools Network タブで送信量 0 バイトを確認できる仕組みを解説します。
- XML から JSON への変換:属性・CDATA・RSS フィードを保持する実践ガイドXML・RSS・SVG をブラウザメモリ内で JSON に変換し、@_ 属性や CDATA テキスト、数値型を保持したまま XML への往復変換も行えます。
- ChatGPT 向けにテキスト・契約書・ログをローカルで匿名化する方法ChatGPT や Claude に貼り付ける前に、氏名・IBAN・契約書・API キーをブラウザ RAM 内で可逆 [[TYPE-NN]] トークンへ置換します。