Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】Multi-tenant application: organization-scoped routes in Axum

2026年10月28日に「Dev.to」が公開したITニュース「Multi-tenant application: organization-scoped routes in Axum」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

マルチテナントアプリでは、URLに組織名を組み込み、各リクエストが特定の組織に紐づくよう設計する。これにより、組織間のデータ混同を防ぎ、データベースアクセスや認証、リダイレクトなど、システム全体で厳格なデータ分離と安全性の確保が重要となる。Axumでの実装例や徹底したテストの必要性も指摘している。

ITニュース解説

システムエンジニアを目指す初心者の皆さんにとって、「マルチテナントアプリケーション」という言葉は聞き慣れないかもしれない。これは、一つのアプリケーションシステムを複数の異なる組織や企業で共有して利用できる仕組みのことだ。例えば、同じ営業支援ツールをA社もB社も使っているが、それぞれが見るデータは完全に分離されている、といった状況を想像すると分かりやすいだろう。この仕組みは、アプリケーションの開発コストや運用コストを削減できるというメリットがある。

しかし、このシンプルなアイデアを実現するのは簡単ではない。特に重要なのが「組織の識別子」をどのように管理し、システム全体で一貫して扱うかという点だ。一般的には、URLの中に組織を特定する情報を含める方法が使われる。例えば、acme.example.com のようにサブドメインを使う方法や、example.com/acme/ideas のようにパスの一部として組織名を含める方法がある。今回の記事では、後者のパスパラメータを使う方法、つまり/{org-slug}/ideas のような形式に焦点を当てている。{org-slug}は、組織を一意に識別するための短い名前(スラッグ)のことだ。

この{org-slug}をURLの先頭に置くことで、どの組織からのリクエストであるかを明確にする。例えば、単に/ideas/43とリクエストするのではなく、/featherboard-corp/ideas/43のようにすることで、「Featherboard社内のアイデア番号43」というように、リクエストが特定の組織に紐づいていることが一目でわかるようになる。これは、たとえシステム全体でアイデアのIDが重複しないユニークな値であったとしても重要だ。なぜなら、ユニークなIDだけでは、悪意のあるユーザーが別の組織のIDを指定して情報にアクセスしようとしたり、誤ってアクセスしてしまったりするのを防ぐことはできないからだ。組織の境界をURLで明示的に示すことで、セキュリティとデータ分離の基盤を築くことになる。

しかし、すべてのリクエストでURLから組織情報を抽出し、それを検証するのは手間がかかる作業だ。そこでFeatherboardというアプリケーションでは、「CurrentOrgエクストラクタ」という仕組みを導入している。これは、URLパスから最初のパラメータ({org-slug})を自動的に抽出し、そのスラッグに対応する組織情報をデータベースから検索し、リクエストハンドラ(実際のリクエスト処理を行う関数)に渡してくれるものだ。

具体的なコードの例を見ると、リクエストハンドラの関数定義でcurrent_org: CurrentOrgという形でこの情報を受け取っている。これにより、各ハンドラは組織情報を意識することなく、受け取ったCurrentOrgオブジェクトから簡単に組織IDなどを取得して処理を進めることができる。無効な組織スラッグが指定された場合は、このエクストラクタが自動的に404 Not Foundエラーを返すため、ルーティングロジックが一貫し、ハンドラが不正なリクエストを処理する前に排除できるという利点がある。

このURLとエクストラクタによる組織スコープの管理は非常に重要だが、これだけでは不十分だ。データが複数の組織間で完全に分離されていることを保証するためには、データベースのクエリレベルでも組織スコープを強制する必要がある。例えば、データベースからアイデアを取得する際、記事では次のようなSQLクエリが示されている。

SELECT ... FROM ideas WHERE id = ? AND org_id = ?

