← All posts

ログインがきっかり 10 秒止まっていた。犯人は自分たちのセキュリティヘッダーでした

Authagonal·July 23, 2026
oidcssocspfrontenddebuggingwar-story

1 週間ほどのあいだ、ポータルを開いた再訪ユーザーは、ログインページが表示されるまで「Loading…」という文字が 10 秒間画面に居座るのを眺めていました。ときどきではありません。だいたいでもありません。毎回きっかり 10 秒で、そのあとはすべて完璧に動きます。初めて訪れたユーザーがそれを目にすることはありませんでした。以前にサインインしたことのある人だけです。

かかる時間がまちまちなバグは、パフォーマンスの問題です。かかる時間が きっかり 10 秒のバグは、自白です。健全な Web リクエストで、所要時間がきれいな 10 のべき乗に丸まることなどありません。その数字は何か実際の処理を積み上げた合計ではなく、タイムアウトの上限です。そしてタイムアウトがあるということは、どこかで何かが、決して届くことのないものを辛抱強く待っているということです。

これは、それが何を待っていたのか、そしてなぜその待ち人が、私たちが誇りにしていたセキュリティヘッダーにせき止められていたのか、という話です。

マウント時にポータルがやっていること

私たちのポータルはシングルページアプリケーションです。読み込まれると、何かを表示する前に、1 つの問いに答えようとします。あなたはすでにサインインしていますか? OIDC でこれを行う礼儀正しい方法は、サイレント チェックです。アプリは ID プロバイダーに「このブラウザにすでにセッションがあるなら、ユーザーの手を煩わせずに新しいトークンをください」と頼みます。私たちのクライアントライブラリ oidc-client-ts はこれを signinSilent() として提供しており、私たちはマウント時に renewSession() ヘルパーからそれを呼んでいました。

このサイレントチェックの実行方法は 2 通りあります。アプリがリフレッシュトークンを持っていれば、ライブラリは UI を一切介さない静かなバックチャネル交換を行い、それでサインイン完了です。リフレッシュトークンを持って いなければ、ライブラリは古い仕組みにフォールバックします。ID プロバイダーの authorize エンドポイントに prompt=none 付きで向けた隠し iframe を開き、その iframe が結果をポストバックしてくるのを待つのです。iframe の存在意義は、見えないことにあります。ユーザーがそれを目にすることは決してないはずで、健全な構成なら実際に目にすることはありません。数ミリ秒で解決するからです。

私たちの iframe は、いつまでたっても解決しませんでした。

自分たちで築いた壁

iframe は認証ホストを読み込みます。そして認証ホストは、真剣に扱われるべき私たちのホストすべてと同じく、「私をフレームに入れてはならない」と言うことだけが仕事のヘッダーを 2 つ送っています。

  • X-Frame-Options: DENY
  • Content-Security-Policy: frame-ancestors 'none'

これらはクリックジャッキング対策で、正しいものです。あなたのログインページを iframe に埋め込める攻撃者は、それをおとりの下に重ね、無害に見えるものに本物の認証情報を入力するようユーザーをだまして、それを収集できます。frame-ancestors 'none' は、どのオリジンも、私たち自身のオリジンでさえも、このページを埋め込んではならないという現代的な指示です。私たちはこれを意図的に有効にしました。まさにセキュリティレビューが探し、評価する類いのものです。

そのため oidc-client-ts がそのホストに向けて隠し iframe を開いたとき、ブラウザは私たちが指示したとおりのことをしました。ページをフレーム内に描画するのを拒否したのです。そしてここからが残酷なところです。拒否されたフレームは例外を投げません。ライブラリが捕捉できるエラーイベントも、reject される Promise も、コンソールの 1 行もありません。iframe は空っぽのまま、いつまでもそこにあるだけです。ライブラリから見ればまだ何も起きていないので、できることは 1 つしかありません。タイムアウトまで待つことです。そのタイムアウト、デフォルトの silentRequestTimeout が 10 秒でした。

