# 🔓 IDOR (Insecure Direct Object Reference)
> **リクエストの ID を書き換えるだけで、他人のデータを読み書きできてしまう脆弱性**

![IDOR: 正規にログインした A 社の利用者が、URL の請求書の ID を 124 に書き換えるだけで、B 社の請求書を受け取る。サーバーはログインしているかだけを確かめ、その請求書の持ち主かを確かめていない](idor.svg)

ログインの確認 (認証) は「誰か」を確かめるだけです。アクセス制御 (認可) は「その人が、そのデータや操作に触ってよいか」を確かめます。認可が抜けていると、攻撃者は正規の利用者のまま、ID を書き換えるだけで他人のデータに届きます。<br/>
OWASP Top 10:2025 の 1 位 (A01 アクセス制御の不備) に入る攻撃です。同じ A01 の [権限昇格](../PrivilegeEscalation/README.md)・[パストラバーサル](../PathTraversal/README.md)・[CORS の設定ミス](../CORS/README.md)・[CSRF](../CSRF/README.md)・[SSRF](../SSRF/README.md) は、それぞれの資料にまとめています。

## 📚 攻撃手順
次の 3 つがそろうと成立します。

![IDOR が成立する 3 つの条件: 1. 利用者が対象を ID で指定する、2. 他人の ID を知っている、3. サーバーが触ってよいかを確かめない。どれか 1 つでも欠ければ成立しない](conditions.svg)

2 は、ID を推測しにくくしても防ぎ切れません。ID は共有リンク・画面・ログ・ほかの API の応答から漏れます。確実に欠けさせられるのは 3 です。

```mermaid
sequenceDiagram
    autonumber
    actor Attacker as 👿 攻撃者<br/>A 社の利用者
    participant App as 🚀 正規サーバー<br/>api.example
    participant DB as 🐘 DB<br/>請求書のテーブル

    rect rgb(150, 150, 150)
        Note over Attacker,App: ふだんは、自分の請求書を /invoices/123 で開く
    end

    rect rgb(150, 100, 100)
        Note over Attacker,App: ID を書き換えて送る
        Attacker->>+App: GET /invoices/124
        Note right of Attacker: Authorization: Bearer 🔑 (A のトークン)<br/>トークンは本物なので、ログインの確認は通る
        App->>+DB: SELECT * FROM invoices WHERE id = 124
        Note right of App: 持ち主 (会社) の条件が無い
        DB-->>-App: B 社の請求書
        App-->>-Attacker: 200 OK (B 社の請求書: 金額・請求先・振込先)
    end

    rect rgb(150, 100, 100)
        Note over Attacker,App: 連番で、全社の請求書を集める
        loop id = 1, 2, 3, ...
            Attacker->>App: GET /invoices/{id}
            App-->>Attacker: 他社の請求書
        end
    end
```

 - トークンは本物なので、ログインの確認 (認証) は通ります。止められるのは、「この請求書に触ってよいか」の確認 (認可) だけです
 - 読むだけでなく、書き込みにも起きます。`PATCH /invoices/124`・`DELETE /invoices/124` で、他社の請求書を書き換えられる・消されます
 - 一般の利用者が、管理者だけの API を呼ぶのは、別の攻撃の権限昇格です ([権限昇格の資料](../PrivilegeEscalation/README.md))
 - 一覧・検索・件数・エクスポートでも漏れます。詳細の API だけ直しても、`GET /invoices?q=...` や CSV の出力に他社の行が混ざります
 - ID を UUID にしても防げません。共有リンク・ログ・通知・ほかの API の応答から ID が漏れれば、同じように届きます

<details><summary>💻 <b>コードで見る: ① の ID はどう通ってしまうか</b></summary>

② で狙われるサーバーの実装 (FastAPI の例)

```python
# ... import と、User・current_user・get_session・Invoice・InvoiceJson の定義 (省く)


@app.get("/invoices/{invoice_id}")
def get_invoice(
    invoice_id: int,
    user: Annotated[User, Depends(current_user)],  # ログインしているかは確かめる (認証)
    session: Annotated[Session, Depends(get_session)],
) -> InvoiceJson:
    invoice = session.get(Invoice, invoice_id)  # ID だけで取り、持ち主を確かめない (認可が無い)
    if invoice is None:
        raise HTTPException(status_code=404)
    return InvoiceJson.model_validate(invoice, from_attributes=True)
```