注目すべきは、id = ?(特定のアイデアのID)だけでなく、org_id = ?(特定の組織のID)という条件も追加されている点だ。これは、たとえURLのCurrentOrgエクストラクタで組織スラッグが検証済みであっても、データベースアクセス時に再度、そのデータが本当に現在リクエストされている組織に属するものかをチェックしていることを意味する。もしorg_id = ?という条件がなければ、悪意のあるユーザーがCurrentOrgエクストラクタをすり抜けて別の組織のデータにアクセスしようとした場合、それが成功してしまうリスクがある。更新操作(UPDATE)でも同様にorg_idを含めることで、データ破壊のリスクを防ぐ。この二重のチェックが、データ分離の堅牢性を高める鍵となる。

認証に関しても同じ原則が適用される。あるユーザーが特定の組織内で管理者権限を持っているとしても、それはその組織内でのみ有効であり、他の組織の管理者権限を自動的に与えるものではない。そのため、管理者かどうかをチェックする際も、ユーザーIDだけでなく、組織IDも同時に検証するSQLクエリが必要になる。

記事で挙げられている設定画面の例は、このルーティングと組織スコープの重要性をよく示している。Featherboardには/{org-slug}/settings/site(サイト全体の設定)と/{org-slug}/settings/user(ユーザー個別の設定)という二つの設定カテゴリがある。サイト設定は管理者のみがアクセス可能で、ユーザー設定は一般ユーザーもアクセス可能だ。このルーティング構造により、どちらの設定にアクセスしようとしているかがURLから明確になり、ハンドラはリクエストされた組織スコープ内でのアクセス権限だけを考慮すればよい。もし組織プレフィックスがない/settings/user/notificationのようなURLを盲目的に受け入れてしまうと、意図せず別の組織のユーザー設定が変更されてしまったり、リダイレクトによって全く別の組織の設定画面に移動してしまったりする危険性がある。

組織プレフィックスの考慮は、ルーティングやデータベースクエリだけでなく、システム全体にわたる広範な箇所で必要となる。例えば、HTMLのページに表示されるリンク、フォームの送信先URL、ユーザーを別のページに移動させるリダイレクト、システムが送信するメールに含まれるリンク、さらには決済サービス(Stripeなど)との連携、他のサービスからの通知を受け取るウェブフックのURLなど、あらゆる場所で組織識別子を正確に含める必要がある。

これらの箇所は非常に「壊れやすい」と記事は指摘している。なぜなら、例えば誤ったURLを含むHTMLを生成しても、コンパイラはそれをエラーとして検出してくれないからだ。そのため、システムの安定性を確保するには、徹底したテストが不可欠となる。具体的には、ユニットテストで個々のモジュールの動作を検証するだけでなく、実際のAxumルーターやデータベース、セッションストアといった依存関係を使った「統合テスト」が重要になる。これにより、特定の組織のスラッグが正しいハンドラに到達するか、悪意のあるリクエストが他の組織の設定を改ざんできないか、リダイレクトが組織パスを正しく保持するか、といった、より複雑なシナリオでの動作を検証できる。

マルチテナントの設計には、パスベースのルーティング以外にも、acme.example.comのようなサブドメインモデルや、セッショントークンを通じてテナントを解決する方法など、複数の選択肢がある。Featherboardではパスベースモデルを採用しているが、その理由はホスティングが非常に簡単で、ワイルドカードDNS設定や複雑なリバースプロキシ設定が不要になるためだ。しかし、そのトレードオフとして、すべてのURLに組織スラッグのプレフィックスを含める必要があるというデメリットもある。

この記事から学ぶべき最も重要な教訓は、一度組織識別子をURLパスに含める設計を選択した場合、それは単なるURLの構造だけでなく、リクエストを処理するハンドラのコンテキスト、データベースの設計、認証チェック、入力値の検証、リダイレクトの挙動、HTMLテンプレートの生成など、システムを構成する非常に多くの側面に影響を及ぼし、それらすべてで組織スコープを適切に管理する必要があるということだ。データ分離とセキュリティを確保するためには、システム全体で一貫した意識と実装が求められるのである。

関連コンテンツ

関連IT用語