隠し iframe が何もない壁を 10 秒間見つめ、そこでライブラリは諦め、Promise がようやく reject され、アプリは肩をすくめて本物のログインページにリダイレクトし、あとはすべて動きます。この停止は一度も失敗ではありませんでした。見込みのない iframe を経由して遠回りした成功だったのです。

正しいもの 2 つと、悪い継ぎ目 1 つ

これを本当に見えにくくしていたのは、何も壊れていなかったことです。セキュリティヘッダーは正しかった。サイレントリニューのフォールバックも正しく、正当で広く使われている OIDC のパターンです。どのコンポーネントも設計どおりに、そしてどんなレビュアーでも望むとおりに振る舞っていました。10 秒の停止は、どれか 1 つの内部にあったのではありません。それらの あいだ、それぞれが相手について置いていた前提の中にありました。SSO ライブラリは、ID プロバイダーをフレームに入れられると想定していました。ID プロバイダーは、誰にもフレームに入れさせてはならないと想定していました。どちらの前提も擁護できるものです。ただ互いに相容れなかっただけで、その矛盾を含んでいるファイルはどこにもありませんでした。

そもそもなぜ iframe に手を伸ばしたのか

それでも疑問が 1 つ残りました。高速なパス、つまりリフレッシュトークンの交換なら、iframe を完全に飛ばせたはずです。なぜ再訪ユーザーは遅いパスに落ちていたのか。持つべきリフレッシュトークンがなかったからです。そしてリフレッシュトークンがなかったのは、私たち自身のポータルの OAuth クライアントが、AllowOfflineAccess なしでプロビジョニングされていたからでした。クライアントがリフレッシュトークンを発行してもらうことを認可するフラグです。オフラインアクセスがなければリフレッシュトークンはなく、リフレッシュトークンがなければ高速なパスもなく、再訪ユーザーは全員、決して読み込まれることのない iframe へと回されていました。

それが本当の欠陥で、しかもすべてのテナントにまたがるデータの問題であり、一度リリースすれば済む 1 行のコード変更ではありませんでした。そこで修復として、起動時にすべてのテナントのポータルクライアントへ AllowOfflineAccess を再適用するリコンサイルサービスを用意しました。誰も手作業でテナントに触れることなく、次のデプロイでフリート全体が修正されます。リフレッシュトークンは再び流れ始め、高速なパスはひとりでに息を吹き返しました。

修正と教訓

リコンサイルサービスで原因は直りました。しかし、たとえ遅いパスに落ちたとしても、ログインが 10 秒も止まるべきではありません。そこで継ぎ目のほうも堅牢にしました。renewSession() は今では最初に保存済みのユーザーを調べます。手元にリフレッシュトークンがなければ、即座に何も返さずに処理を打ち切り、失敗するとわかっている iframe を飛ばして、ユーザーをまっすぐ対話的なログインに送ります。リフレッシュトークンの高速なパスには手を付けていません。さらに、まだ iframe を開くバックグラウンドのリニューに対する保険として、タイムアウトを 10 秒から 5 秒に縮めました。最悪のケースでも半分で済みます。

私たちが実際に持ち帰った教訓は、この 1 件ではなく、バグの 1 つのカテゴリーに関するものです。停止はバグです。エラーも、例外も、ログの赤い行も出さないとしてもです。それが残す唯一の証拠は経過時間です。そしてその時間がきりのいい数字なら、最適化すべき遅い処理を探しに行ってはいけません。タイムアウトを探しに行き、その向こう側にいる、黙ったまま、永遠に、決して応答しないものを見つけてください。私たちの場合、それは iframe でした。私たちが自らの意思でかんぬきを掛けた扉を、行儀よくノックし続けていたのです。

ロックダウンされた認証ホストとサイレントリニューの iframe は相性が悪いということを、最初から知っているログインフローがほしいなら、それは私たちがすでにぶつかっておいた継ぎ目なので、あなたがぶつかる必要はありません。Authagonal は SSO の配管とセキュリティヘッダーを、一緒にテストされた 1 つのシステムとして提供します。正しい半分が 2 つあって、それらが相容れないことをページ読み込みのたびに 10 秒かけて発見する羽目になる、という形ではなく。