信頼性が高く(そして高速な)ディレクトリ同期の構築
Building reliable (and fast) directory sync (firezone.dev)
要約
この記事では、IDプロバイダーからアプリケーションへユーザーやグループ情報を同期する「ディレクトリ同期」の複雑さについて解説しています。SCIM標準の概要と、各IDプロバイダーの実装のばらつきによる課題を詳述し、Firezone社が独自エンジンの開発を選択した理由を説明しています。
全文翻訳
信頼性が高く(そして高速な!)ディレクトリ同期の構築
“Who’s your User?”
— Master Control Program, TRON (1982)
ユーザーIDがアプリケーションにとって重要であるなら、それを管理する方法が必要です。通常、これはユーザーアカウントを意味し、サインアップ時に作成されます。
しかし、従業員が思いつくままにSaaSアプリにサインアップできるようにすると、管理は悪夢となります。そのため、組織はアプリケーション内に存在する(または存在しない)ユーザーを制御する方法を求めています。
それはサインインできるユーザーを制御しますが、何ができるかはどうでしょうか?
そのためには、ロール、またはグループが必要です。これらは、ユーザーと同様に、組織のIDプロバイダー(Entra、Google、Oktaなど)から提供されます。グループはFirezoneのアクセスモデルの基盤を形成します。誰が何にアクセスできるかを決定します。
ユーザーとグループをアプリケーションに取り込むプロセスはディレクトリ同期と呼ばれ、これをうまく実装するのは驚くほど難しいことです。この記事では、ディレクトリ同期とは何か、それを実装するための主要な標準、そしてなぜ私たちがそれを完全に無視して独自のエンジンをゼロから構築することを選択したのかを説明します。
ディレクトリ同期:やさしい入門
組織のディレクトリとは、そこに誰がいて、何にアクセスできるかのリストです。これはIDプロバイダーにあり、3つの要素で構成されます。
- ユーザー: 組織内の人々。それぞれに名前、メールアドレス、アクティブまたは一時停止などのステータスがあります。
- グループ:
EngineeringやProductのような、ユーザーの名前付きコレクション。グループを使用すると、一度に多くの人にアクセス権を付与できます。 - メンバー: 誰が何に属しているか。グループのメンバーは、ユーザーまたは別のグループです。ユーザーのアクセス権は、直接的または他のグループを介して、そのユーザーが属するすべてのグループから得られます。
ディレクトリ同期とは、そのディレクトリをアプリケーションにコピーし、最新の状態に保つプロセスです。IDプロバイダーが真実の源であるため、アプリケーションが保持しているのはコピーです。時間の経過とともに、そのコピーは3種類の変更を拾う必要があります。新しいユーザーとグループ、名前変更のような更新、そして削除です。誰かが参加、離職、またはチーム変更をした場合、理想的にはアプリケーションはすぐにそれを知る必要があります。
ディレクトリ同期が何でないかを明確にしておく価値があります。それはシングルサインオン(SSO)ではありません。これは明白に思えるかもしれませんが、多くの人がこの2つを混同しています。OpenID Connectのような主要な認証標準は、アプリケーションにユーザーを取り込む方法については何も述べていません。ディレクトリ同期では、ユーザー(およびグループ)を取り込むメカニズムについて正確に言及していますが、それらがどのように認証されるかについては言及していません(その点については、この記事を参照してください)。
簡単な例
組織に以下のディレクトリがあるとします。
[図: ネストされたグループを持つ例のディレクトリ]
アプリケーションのデータベースでは、次のようになっているかもしれません。
[図: データベーステーブルとしての例のディレクトリ]
「BobはProductグループのメンバーか?」のような一般的なアクセスに関する質問に答えるには、Productのメンバー、次にそこにあるグループのメンバー、そしてさらにそのグループのメンバーをたどってBobを見つける必要があります。
それを避けるために、グループをフラット化できます。これにより、各ユーザーは、直接的か間接的かを問わず、所属するすべてのグループの行を持つようになります。
[図: フラット化されたメンバーシップを持つ例のディレクトリ]
これで、同じ質問は簡単なルックアップになります。
さて、これがデータモデルです。次に、これをIDプロバイダーからデータベースに取得し、最新の状態に保つ必要があります。
SCIM
もちろん、すべてを自分で発明する必要はありません。このディレクトリ同期を行うための標準があります。それはSCIMと呼ばれ、その説明は次のとおりです。
System for Cross-domain Identity Management (SCIM) 仕様は、標準化されたサービスを通じて、マルチドメインシナリオでのID管理をより簡単にサポートするためのHTTPベースのプロトコルです。
実際には、これはあなたのアプリケーション内に次のようなRESTエンドポイントのリストを構築することを意味します。
GET /Users
GET /Users/{id}
POST /Users
PUT /Users/{id}
PATCH /Users/{id}
DELETE /Users/{id}
GET /Groups
GET /Groups/{id}
POST /Groups
PUT /Groups/{id}
PATCH /Groups/{id}
DELETE /Groups/{id}
そして、IDプロバイダーがそれらを呼び出してディレクトリを同期させます。
[図: SCIMの約束 - 4つのIDプロバイダーが1つのSCIM APIにリクエストを送信]
SCIMの約束:複数のプロバイダーを同期するための単一のAPI
SCIMの良い点は、IDプロバイダーが変更をアプリケーションにプッシュすることなので、プロバイダーで更新が発生してからアプリケーションに反映されるまでの遅延時間を、スケジュールでプロバイダーをポーリングするプルベースのアプローチよりも大幅に短縮できることです。
紙の上では素晴らしいように聞こえます。しかし、ここでの問題は何でしょうか?
まず、アプリケーションはほぼ常にディレクトリ更新を受信できるように稼働している必要があります。数秒間ダウンしたり過負荷になったりすると、重要なディレクトリ更新を見逃す可能性があります。アプリケーションからフル同期をトリガーすることはできないため、IDプロバイダーが再度通知するまで、それらの更新を失います。
しかし、SCIMのより迷惑な点は、プロトコル(つまり、ワイヤフォーマット)を標準化するのに優れている一方で、それらのエンドポイントがどのように呼び出されるべきか、プロバイダーでのライフサイクルイベントにマッピングされるか、あるいは各リクエストに含まれるデータの種類についても何も述べていないことです。
IDプロバイダーは、SCIMの実装方法において、それぞれ大きく異なります。以下に例を挙げます。
- グループメンバーシップの更新: Oktaは
PATCHリクエストで追加と削除を同時に送信できますが、Entraはそれらを分割して送信する必要があり、1回のPATCHで1人のメンバーの削除しか許可しません。 - 同じプロバイダー内でも基本的な型が異なる: Entraは歴史的に`active: