JWT シークレットジェネレーター

安心して署名に使えるシークレット

HMAC で署名された JWT の強度は、シークレットの強度で決まります。推測されてしまえば、サーバーが信頼するトークンを誰でも発行でき、短いシークレットや人が考えたシークレットはオフラインのクラッキングツールが真っ先に試すものです。このジェネレーターは、ブラウザーの暗号論的乱数生成器から、アルゴリズムが求める長さのキーを生成します。

シークレットの長さの目安

• HS256 には少なくとも 32 バイト (256 ビット) が必要です。それより短いと組み合わせるハッシュより弱くなり、多くのライブラリが受け付けません。
• HS384 には少なくとも 48 バイト (384 ビット) が必要です。
• HS512 には少なくとも 64 バイト (512 ビット) が必要です。
• 長い分には問題ありません。ハッシュのブロックサイズより長いキーは先にハッシュ化されるため、HS256 で 64 バイト、HS512 で 128 バイトを超えても得られるものはありません。

シークレットの使い方

• コードには含めないでください。環境変数やシークレットマネージャーに保存します。「.env 形式でコピー」を使えば、そのまま貼り付けられる行が得られます。
• エンコードに注意してください。シークレットをテキストとして受け取るライブラリもあれば、Base64 の生バイトを期待するものもあります。バイト列にデコードする場合はここで Base64 または Base64URL を選び、ライブラリが文字列をそのまま使う場合は hex が最も安全です。
• ローテーションすると全員がログアウトされます。古いシークレットで署名されたトークンはすべて検証に失敗するようになるため、慌てて行わず、計画的に切り替えてください。
• デプロイ前にテストしましょう。「JWT デコーダーでテスト」を押すと、このシークレットで署名したサンプルトークンとともにデコーダーが開き、有効な署名がどのようなものか確認できます。

よくある質問

JWT シークレットキーを生成するには?

サーバーで使うアルゴリズムを選ぶと、適切な長さのシークレットがすぐに生成されます。ライブラリが期待するエンコードを選び、シークレット、または .env 形式の行をコピーしてください。「再生成」を押すと新しいものに変わります。

HS256 の JWT シークレットはどのくらいの長さが必要ですか?

最低 32 バイト、つまり 256 ビットで、hex なら 64 文字、Base64URL なら 43 文字です。これより短いと、組み合わせて使う SHA-256 ハッシュより弱くなります。

ブラウザーでシークレットを生成しても安全ですか?

はい。キーはブラウザーが TLS にも使う暗号論的乱数生成器 crypto.getRandomValues から作られ、お使いのデバイス上で生成されます。サーバーへの送信、ログへの記録、保存は行われません。

JWT シークレットは hex と Base64 のどちらにすべきですか?

どちらも同じランダムなバイト列を表します。ライブラリがシークレットをプレーンテキストとして扱うなら hex が最も安全で、多くの設定オプションのようにライブラリがシークレットを先に生のバイト列へデコードするなら Base64 または Base64URL が適しています。

パスワードを JWT シークレットとして使えますか?

おすすめできません。パスワードはランダムな 32 バイトに比べて短く予測しやすく、トークンを 1 つ手に入れた人が、ハードウェアの許す限りの速さでオフラインでシークレットを推測できてしまいます。