JWT生成ツール｜トークン作成

JWTは「ヘッダー.ペイロード.署名」の3部分をBase64URLエンコードしてドット（.）で連結した文字列です。ヘッダーには署名アルゴリズム（alg: "HS256"）とトークンタイプ（typ: "JWT"）が含まれます。ペイロードには認証情報（ユーザーID・権限など）とメタデータ（有効期限・発行日時など）をJSONで記述します。署名は秘密鍵を使ってヘッダーとペイロードから生成され、改ざん検出に使われます。

HS256は対称鍵アルゴリズムで、同じ秘密鍵で署名と検証の両方を行います。HMAC（Hash-based Message Authentication Code）とSHA-256ハッシュ関数を組み合わせて署名を生成します。署名者（サーバー）と検証者（同じサーバー）が同じ秘密鍵を持つ必要があるため、マイクロサービス間の信頼や外部への公開には向いていません。外部に公開する場合はRS256（公開鍵で検証できる非対称アルゴリズム）が適しています。

RFC 7519で定義された主要な標準クレームを紹介します。iss（Issuer）はトークン発行者、sub（Subject）はトークンの主体（ユーザーID等）、aud（Audience）は対象受信者、exp（Expiration Time）はUnixタイムスタンプ形式の有効期限、nbf（Not Before）は有効開始時刻、iat（Issued At）は発行日時、jti（JWT ID）はトークンの一意識別子です。標準クレーム以外にも、アプリ固有のカスタムクレームをペイロードに追加できます。

セキュリティとユーザービリティを両立するため、有効期限の短いアクセストークン（15分〜1時間）と有効期限の長いリフレッシュトークン（1日〜30日）を組み合わせる「ダブルトークン」パターンが広く使われています。アクセストークンはAPIリクエストのAuthorizationヘッダーに付けて送り、期限切れになったらリフレッシュトークンで新しいアクセストークンを取得します。

ブラウザでのJWT保存場所にはlocalStorage・sessionStorage・HttpOnly Cookieの3択があります。localStorageはXSS攻撃でトークンが盗まれるリスクがあります。HttpOnly Cookieに保存するとJavaScriptからアクセスできないためXSSに強くなりますが、CSRF対策が必要になります。SameSite=StrictまたはSameSite=LaxのCookieフラグを使うことでCSRFリスクを大幅に軽減できます。

JWTはステートレスなためサーバー側でトークンを管理しません。これが利点である一方、「発行したトークンを無効化する」のが難しいという欠点でもあります。対策としてはexpを短く設定する・トークンのブラックリストをRedis等に保持する・jtiクレームを使って使用済みトークンを追跡する、などの方法があります。セキュリティ要件に応じて適切な方法を選択してください。