多数のテナントに対応する BFF と、Cookie を持たずに届く唯一のリクエスト
シングルページアプリは、自分のトークンを自分で持つように教えられてきました。アプリはブラウザ内で OAuth フローを実行し、アクセストークンと、たいていはリフレッシュトークンも受け取り、それを JavaScript のどこかに保持して、すべての API 呼び出しに付けて送ります。ドキュメントも十分にあり、ほとんどのチュートリアルが示すのもこの方法です。そしてこれは、最も寿命の長い認証情報を、守りようのない唯一の場所に置くことでもあります。ページに紛れ込んだものなら何でも喜んで実行してしまうランタイムです。インジェクションが一度でも成功すれば、あるいはビルドのどこかにある依存パッケージが 1 つでも侵害されれば、誰かをフィッシングする必要すらありません。トークンを読み取って立ち去るだけで、そのトークンは期限切れになるまで使えます。
Backend for Frontend パターンは、この認証情報を手の届かない場所へ移します。ブラウザはアプリ専用の小さなサーバーと通信し、そのサーバーが Confidential な OAuth クライアントになります。コード交換を行い、アクセストークンとリフレッシュトークンを保持し、ブラウザには不透明な Cookie しか渡しません。本記事は私たちがそれをどう作ったか、そして本当に面白かった唯一の部分、つまり複数のテナントに対応させる話です。
ブラウザの手元に残るもの
__Host-agbff という名前の Cookie が 1 つ。HttpOnly、SameSite=Lax で、パスはサイト全体、有効期限なしなのでブラウザセッションが終われば消えます。値は 256 ビットの乱数で、それ以外には何もありません。トークンではないのでデコードしても何も出てきませんし、TLS 上の __Host- Cookie を通信経路から盗むことはできません。
実体はすべてサーバー側、分散キャッシュ上のセッションレコードにあります。アクセストークン、リフレッシュトークン、ID トークン、アクセストークンの有効期限、そしてそのセッションがどのテナントに属するか。ログイン自体は PKCE 付きのごく普通の認可コードフローで、トークンエンドポイントに対してシークレットで認証する Confidential クライアントが実行します。戻ってきた ID トークンはきちんと検証します。issuer、audience、公開鍵に対する署名、有効期間、そしてリダイレクト前に保存しておいた値と nonce の定数時間比較です。これらをすべて通過して初めてセッションが作られ、Cookie がセットされます。
存在だけを確認するヘッダー
ブラウザは自分のユーザー情報を取得するときや、プロキシ経由の API に到達するときに BFF を呼び出します。これらの呼び出しには x-authagonal-bff というカスタムヘッダーが付きます。値は関係ありません。存在すること自体がチェックのすべてです。
手抜きに見えますが、そうではありません。クロスサイトリクエストフォージェリという攻撃の類型は、別のオリジンから発生させられるフォーム送信、画像タグ、ナビゲーションに Cookie が相乗りすることに依存しています。そしてこのどれもカスタムヘッダーを設定できません。攻撃側の JavaScript がヘッダーを追加しようとした瞬間、それは単純なリクエストではなくなり、プリフライトが必要なリクエストになって、CORS ポリシーに拒否されます。このヘッダーは推測されるべき秘密ではありません。リクエストがマークアップではなくコードから来たことの証明です。
このヘッダーはスクリプトからの呼び出しには必須とし、本質的にトップレベルナビゲーションであるものには意図的に要求しません。ログインの開始、ID プロバイダーからの戻り、ログアウトリンクへの遷移です。ブラウザのナビゲーションにカスタムヘッダーを要求しても、ナビゲーションが壊れるだけです。
リフレッシュはきっちり 1 回
プロキシされるリクエストはどれも、アクセストークンの期限切れが近いことに気づく可能性があり、忙しいページは複数のリクエストを同時に送ります。素朴に全部でリフレッシュすると、ちょっとした惨事になります。ローテーションするリフレッシュトークンで複数のリフレッシュが同時に走り、互いを無効にし合い、最後にはユーザーが自分自身のトラフィックによってログアウトさせられます。
そこでリフレッシュはセッションごとにシングルフライトにしています。最初のリクエストがセッション ID をキーにしたゲートを取り、他のリクエストは待ちます。微妙なのは、待っていたリクエストが中に入ったときの振る舞いです。何かを判断する前にストアからセッションを読み直します。先にゲートを持っていたリクエストがすでにリフレッシュを済ませている可能性が高く、待ち始めたときに持っていた値は古くなっているからです。リフレッシュは 1 回、その結果を全員が使います。
ローテーションへの対応も、地味ですが必要な意味で行っています。トークンエンドポイントが新しいリフレッシュトークンを返せば、保存済みのものを置き換えます。リフレッシュがトークンエラーで失敗したら、セッションを削除してユーザーをログアウトさせます。一度拒否されたリフレッシュトークンが次の試行で受け入れられることはなく、リトライはログアウトまでの時間を引き延ばすだけだからです。
1 つの BFF、多数のテナント
シングルテナントの BFF は、起動時に設定からすべてを解決します。authority が 1 つ、クライアント ID が 1 つ、シークレットが 1 つ。1 つのデプロイで多数のテナントを捌こうとするとこれが成り立ちません。BFF はログインがどの issuer に属するのかを判断しなければならず、しかもそれをセッションが存在する前に行う必要があるからです。
テナントの選択はログインエンドポイントで、名前を自由に決められるクエリパラメーターを通じて行います。?slug= でも ?org= でも、プロダクトが既に顧客を呼んでいる名前で構いません。リゾルバーがそのキーをテナント設定(authority、クライアント ID、シークレット、スコープ)に変換します。何にも解決されなければ、ログインはその場で拒否されます。
次に、このキーは自分のことを何も知らない ID プロバイダーへの往復を生き延びて、戻ってこなければなりません。保持できるセッションはまだないので、キーは相関 Cookie に載せます。PKCE の verifier、state、nonce をまさにこの目的で運んでいる、短命な暗号化 Cookie です。有効期間は 15 分、ログイン試行ごとに 1 つ。戻ってきたら Cookie を復号し、中のキーから改めてテナントを解決し、そのテナントのトークンエンドポイントに対してコードを交換します。そこで初めてテナントキーがセッションに書き込まれ、以後はそれが永続的な答えになります。
この時点から、リフレッシュ、ログアウト、プロキシのすべての経路は、ブラウザが何を言ったかではなく、セッションから再解決します。そしてテナントが削除や無効化によって解決できなくなった場合は、どこかのデフォルトテナントに黙ってフォールバックするのではなく、セッションを破棄します。解決できないテナントはログアウトであって、肩をすくめて流すものではありません。
Cookie を持たずに届くリクエスト
この設計が真価を発揮するのはバックチャネルログアウトです。どこか別の場所でセッションが終了すると、ID プロバイダーはログアウトトークンをサーバーに直接 POST してきます。Cookie はありません。セッションもありません。ブラウザはまったく関与しません。シングルテナントの BFF なら何の問題もありません。送ってくる可能性のある issuer は 1 つしかないからです。マルチテナントの場合は「これは本物か?」に答える前に「これはどのテナント宛てか?」に答えなければならず、使える材料はトークンそのものだけです。そしてそのトークンはまだ検証しておらず、したがって信頼できません。
これを安全にする順序は、正確に述べておく価値があります。未検証のトークンから issuer クレームを読み取り、それをただ 1 つの用途、つまりどのテナントの設定を読み込むかの選択にだけ使います。そのうえで、トークンの署名をそのテナントの公開鍵で、audience をそのテナントのクライアント ID で検証します。偽造された issuer は、なりすまそうとしているテナントを選ぶことになり、そのテナントの鍵による検証で失敗します。攻撃者はその鍵を持っていないからです。信頼できないクレームを根拠に何かが受け入れられることは一度もありません。そのクレームが決めたのは誰が判定するかだけで、判定者は私たちが元から持っていたトラストアンカーです。
その後に、ログアウトトークンをログアウトトークンたらしめるチェックが続きます。誰も認証しないので nonce を含んではならないこと。バックチャネルログアウトのイベントを含むこと。特定のセッションかサブジェクトのどちらかを識別していること。セッション ID なら 1 つのセッションを終了させます。サブジェクトならそのユーザーのすべてのセッションを終了させます。私たちが発行するのは後者の形式です。「すべての場所からログアウト」をクリックした人が実際に意図しているのは、まさに全部からのログアウトだからです。セッションストアが Cookie の値だけでなく、セッション ID とサブジェクトのそれぞれでインデックスを持っているのはこのためです。
シングルテナントは退屈なまま
よくあるケースでは、これらはすべて何もしません。デフォルトのリゾルバーは渡されたキーに関係なく同じ設定を返し、issuer による解決も無条件にその設定を返します。設定は 1 つしかないからです。シングルテナントの BFF は、この差し込み口ができる前とまったく同じように動きます。テナントパラメーターもなく、Cookie に余計なものもなく、新しい障害モードもありません。マルチテナントの仕組みはオプトインで、クエリパラメーターに名前を付けるまで見えません。
選択と信頼を分離する
何かをマルチテナント化するときにやる価値のある作業は、すべてのエントリーポイントを列挙し、それぞれで何がテナントを識別するのかを問うことです。ブラウザのナビゲーションは、こちらが発行して管理している Cookie を持ってきます。リダイレクトのコールバックは、こちらが署名した state を持ってきます。サーバー間のコールバックが持ってくるのは呼び出し元が送ることにしたものだけで、その呼び出し元は嘘をついているかもしれません。
厄介なエントリーポイント、つまり信頼できるものが何も載っていないエントリーポイントこそが、システム全体が健全かどうかを決める設計箇所であり、たいていは終盤になるまで誰も考えていない場所です。私たちを切り抜けさせたパターンは一般化できます。選択と信頼を分離することです。ルーティングが、最終判断を下してよいトラストアンカーを選ぶことだけに使われ、最終判断が攻撃者には偽造できないものによって下されるのであれば、信頼できないデータに基づいてルーティングしても構いません。
これを全部自分で書きたくないなら、Authagonal は .NET 向けと Node 向けの BFF を提供しており、ポータルからは BFF に必要な Confidential クライアントを、リダイレクト URI からバックチャネルログアウトのエンドポイントまで含めて、ワンクリックでプロビジョニングできます。