① で次のリクエストが届くと、② で ID が 124 の請求書を、どの会社のものかを見ずに取ります。

```http
GET /invoices/124 HTTP/1.1
Host: api.example
Authorization: Bearer <A のトークン>
```

`current_user` はトークンが本物かを確かめ、A 社の利用者を返します。`user` を受け取っていても、使わなければ認可にはなりません。

ID を書き換える場所は、URL のパスだけではありません。

| 場所 | 例 |
|:--|:--|
| URL のパス | `GET /invoices/124` |
| クエリ | `GET /invoices/export?customer_id=88` で、他社の顧客の請求書を CSV で出す |
| 本文 | `POST /comments` に `{"post_id": 124}` を送り、他社の投稿にコメントする |
| ヘッダー | `X-Tenant-Id: b-corp` を送り、ヘッダーのテナントを信じるサーバーに他社として扱わせる |

</details>

## 💥 被害例
認可が抜けた API は、ID を書き換えるだけで、他人のデータを読み書きさせます。

| 狙われる場所 | 被害 |
|:--|:--|
| 詳細・取得の API | 連番で全件を集められる (例: 2019 年の First American Financial。URL の連番を変えるだけで、口座番号などを含む不動産取引の書類、約 8 億 8,500 万件を読めた) |
| 更新・削除の API | 他人のデータを書き換えられる・消される |
| 一覧・検索・エクスポート | 他のテナントの行が混ざり、まとめて漏れる |
| ファイル・添付のダウンロード | 他社の契約書や請求書の PDF を落とされる |

## 🛡️ 対策
ケースごとに、次の対策を組み合わせます。MUST は必ず、SHOULD は当てはまらない理由が無い限り、WANT は必要なときに実装します。

| ケース | 対策 |
|:--|:--|
| ID でデータを取る・変える・消す | 🔎 持ち主・テナントで絞る |
| 一覧・検索・件数・エクスポート | 🔎 持ち主・テナントで絞る |
| どのケースでも | 🧪 認可のテスト |
| ID が漏れにくくしたい | 🎲 推測しにくい ID |
| アプリの絞り忘れも止めたい (設計) | 🛡️ DB でも絞る |

<details><summary>[MUST] 🔎 <b>持ち主・テナントで絞る / ID だけで取らず、取るクエリの条件に持ち主を入れる</b></summary>

```python
from sqlalchemy import select

# ... ほかの import と定義 (省く)


@app.get("/invoices/{invoice_id}")
def get_invoice(
    invoice_id: int,
    user: Annotated[User, Depends(current_user)],
    session: Annotated[Session, Depends(get_session)],
) -> InvoiceJson:
    # テナントの条件を、取るクエリそのものに入れる。取ってから比べる形だと、比べ忘れた API から漏れる
    invoice = session.scalar(
        select(Invoice).where(Invoice.id == invoice_id, Invoice.tenant_id == user.tenant_id)
    )
    # 他社の請求書も、無い請求書と同じ 404 にする。403 にすると、その ID の請求書があることを教えてしまう
    if invoice is None:
        raise HTTPException(status_code=404)
    return InvoiceJson.model_validate(invoice, from_attributes=True)
```

① は、B 社の請求書が条件に合わないので 404 になります。<br/>
`user.tenant_id` は、確かめたトークン (またはサーバーのセッション) から取ります。URL・本文・クエリ・ヘッダーで送られた `tenant_id` は書き換えられます。

 - ⚠️ 一覧・検索・件数・エクスポートも、同じ条件で絞ります
 - ⚠️ 更新・削除も `WHERE id = :id AND tenant_id = :tenant_id` で絞り、当たった行が 0 件なら 404 にします
 - ⚠️ 子のリソース (`/invoices/123/items/9`) は、親が自分のものかに加えて、子がその親に属するか (`InvoiceItem.invoice_id == 123`) も確かめます
 - ⚠️ URL にテナントを入れる設計 (`/{tenant_id}/projects/...`) なら、そのテナントに所属しているかを入口で確かめます。所属していなければ 404 (テナントがあることを伏せる)、所属していて権限が無ければ 403 を返します

</details>

<details><summary>[SHOULD] 🧪 <b>認可のテスト / 他社の ID で拒否されることを、テストで確かめる</b></summary>

