← All posts

トークン検証のたびにオリジンに届いていた。今、JWKS はエッジにある

Authagonal·July 20, 2026
authoidcjwkscdncloudflarecachingkey-rotation

私たちの JWT を 1 つ検証するために、サービスは発行者から 2 つの公開ドキュメントを取得します。/.well-known/openid-configuration にあるディスカバリードキュメントと、それが指し示す JWKS、つまりトークンの署名に使われる公開鍵のセットです。これらは私たちが配信するものの中で最もリクエストが多く、最も秘密性の低いものです。公開鍵は定義上公開されているものですし、メタデータが変わるのは鍵をローテーションしたときだけです。それなのについ最近まで、こうした取得はすべてオリジンまで届いていました。しかも私たちはマルチテナントなので、実態はこの一文から想像されるよりひどいものでした。

オリジンは、する理由のない仕事をしていた

テナントはそれぞれが独立した発行者で、独自の .well-known ドキュメントと独自の JWKS を持っています。そして、トークンを検証するすべてのリライングパーティ、すべてのリソースサーバー、すべての SDK が、これらのドキュメントを取得します。コールドスタート時、自前の短いキャッシュが期限切れになったとき、サービスのインスタンスごとに 1 回ずつ。テナントごとの発行者の数、サービスごとの検証者の数、キャッシュミスの回数を掛け合わせると、リクエストの洪水になります。そのすべてがアプリケーションで終端し、そのすべてが、どの呼び出し元にとってもバイト単位で同一で、鍵をローテーションしたときにしか変わらないドキュメントのためのものでした。

これは、キャッシュすべきものの教科書どおりのプロファイルです。公開されていて、同一で、めったに変わらない。それなのにアプリは、ほかの誰かのトークン検証のホットパス上で、公開鍵を動的にレンダリングしていました。鍵をリクエストごとに計算する理由はどこにもありませんでした。

エッジに置く

変更そのものは小さなものです。ディスカバリーと JWKS のレスポンスに正直な Cache-Control ヘッダーを付け、Cloudflare がエッジでキャッシュするようにします。これで検証者は最寄りの Cloudflare の拠点(PoP)にアクセスし、オリジンが各ドキュメントを配信するのは、検証 1 回ごとではなく、おおむね PoP ごと・TTL ごとに 1 回になります。ディスカバリーはほとんど変わらないので、キャッシュするのは簡単です。よく考えなければならないのは JWKS のほうです。JWKS は、鍵をローテーションしたまさにその時 に変わることこそが唯一の役割であるドキュメントであり、変わるその一瞬にこそ新鮮でなければならないものをキャッシュするのは、人が痛い目を見る典型的な場面だからです。

キャッシュされた JWKS が牙をむくとき

鍵のローテーションとキャッシュされた鍵セットの組み合わせは罠であり、しかも考えうる最悪の方向に失敗します。新しい署名鍵にローテーションしてそれでトークンを発行し始めると、新しい鍵が現れる 前 に JWKS を取得した検証者は、古いコピーを持ったままです。新しい鍵の ID を持つトークンが届き、検証者はそれを探しても見つからず、トークンを拒否します。トークンは完全に有効です。署名も本物です。ユーザーは何も間違ったことをしていません。それなのに、あなた自身のエッジキャッシュが、正当なログインに 401 を返したのです。

どちらの方向に失敗するかに注目してください。古い 秘密 鍵は何の問題にもなりません。単に新しい鍵をまだ使い始めていないだけです。古い 公開 鍵セットは自ら招いた障害であり、その原因となったキャッシュは、オリジンへのトラフィックを減らすためにあなたが意図的に導入したものです。この仕組み全体の安全性は、ローテーションにかかっています。

ローテーションに強いパターン

安全性はすべて順序にあり、その順序はアトミックな入れ替えとは正反対です。ルールは 3 つです:

  • 署名する前に公開する。 新しい鍵はまず JWKS に入れ、新しい鍵 ID を含むその JWKS がエッジで少なくとも TTL 1 回分まるごと公開されるまで、その鍵では 1 つのトークンにも署名しません。新しい鍵を持つトークンが検証者に届きうる時点では、検証者がキャッシュしている鍵セットにはすでにその鍵が含まれています。
  • ローテーション時ではなく、有効期限切れの後に退役させる。 古い鍵は、それが署名した最後のトークンが期限切れになるまで JWKS に公開したままにします。重なり合う期間中、新旧の鍵は共存します。ローテーションした瞬間に古い鍵を外すと、その鍵が署名したまだ有効なトークンがすべて取り残されます。
  • TTL は重なり合う期間より短くする。 エッジキャッシュの max-age にクロックスキューのための余裕を足したものが、鍵が重なり合う期間より短くなければなりません。キャッシュは古くなってもかまいません。ただし、両方の鍵が有効な期間 より長く 古いままでいることは決して許されません。この 1 つの不等式こそが、積極的にキャッシュした JWKS を安全にするものです。

まとめると、ローテーションは決まった進行順を持つクロスフェードになります。新しい鍵を追加し、エッジとすべての検証者がそれを認識するまで TTL 1 回分待ち、その鍵で署名を始め、古いトークンが期限切れになるのを待ち、それから古い鍵を外します。どのステップも TTL 1 回分遅れたキャッシュに対して安全です。TTL は、キャッシュが遅れうるどの期間よりも短くなるように選ばれているからです。

教訓を抜き出すと

キャッシュは通常、レイテンシの判断です。公開鍵のキャッシュは正しさの判断です。キャッシュしているものが、どのトークンが本物かを決めるものだからです。エッジに置くことはまったく問題ありませんし、公開されていてアクセスが集中するものなので、むしろそうすべきです。ただしそれは、ローテーションを入れ替えではなく順序付きの重なりとして表現し、キャッシュの TTL がその重なりより短いことを証明できるようになってからです。そこを正しくやれば、認証システムで最もアクセスが多く最もキャッシュしやすいドキュメントがオリジンに触れなくなり、その違いには誰も気づきません。まさにそれが狙いです。

決して古くならずにオリジンから切り離された JWKS と、振り付けを考える必要のないローテーションも、Authagonal を使えば自分で運用しなくて済むものの一部です。私たちは重なり合う期間と TTL の歩調を合わせ続けるので、鍵が変わるたびにも、あなたのトークンは途切れることなく検証され続けます。