金色の配線パターンが広がる基板の接写
現場の実践

MinIOとオブジェクトストレージ移行でテナント情報漏洩が起きる仕組み

目次を見る

マルチテナント型のSaaSでファイルアップロード機能を持っている方に向けた内容です。
自社でMinIO(S3互換APIを持つオープンソースのオブジェクトストレージ)を運用している、あるいはこれから導入を検討している場合の落とし穴を整理しました。

オブジェクトストレージの移行や選定というと、容量単価や転送費用の比較に目が行きがちです。
ですが実際に障害報告で深刻なのは「別のテナントのファイルが見えた」という事象です。
これはストレージ製品の良し悪しではなく、その手前のアプリケーション設計で起きる問題です。

何が起きるか:テナント境界の崩壊

マルチテナント構成では、1つのバケット(オブジェクトを格納する箱)を複数の顧客で共有することがよくあります。
このとき、アップロードされたファイルのキー(S3でいうオブジェクトパス)をどう組み立てるかが境界線になります。

起きる事象は単純です。
テナントAのユーザーがアップロードしたファイルに対して、テナントBのユーザーが発行した署名付きURL(一定時間だけ有効なダウンロードリンク)が通ってしまう、というものです。

この種の障害は「アップロード失敗」のような分かりやすいエラーでは出てきません。
アプリケーションから見れば処理は正常に成功しているため、監視アラートには一切引っかからないまま進行します。
気づくのはたいてい、顧客からの問い合わせか、監査ログを後から精査したときです。

影響範囲も読みにくいのが厄介な点です。
一度キー設計に不備があると、過去にアップロードされた全ファイルが潜在的な漏洩対象になります。
単発のバグ修正では終わらず、既存データの棚卸しが必要になるケースもあります。

なぜ起きるか:原因を3段階に分解する

段階1: オブジェクトキーの決定権がクライアント側にある

一番多い原因は、アップロード先のバケット名やキーをブラウザ側(フロントエンド)から渡させている設計です。
リクエストに含まれる値をそのまま信用してキーを組み立てると、悪意がなくてもバグや改ざんで他テナントの領域に書き込める余地が生まれます。

本来は、認証済みのアプリケーションコンテキスト(ログイン済みユーザーの所属テナント情報)からサーバー側がキーを機械的に生成するべきです。
クライアントが指定するのはファイル名程度にとどめ、パスの構造はサーバーの責任にします。

段階2: 署名付きURL発行時にテナント検証をしていない

キー設計が正しくても、ダウンロード用の署名付きURLを発行する際に「このリクエスト元のテナントが、このオブジェクトの所有テナントと一致するか」を確認していないと、やはり境界は破られます。

MinIOやS3互換APIでは、署名付きURLの発行自体はSDKが簡単にやってくれます。
そのため、認可チェックのロジックを自前で挟み込む工程がうっかり抜け落ちやすい箇所です。

段階3: 監視設計がストレージ層の指標しか見ていない

ここが運用監視の観点で特に見落とされがちな部分です。
アップロード成功率やエラー率、ストレージの空き容量といった指標だけを監視していても、テナント境界の崩壊は検知できません。

必要なのは、認可拒否の発生件数、テナントごとのオブジェクト読み取り回数、キー構築時の検証失敗件数、そして署名付きURL発行数と認可成功数の比率です。
これらをアプリケーションログに構造化して残し、テナントIDとリクエストIDを紐づけておく必要があります。

ファイル名や中身といった機微情報はログに残さず、追跡用のIDだけを通す設計が望ましいところです。

自分のプロジェクトが該当するか確認する

以下の観点で、現状の実装を点検してみてください。

  • アップロードAPIのリクエストボディやクエリパラメータに、バケット名やオブジェクトキーの全体が含まれていないか(サーバー側コードでリクエストの受け取り部分を確認)
  • 署名付きURL発行処理の直前に、テナントIDの一致チェックが明示的に書かれているか(grepなどでpresignやGetObject呼び出し周辺のコードを検索)
  • アプリケーションログにtenant_idとrequest_idの両方が記録されているか
  • 監視ダッシュボードに「認可拒否数」や「テナント別アクセス数」の項目があるか、それとも転送量やエラー率だけか
# MinIOのバケットポリシーを確認する例
mc admin policy list myminio
mc admin policy info myminio <policy-name>
# アプリケーションログにテナントIDが記録されているか簡易確認
grep -c "tenant_id" /var/log/app/upload.log

これらのコマンドで該当する記述がヒットしない、あるいはポリシーが全テナント共通の緩い設定になっている場合は、次の対策手順に進む価値があります。

対策の手順

1. キー生成をサーバー側に一元化する

クライアントからはファイル名のみを受け取り、テナントID・ユーザーID・UUIDを組み合わせた形式でサーバーがオブジェクトキーを機械的に組み立てる処理に変更します。
クライアント由来のパス文字列をそのままキーに使う実装がないか、コードレビューで洗い出します。

2. 署名付きURL発行前の認可チェックを明示的な関数に切り出す

「リクエスト元のテナント」と「オブジェクトの所有テナント」を照合する処理を、再利用可能な単一の関数にまとめます。
発行箇所が複数ある場合、チェックの実装が箇所ごとに微妙に違っている、という状態を防ぐためです。

3. 監視指標にテナント境界系のメトリクスを追加する

認可拒否数、テナント別オブジェクト読み取り数、キー構築検証の失敗数を既存の監視基盤(PrometheusやDatadogなど)に追加します。
まずは可視化だけでも進める価値があります。

4. アラートのしきい値設計を分ける

単発の認可拒否は正常な業務操作で起こり得ます。
デプロイ直後に拒否件数が急増するような「クラスター状の増加」を検知対象にし、個別の拒否1件ごとにページング(オンコール担当者への呼び出し)する設計は避けます。

誤報が続くと、オンコール担当者は本物の兆候も無視するようになります。
しきい値とサンプリング方法は、導入後にチューニングする前提で設計しておくと現実的です。

5. ストレージ製品の選定は境界設計の後で検討する

MinIOを自己運用するか、DigitalOcean Spacesのようなマネージドサービスに乗せるかは、運用チームの体制次第で変わる判断です。
MinIOは容量計画・アップグレード・バックアップ・障害復旧をすべて自分たちで持つことになります。
マネージドサービスはその運用負荷をプロバイダに移せますが、転送費用のパターンやリージョン要件、コンプライアンス要件は個別に確認が必要です。

いずれを選んでも、テナント境界の設計ミスは解決しません。
ストレージ製品の選定よりも先に、境界設計と監視設計を固める順序が安全です。

まとめ

テナント分離の障害は、ストレージ製品の性能問題ではなく境界設計の問題として起きます。
点検すべきは次の3点です。

  • オブジェクトキーをクライアント任せにせず、サーバー側で機械的に生成しているか
  • 署名付きURL発行前にテナント照合のチェックが入っているか
  • 監視指標に認可拒否数やテナント別アクセス数が含まれているか

まずはgrepでログとコードの該当箇所を洗い出し、監視ダッシュボードに認可拒否系のメトリクスが存在するか確認するところから始めてみてください。
ストレージ製品の乗り換え検討は、その後でも遅くありません。

参考

MinIO vs DigitalOcean Spaces for Tenant-Isolated File Uploads: Operational Trade-offs

AI 駆動開発のご相談は forva AI へ。

まずはお気軽にどうぞ。