マルチテナントSaaS:データ分離と代理店の権限階層

要点: マルチテナントのシステムがもっとも恐れる事故は、テナントAにテナントBのデータが見えることです。共有データベースにテナント列を持たせる方式は、多くのB2B SaaSにとって妥当な出発点ですが、テナントの絞り込みを各開発者の記憶に頼らないことが前提です。テナントコンテキストは認証時にだけ決め、データアクセス層が絞り込み条件を一律に付与し、データベースの行レベルセキュリティで二重に守ります。プラットフォーム・代理店・サブアカウントの階層は明示的にモデル化し、権限のテストは機能テストより先に書きます。

マルチテナントの図。上段はリクエスト経路で、トークンまたはセッションを持つリクエストが認証ミドルウェアを通ってテナント、ロール、範囲が決まり、データアクセス層がテナント条件を一括付与し、データベースが行レベルセキュリティで強制します。テナントIDは認証結果からのみ取得します。下段は組織ツリーで、プラットフォーム運営者の下に代理店が2つ、そのうち1つの代理店の下にサブアカウントが2つあり、破線でその代理店が見える範囲を示しています。
図1. リクエスト経路と組織ツリー。代理店に見えるのは自分のサブツリーだけで、それ以上でも以下でもありません。

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・クラウド・デバイス管理をご覧いただくか、プロジェクトのご相談からご連絡ください。

参考資料

よくあるご質問

最初は共有テーブルで始めます。後から大口顧客だけ専用データベースにできますか?

鍵になるのは、データアクセス層が最初からテナント単位でルーティングしているかどうかです。あちこちで同じ接続を直接使っていなければ、テナントの切り出しはデータのエクスポート、ルーティングの切り替え、結果の確認で済みます。コストの大半はリハーサルです。

行レベルセキュリティでクエリは遅くなりますか?

ポリシーは実質的に各クエリへの追加条件なので、コストはその条件がインデックスを使えるかで決まります。複合インデックスの先頭にテナント列を置けば、多くの場合影響は小さく済みます。思い込まずに、本番に近いデータ量で実行計画を確認してから判断します。

代理店同士でデータを共有できますか?

明示的な権限付与としてモデル化します。ある組織が特定の種類のデータを別の組織に付与し、その付与は記録され、取り消せます。既定では何も共有せず、階層の副作用で他社のデータが見えることがないようにします。

サブアカウントの担当者が退職したら、データは誰のものですか?

データは個人のアカウントではなく組織に帰属します。アカウントを無効にしてもデータは元の組織に残り、上位の担当者が割り当て直します。これはモデル設計の時点で決めておくべきで、後から変えると多くのテーブルに影響します。