← All posts

JWT 署名鍵の 3 つの人生

Authagonal·July 17, 2026
authjwtkey-managementkmsvaultecdsaoidc

私たちの認証サーバーが発行するすべてのトークンには、1 つの秘密鍵が署名しています。これを失えば、攻撃者はパスワードなしで任意のユーザーの有効なトークンを発行でき、ログには何の問題もないログインが残ります。システムの中で最も価値のある秘密であり、その生涯で 2 度引っ越しています。アプリケーションのプロセスの中で生まれ、もう出られない Vault へと追放され、そしてまったく別の種類の鍵として生まれ変わりました。どの引っ越しも、すでにトークンが飛び交い、私たちが制御できない状態を検証者がキャッシュしている、稼働中の発行者の上で行われました。ここでは、そうした引っ越しに実際に何が必要なのかを書きます。最も多くを教えてくれたのは、私たちが公表しなかった引っ越しでした。

1 つ目の人生:サーバーがポケットに入れていた鍵

最初、鍵は使われる場所に住んでいました。サーバーは RSA-2048 の鍵を生成してメモリに保持し、RS256 でトークンに署名していました。これはほぼどこでもデフォルトで、保管責任(custody)という言葉を口に出すまでは何の問題もありません。秘密鍵は、プロセスのメモリ、その設定、あるいはそのどちらかのバックアップを読めるものなら何からでも到達できました。私たちは顧客に「データベースが漏洩しても、役に立つものは何も露出しない」と言えるようにしたかったのですが、そのデータベースからプロセス 1 つ分しか離れていない場所に署名鍵が置かれていては、その主張は嘘になります。鍵は建物から出ていく必要がありました。

2 つ目の人生:出られない Vault に引っ越した鍵

私たちは継ぎ目を導入しました。署名が必要になるたびにサーバーが呼び出す ISignatureProvider で、その裏に KMS を置きました。鍵は今では Vault の transit エンジンの中で生成され、外部に出されることはありません。アプリケーションは鍵を持っていません。署名してほしいバイト列を Vault に送り、署名を受け取ります。鍵を使うことはできても、持ち出すことはできません。

この区別こそが肝心な点です。メモリダンプにも、流出した設定ファイルにも、漏洩したバックアップにも、もう鍵は含まれていません。鍵がそのどこにも置かれたことがないからです。今ではアプリケーションを侵害しても、攻撃者が手に入れられるのは Vault に署名を頼む能力で、私たちはそれをレート制限し、監査し、取り消すことができます。鍵そのものはもう手に入りません。鍵そのものなら、一度持ち出されてしまえば私たちには打つ手がありませんでした。

ここからはリリースノートに書かなかった部分です。鍵を Vault に移したのと同じコミットが、PBKDF2 の反復回数を 100,000 から 50,000 へと、ひっそり半分にしていました。1 つの差分に、逆方向を向いた 2 つのセキュリティ変更です。見出しは「KMS で署名する」で、その下に、パスワードハッシュの作業係数の半減が紛れ込んでいました。話題が別のことだったので、誰も見ていない 1 行でした。どちらもセキュリティのコードなので、両方まとめて 1 つの「よりセキュアな」変更としてレビューされ、良いほうの半分を理由に素通りしたのです。

修正は 1 行でした。教訓はそうではありませんでした。よりセキュアとラベルの付いた差分も、差分であることに変わりはありません。その中にあるセキュリティ上重要な定数、つまり反復回数、鍵長、タイムアウト、アルゴリズム名は、コミットメッセージから後光を受け継ぎません。今では作業係数の数値を、アルゴリズムの選択と同じように扱っています。周りの変更が良いアイデアだったから信用するものではなく、主張され、検証されるものとしてです。

3 つ目の人生:速くなるために小さくなった鍵

署名を KMS の裏に置くと、署名のたびにネットワークの往復が発生し、しかも RSA の署名は高くつく種類のものです。そこで鍵は種族を変えました。RSA-2048 上の RS256 から、P-256 曲線上の ES256 になったのです。楕円曲線による署名は RSA よりおよそ 1 桁安く、P-256 の署名は RSA-2048 の 256 バイトに対して 64 バイトで、検証者がダウンロードする公開鍵セットもそれに応じて小さくなります。鍵が小さく、署名が小さく、JWKS が小さく、トークンが速くなる。どれも、より良い曲線を選んだだけで得られたものです。

落とし穴は、稼働中の発行者では署名アルゴリズムを一発で切り替えられないことです。すでに発行されたトークンはすべて RS256 で署名されていて、期限切れになるまで検証され続けなければなりません。すべての検証者が古い公開鍵をキャッシュしています。アルゴリズムを一度に変えれば、飛び交っているすべてのトークンとキャッシュされたすべての鍵セットを同じ瞬間に無効にすることになります。アップグレードの皮をかぶった、自作自演の障害です。

うまくいったのは、鍵がただ 1 つしかないという前提を捨てることでした。鍵ストアはアルゴリズムに依存しないものになり、RSA の鍵と EC の鍵を同時に保持して、それぞれ固有の鍵 ID とアルゴリズムで両方を JWKS に公開します。別に用意したアクティブ鍵のピッカーが、どの鍵で新しいトークンに署名するかを決め、EC の鍵が存在した瞬間に、自分でレガシーの RSA 鍵から切り替わります。設定フラグも、ローテーションに合わせたデプロイのタイミング調整もありません。重複期間中、ディスカバリーは両方の公開鍵を公開するので、どちらで署名されたトークンも検証され続けます。最後の RS256 トークンが期限切れになったら、ディスカバリーは ES256 だけを公開し、検証は ValidAlgorithms = ES256 に固定されます。これは、検証者を説き伏せて間違った方式を受け入れさせようとするアルゴリズム混同攻撃の扉も閉ざします。この移行は、誰かがスイッチを入れるものではなく、発行者が自分自身に対して行うクロスフェードです。

教訓を抽出すると

署名鍵は定数のように見えます。1 つの秘密を 1 度設定して、永遠に参照するもの。私たちの鍵はそうではありませんでした。その生涯で、保管場所をプロセスから KMS へと変え、種族を RSA から楕円曲線へと変えました。どちらの引っ越しも、トークンが飛び交い、私たちの所有していないものを検証者がキャッシュしている中で行う必要がありました。どちらの引っ越しも乗り切れたのは、同じ 1 つの性質のおかげでした。システムが、鍵も、アルゴリズムも、置き場所も、ちょうど 1 つだと決めつけていなかったことです。複数の鍵を保持でき、どの鍵を持っているかを正直に公開する鍵ストアを作れば、ローテーションは、鍵の置き場所のものであれ鍵の種類のものであれ、予定を組んで迎える障害ではなくなり、発行者が自分で管理する性質になります。

認証を運用しているなら、トークンに署名するものは、あなたが所有する中で最も退屈で、最も検査しやすく、最も賢くないオブジェクトであるべきです。私たちの鍵は、そこに至るまでに 3 つの人生を要しました。そのどれにも、それだけの価値がありました。

署名鍵が最初から退屈で、検査しやすく、代わりにローテーションされていてほしいなら、それが Authagonal の仕事です。あなたの鍵に 4 つ目の人生は必要ありません。