マルチテナントSaaS:データ分離と代理店の権限階層
要点: マルチテナントのシステムがもっとも恐れる事故は、テナントAにテナントBのデータが見えることです。共有データベースにテナント列を持たせる方式は、多くのB2B SaaSにとって妥当な出発点ですが、テナントの絞り込みを各開発者の記憶に頼らないことが前提です。テナントコンテキストは認証時にだけ決め、データアクセス層が絞り込み条件を一律に付与し、データベースの行レベルセキュリティで二重に守ります。プラットフォーム・代理店・サブアカウントの階層は明示的にモデル化し、権限のテストは機能テストより先に書きます。
1.0 3つの分離方式
| 方式 | 利点 | 代償 | 向いている場面 |
|---|---|---|---|
| テナントごとにデータベース | 分離がもっとも強い。テナント単位でバックアップ、移行、復元ができる | マイグレーションをN回実行する。接続数と運用負荷がテナント数とともに増える | テナントが少ない、または契約で物理分離が求められる |
| 共有データベース、テナントごとにスキーマ | 分離が強い | スキーマが増えるとマイグレーションと監視が複雑になる | テナント数が中程度 |
| 共有テーブル+テナント列 | 運用がもっとも簡単。テナント横断の集計も容易 | 分離はコードとデータベースのポリシーに完全に依存する | テナントが多く、1テナントあたりのデータは控えめ |
組み合わせることもできます。大口顧客は専用データベース、それ以外は共有。ただし、テナントのデータがどこにあるかをデータアクセス層が隠し、業務コードが意識しなくて済むことが前提です。
2.0 テナントコンテキストはどこから来るか
テナントIDは認証結果、つまりトークン内のクレームかサーバー側のセッションからのみ取得します。リクエストパラメーターや、クライアントが自由に設定できるヘッダーから取ってはいけません。リクエストごとにミドルウェアがテナント、ロール、データ範囲を決めてリクエストコンテキストに置き、以降のコードはそこからだけ読みます。
バックグラウンドジョブやメッセージのコンシューマーにもテナントコンテキストが必要で、ここがもっとも漏れやすい箇所です。定期ジョブにはリクエストもミドルウェアもなく、うっかりするとテーブル全体を処理してしまいます。私たちは、どのテナントを処理するかを各ジョブに明示させ、宣言のないジョブは動かさないようにしています。
3.0 絞り込みを各自の注意力に頼らない
- ORM層でテナント条件を一括で付与します。グローバルフィルターかリポジトリの基底クラスで実装し、業務コードは既定で他テナントのデータに触れられず、テナントをまたぐ場合は明示が必要です。
- PostgreSQLなら行レベルセキュリティ(RLS)を第二の防御線にできます。手書きのSQLが条件を書き忘れても、データベースが拒否します。コネクションプール使用時のセッション変数の設定とリセットには注意が必要で、怠ると前のリクエストのテナントが次のリクエストに漏れます。
- 本当にテナントをまたぐ操作(プラットフォームの運用レポートやデータ修復など)は、専用のロールとコード経路を通し、監査ログを残します。
- 一意制約とインデックスにはテナント列を含めます。そうしないと、2つのテナントが同じ番号を使ったときに衝突します。
4.0 代理店の階層
多くの製品はテナントが平たく並ぶのではなく、プラットフォーム、代理店、サブアカウントまたはエンドユーザーという階層になっています。よく機能するやり方は次のとおりです。
- 組織の関係はツリーとして保存し、代理店には自分のサブツリー内のデータを見せます。サブツリーの取得は閉包テーブルか経路列挙(マテリアライズドパス)を使い、リクエストのたびに再帰クエリを投げません。
- ロールとデータ範囲は分けてモデル化します。ロールはどの操作ができるか、範囲はどの組織に対してできるかを決めます。組み合わせごとに新しいロールを作ると、ロール表はすぐに手に負えなくなります。
- 階層ごとにフロントエンドが分かれることはよくあります(プラットフォームの管理画面、代理店の管理画面、サブアカウント向けのモバイル画面など)が、バックエンドの権限モデルは1つです。ボタンを隠すことは権限制御ではなく、APIが呼び出しのたびに確認します。
5.0 最初に書くべきテスト
- 権限マトリクス:ロールと階層ごとに、自分の、同列の、上位のデータへのアクセスと期待結果を表にして自動実行する。
- ID差し替え:リクエスト内のリソースIDを他テナントのものに替え、APIが「権限なし」か「存在しない」を返し、決してデータを返さないことを確認する。
- バックグラウンドジョブ:複数テナントのデータが混在する状態でジョブを動かし、想定したテナントだけを処理したことを確認する。
これらのテストは機能テストより先に書く価値があります。機能の不具合は使い勝手の問題ですが、権限の不具合は事故です。
新しいSaaSの管理システムを作る場合や、既存システムにテナント分離を加える場合は、Web・クラウド・デバイス管理をご覧いただくか、プロジェクトのご相談からご連絡ください。
参考資料
- PostgreSQL、行セキュリティポリシー:https://www.postgresql.org/docs/current/ddl-rowsecurity.html
- OWASP、Authorization Cheat Sheet:https://cheatsheetseries.owasp.org/cheatsheets/Authorization_Cheat_Sheet.html
よくあるご質問
最初は共有テーブルで始めます。後から大口顧客だけ専用データベースにできますか?
鍵になるのは、データアクセス層が最初からテナント単位でルーティングしているかどうかです。あちこちで同じ接続を直接使っていなければ、テナントの切り出しはデータのエクスポート、ルーティングの切り替え、結果の確認で済みます。コストの大半はリハーサルです。
行レベルセキュリティでクエリは遅くなりますか?
ポリシーは実質的に各クエリへの追加条件なので、コストはその条件がインデックスを使えるかで決まります。複合インデックスの先頭にテナント列を置けば、多くの場合影響は小さく済みます。思い込まずに、本番に近いデータ量で実行計画を確認してから判断します。
代理店同士でデータを共有できますか?
明示的な権限付与としてモデル化します。ある組織が特定の種類のデータを別の組織に付与し、その付与は記録され、取り消せます。既定では何も共有せず、階層の副作用で他社のデータが見えることがないようにします。
サブアカウントの担当者が退職したら、データは誰のものですか?
データは個人のアカウントではなく組織に帰属します。アカウントを無効にしてもデータは元の組織に残り、上位の担当者が割り当て直します。これはモデル設計の時点で決めておくべきで、後から変えると多くのテーブルに影響します。