```python
# ... import と、fixture (client・login_as)・テストデータを作る関数 (create_invoice) の定義 (省く)


def test_他社の請求書は404(client: TestClient, login_as: LoginAs) -> None:
    invoice_id = create_invoice(tenant="b-corp")
    response = client.get(f"/invoices/{invoice_id}", headers=login_as("a-corp", Role.MEMBER))
    assert response.status_code == 404


def test_他社の請求書は消せない(client: TestClient, login_as: LoginAs) -> None:
    invoice_id = create_invoice(tenant="b-corp")
    response = client.delete(f"/invoices/{invoice_id}", headers=login_as("a-corp", Role.MEMBER))
    assert response.status_code == 404
    # 404 を返しても消していないかを、B 社として確かめる
    assert client.get(f"/invoices/{invoice_id}", headers=login_as("b-corp", Role.MEMBER)).status_code == 200
```

認可の穴は、自分のデータを操作するふだんのテストでは見つかりません。他社の ID で拒否される側もテストします。ロールごとに許す操作のテストは、[権限昇格の資料](../PrivilegeEscalation/README.md) にあります。

 - ⚠️ 他社の ID は、詳細・更新・削除・一覧のすべての API で試します

</details>

<details><summary>[WANT] 🎲 <b>推測しにくい ID / UUID は 🔎 の補助にすぎない</b></summary>

```python
import uuid

from sqlalchemy.orm import Mapped, mapped_column


class Invoice(Base):
    __tablename__ = "invoices"

    # 連番の代わりに、推測できない ID にする
    id: Mapped[uuid.UUID] = mapped_column(primary_key=True, default=uuid.uuid4)
```

連番を順に試す攻撃 (⑤ の連番集め) を防ぎます。連番だと、件数 (売上や利用者の数) も外から分かります。

 - ⚠️ ID は共有リンク・ログ・通知・ほかの API の応答から漏れます。🔎 の代わりにはなりません
 - ⚠️ `uuid.uuid7` (Python 3.14) は、作った時刻が ID から分かります

</details>

<details><summary>[WANT] 🛡️ <b>(設計) DB でも絞る / PostgreSQL の Row Level Security で、他社の行を返さない</b></summary>

```sql
-- マイグレーション: 入れたテナントの行だけを見せる
ALTER TABLE invoices ENABLE ROW LEVEL SECURITY;
CREATE POLICY tenant_isolation ON invoices
  USING (tenant_id = current_setting('app.tenant_id')::uuid);
```

```python
# リクエストのトランザクションの始めに、トークンから取ったテナントを入れる。
# 第 3 引数の true で、トランザクションが終わると消える (接続プールで、次のリクエストに残らない)
session.execute(
    text("SELECT set_config('app.tenant_id', :tenant_id, true)"),
    {"tenant_id": str(user.tenant_id)},
)
```

アプリが 🔎 の条件を書き忘れても、DB が他社の行を返しません。テナントを入れ忘れると、クエリがエラーになり、行は返りません (未設定なら `current_setting` が、接続を使い回して空文字 (`''`) が残っていれば `::uuid` の変換がエラーになる)。<br/>
USING だけを書くと、INSERT・UPDATE の新しい行にも同じ条件が効きます (他社の `tenant_id` では書き込めない)。<br/>
テーブルの所有者 (マイグレーションを流すロール) と、アプリが繋ぐロールを分け、どちらにも BYPASSRLS を付けないと、アプリの接続にポリシーが効きます。

 - ⚠️ テーブルの所有者 (`FORCE ROW LEVEL SECURITY` が無いとき)・スーパーユーザー・BYPASSRLS のロールには効きません
 - ⚠️ `set_config(..., true)` は、トランザクションが終わると消えます。リクエストの途中で `commit` すると、その後のクエリはテナントが空になってエラーになります。トランザクションが始まるたびに入れ直します (SQLAlchemy の `after_begin` イベントなど)
 - ⚠️ テナントの中の持ち主 (利用者ごと) やロールの確認は、アプリで行います。🔎 と、ロールの確認 ([権限昇格の資料](../PrivilegeEscalation/README.md)) の代わりではありません

</details>

詳しくは [OWASP の IDOR Prevention Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Insecure_Direct_Object_Reference_Prevention_Cheat_Sheet.html) と [Authorization Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Authorization_Cheat_Sheet.html) にまとまっています。
