# 🛡️ SSRF (Server-Side Request Forgery) 攻撃
> **攻撃者が指定した宛先へ、サーバーにリクエストを送らせる攻撃**

![SSRF: 攻撃者が渡した URL を、サーバーが内部へ取りに行ってしまう。サーバーは、外からは届かない場所にも届く](ssrf.svg)

サーバーは、外からは届かない場所 (メタデータサーバー・内部の API・DB) にも届きます。URL を受け取って取りに行く機能があると、攻撃者はサーバーを踏み台にして、そこへ送らせます。

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

![SSRF が成立する 3 つの条件: 1. 利用者が送り先を決められる、2. サーバーから内部に届く、3. 送り先を確かめていない。どれか 1 つでも欠ければ成立しない](conditions.svg)

```mermaid
sequenceDiagram
    autonumber
    actor Attacker as 👿 攻撃者
    participant App as 🚀 正規サーバー<br/>api.example
    participant Meta as 🔑 メタデータサーバー<br/>169.254.169.254
    participant Cloud as ☁️ クラウドの API<br/>ストレージなど

    rect rgb(150, 100, 100)
        Note over Attacker,App: 内部を指す URL を渡す
        Attacker->>+App: この URL の画像を取り込んで
        Note right of Attacker: POST /avatar/import<br/>{"url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/app-role"}
    end

    rect rgb(150, 100, 100)
        Note over App,Meta: サーバーが内部へ取りに行く
        App->>+Meta: GET /latest/meta-data/iam/security-credentials/app-role
        Note right of App: 外からは届かないが、サーバーからは届く
        Meta-->>-App: サーバーの認証情報 (AccessKeyId・SecretAccessKey・Token)
        App-->>-Attacker: 取ってきた中身を、そのまま返す
    end

    rect rgb(150, 100, 100)
        Note over Attacker,Cloud: 盗んだ認証情報で、クラウドの API を呼ぶ
        Attacker->>+Cloud: ストレージのデータを読む (🔑 認証情報を付ける)
        Cloud-->>-Attacker: 認証情報が正しい → サーバーの権限 (app-role) で返す
    end
```

 - 攻撃者は内部へ直接送れませんが、正規サーバーが代わりに送るので、ファイアウォールや IP の制限を通ります
 - 応答を返さない機能でも危険です (ブラインド SSRF)。内部の API を呼ぶだけで副作用が起き、応答の時間やエラーの違いから、内部のホストやポートも調べられます

<details><summary>💻 <b>コードで見る: ① の URL はどう取りに行かれるか</b></summary>

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

```python
class ImportAvatar(BaseModel):
    url: str


@app.post("/avatar/import")
async def import_avatar(body: ImportAvatar):
    async with httpx2.AsyncClient() as client:
        response = await client.get(body.url)  # 利用者が渡した URL へ、確かめずに送る
    # 取ってきた中身を、そのまま返す (プレビューのため)
    return Response(response.content, media_type=response.headers.get("content-type"))
```

① で次のリクエストが届くと、② でサーバーは `http://169.254.169.254/...` へ GET します。

```http
POST /avatar/import HTTP/1.1
Host: api.example
Content-Type: application/json

{"url": "http://169.254.169.254/latest/meta-data/iam/security-credentials/app-role"}
```

169.254.169.254 は、クラウド (AWS・GCP・Azure) のメタデータサーバーの IP で、VM やコンテナの中からだけ届きます。サーバーの権限 (IAM ロール・サービスアカウント) の一時的な認証情報を返します。③ の応答 (AWS の IMDSv1) は次のとおりです。

```json
{
  "Code": "Success",
  "LastUpdated": "2026-11-02T00:00:00Z",
  "Type": "AWS-HMAC",
  "AccessKeyId": "ASIA...",
  "SecretAccessKey": "...",
  "Token": "...",
  "Expiration": "2026-11-02T06:00:00Z"
}
```

文字列で `169.254.169.254` や `localhost` を弾いても、同じ宛先を別の書き方で渡されます。

| 渡される URL | 実際の宛先 |
|:--|:--|
| `http://2852039166/` | 169.254.169.254 (10 進数で書いた IP) |
| `http://0xa9fea9fe/` | 169.254.169.254 (16 進数で書いた IP) |
| `http://127.1/` | 127.0.0.1 (省略して書いた IP) |
| `http://[::1]/` | 自分自身 (IPv6 のループバック) |
| `http://meta.evil.example/` | 攻撃者の DNS が 169.254.169.254 を返す |
| `https://evil.example/r` | 302 で `http://169.254.169.254/...` へリダイレクトする (リダイレクトを追うクライアントのとき。httpx2 は既定で追わない) |

DNS とリダイレクトは、送る前に URL の文字列を見ても見抜けません。

</details>

## 💥 被害例
サーバーから届く場所は、すべて狙われます。

| 狙われる場所 | 被害 |
|:--|:--|
| クラウドのメタデータサーバー | サーバーの権限の認証情報を盗まれ、ストレージや DB を読まれる (例: 2019 年の Capital One の情報流出、1 億人超) |
| 内部の API・管理画面 | 認証の無い内部の API を呼ばれ、データを読まれる・消される |
| DB・キャッシュ (Redis など) | `gopher://` を扱うクライアント (curl など) だと、任意のコマンドを送られる |
| サーバーのファイル | `file://` を扱うクライアント (urllib など) だと、設定ファイルや秘密鍵を読まれる |
| 内部ネットワーク | 応答の時間やエラーの違いから、ホストとポートを調べられる |
| 外部のサイト | サーバーを踏み台にして攻撃される (送り元がサーバーの IP になる) |

## 🛡️ 対策
ケースごとに、次の対策を組み合わせます。

| ケース | 対策 |
|:--|:--|
| 送り先が決まっている (連携先の API・決まった CDN の画像など) | 📋 許可リスト + ↪️ リダイレクトを追わない |
| 任意の URL へ送る (Webhook・OGP のプレビュー・URL からの画像の取り込み) | 🌐 名前解決した IP の確認 + ↪️ リダイレクトを追わない |
| 利用者のファイルを受け取るだけ (画像のアップロード) | 🪪 サーバーに URL を取りに行かせない (署名付き URL) |
| どのケースでも | 🙈 応答とエラーをそのまま返さない・🔑 メタデータサーバーのヘッダー必須・🧱 出口をネットワークで絞る |

<details><summary>[MUST] 📋 <b>許可リスト / 決めたホストにだけ送る</b></summary>

```python
from urllib.parse import urlsplit

from fastapi import HTTPException

ALLOWED_HOSTS = {"images.example", "cdn.example"}


def check_allowed(url: str) -> None:
    parts = urlsplit(url)
    # netloc (userinfo・ホスト・ポート) を完全一致で比べる。endswith や in は evil-images.example などで破られる
    if parts.scheme != "https" or parts.netloc.lower() not in ALLOWED_HOSTS:
        raise HTTPException(status_code=400)
```

`https://user@images.example` や `https://images.example:8080` も弾かれます。<br/>
URL の代わりに ID (連携先の名前など) を受け取り、サーバーで URL を組み立てられるなら、さらに確実です。

 - ⚠️ ブロックリスト (`169.254.169.254`・`localhost` を弾く) にしないでください。上の表の書き方で破られます
 - ⚠️ 許可したホストにオープンリダイレクトがあると、そこから内部へ飛ばされます。↪️ リダイレクトを追わない、も実装します
 - ⚠️ Next.js の `next/image` も、サーバーが画像を取りに行きます。`images.remotePatterns` は必要なホストだけにし、`hostname: "**"` や `images.dangerouslyAllowLocalIP: true` にしません

</details>

<details><summary>[MUST] 🌐 <b>名前解決した IP の確認 / 内部の IP なら送らず、確かめた IP に送る</b></summary>

SSRF 以外の対策 (応答の大きさ・時間の上限など) は `# ...` で省いています。

```python
import asyncio
import ipaddress
import socket
from urllib.parse import urlsplit

import httpx2


class ForbiddenDestinationError(Exception):
    pass


# NAT64 は、出口で埋め込まれた IPv4 (内部の IP もありうる) に変換されて届く
NAT64 = ipaddress.ip_network("64:ff9b::/96")
# IPv6 はグローバルユニキャストだけを通す。::a9fe:a9fe (IPv4 互換) など、is_global が True になる形を弾く
GLOBAL_UNICAST = ipaddress.ip_network("2000::/3")


def is_public(ip: ipaddress.IPv4Address | ipaddress.IPv6Address) -> bool:
    if isinstance(ip, ipaddress.IPv6Address):
        if ip in NAT64:
            ip = ipaddress.IPv4Address(int(ip) & 0xFFFFFFFF)
        elif ip not in GLOBAL_UNICAST:
            return False
    return ip.is_global


async def fetch_public(url: str) -> httpx2.Response:
    parts = urlsplit(url)
    host = parts.hostname
    if parts.scheme != "https" or host is None:
        raise ForbiddenDestinationError(url)
    # ... 国際化ドメイン名・末尾のドット・IPv6 のリテラルの扱い (SSRF 以外なので省く)

    # 名前解決し、返ったすべての IP がインターネット上の IP かを確かめる
    infos = await asyncio.get_running_loop().getaddrinfo(host, 443, type=socket.SOCK_STREAM)
    ips = [ipaddress.ip_address(info[4][0]) for info in infos]
    # not ips は念のための備え (all() は空のリストで True になる)
    if not ips or not all(is_public(ip) for ip in ips):
        raise ForbiddenDestinationError(url)

    # 確かめた IP に繋ぐ。ホスト名のまま送ると、もう一度名前解決され、内部の IP を返されうる (DNS リバインディング)
    # URL のポートと userinfo は捨て、443 に繋ぐ
    ip = ips[0]
    pinned = parts._replace(netloc=f"[{ip}]" if ip.version == 6 else str(ip)).geturl()
    # ... 名前解決・応答の時間の上限、応答の大きさ、同時に取りに行く数、圧縮した応答、
    #     繋ぐ IP の選び方 (IPv4 の優先など) (SSRF 以外なので省く)
    async with httpx2.AsyncClient(timeout=5) as client:
        return await client.get(
            pinned,
            headers={"Host": host},
            # 証明書は、IP ではなく元のホスト名で確かめる
            extensions={"sni_hostname": host},
        )
```

`is_global` は、プライベート (10.0.0.0/8 など)・ループバック (127.0.0.0/8・::1)・リンクローカル (169.254.0.0/16) で False になります。NAT64 (`64:ff9b::a9fe:a9fe`) と IPv4 互換 (`::a9fe:a9fe`) は True になるため、`is_public` で別に弾きます。<br/>
上の表の書き方は、名前解決した後の IP で確かめるので弾かれます (`http://` はスキームの確認で先に弾かれます)。302 のリダイレクトだけは、次の ↪️ で弾きます。

 - ⚠️ スキームは `https` だけにします。`file://`・`gopher://` を扱うクライアントにそのまま渡しません
 - ⚠️ ネットワークで独自の NAT64 のプレフィックスを使うなら、それも `NAT64` と同じように確かめます

</details>

<details><summary>[MUST] ↪️ <b>リダイレクトを追わない / 確かめた URL から、内部へ飛ばされないようにする</b></summary>

```python
# httpx2 は既定でリダイレクトを追わない。follow_redirects=True にしない
response = await fetch_public(url)
# 2xx 以外 (Location の無い 3xx も) は使わない
if not response.is_success:
    raise ForbiddenDestinationError(url)
```

```ts
// Node.js (Next.js のサーバー) の fetch は、既定でリダイレクトを追う
const response = await fetch(url, { redirect: "error" });
```

 - ⚠️ `requests`・`urllib` も既定で追います
 - ⚠️ 追う必要があるときは、リダイレクト先ごとに IP の確認からやり直します
 - ⚠️ Node でも、`redirect: "error"` だけでは足りません。🌐 と同じ IP の確認と固定が要ります (または、`fetch_public` を持つ backend を通して取りに行きます)

</details>

<details><summary>[SHOULD] 🙈 <b>応答とエラーをそのまま返さない / 内部の中身や、内部を調べる手がかりを渡さない</b></summary>

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


@app.post("/avatar/import")
async def import_avatar(body: ImportAvatar, user: Annotated[User, Depends(current_user)]):
    try:
        response = await fetch_public(body.url)
    except Exception as error:
        # 失敗の理由 (弾いた・繋がらない・タイムアウト・名前解決できない) で応答を変えない。
        # 変えると、その違いから内部のホストやポートを調べられる
        raise HTTPException(status_code=400, detail="画像を取り込めませんでした") from error
    # 2xx 以外 (リダイレクトの 3xx も) と、画像以外は取り込まない
    content_type = response.headers.get("content-type", "").split(";")[0]
    if not response.is_success or content_type not in {"image/png", "image/jpeg"}:
        raise HTTPException(status_code=400, detail="画像を取り込めませんでした")
    # ... 本文が本当に画像かの確認 (SSRF 以外なので省く)
    avatars.save(user, response.content)
    # 取ってきた中身は返さず、取り込んだことだけを返す
    return {"result": "取り込みました"}
```

メタデータサーバーの応答は画像ではないので取り込まれず、攻撃者にも返りません。

 - ⚠️ 内部へ送ること自体は止まりません (ブラインド SSRF)。画像を返す内部の宛先も守れません。MUST の対策と組み合わせます
 - ⚠️ 応答の時間の違いは残ります (弾くとすぐ、接続のタイムアウトは 5 秒)。🧱 の出口のプロキシか、取り込みを非同期のジョブにすると消せます

</details>

<details><summary>[SHOULD] 🔑 <b>メタデータサーバーにヘッダーを必須にする / URL を渡すだけでは、認証情報を読めなくする</b></summary>

```hcl
# AWS: IMDSv2 を必須にする (先に PUT でトークンを取り、ヘッダーに付けないと読めない)
resource "aws_instance" "app" {
  # ...
  metadata_options {
    http_tokens                 = "required"
    # 1 だと、EC2 の上のコンテナ (Docker の bridge など) からは届かない。コンテナのアプリが使うなら 2 にする
    http_put_response_hop_limit = 1
  }
}
```

GCP (Cloud Run など) のメタデータサーバーは、`Metadata-Flavor: Google` ヘッダーが無いと応答しないので、URL を渡すだけでは読めません。

 - ⚠️ 利用者がヘッダーを決められる機能 (Webhook に付けるヘッダーの設定など) があると破られます
 - ⚠️ 内部の API や DB は守れません。ほかの対策と組み合わせます

</details>

<details><summary>[SHOULD] 🧱 <b>出口をネットワークで絞る / アプリの確認をすり抜けても、内部へ届かせない</b></summary>

```mermaid
flowchart LR
  api["🚀 api<br/>権限あり"] -->|取りに行く URL| fetcher["📥 fetcher<br/>権限なし"]
  fetcher --> proxy["🧱 出口のプロキシ<br/>内部の IP を止める"]
  proxy --> internet["🌐 インターネット"]
  proxy -.-x internal["🔒 内部の API・DB"]
```

 - URL を取りに行く処理を、別のサービス (fetcher) に分けます。fetcher のサービスアカウントにはロールを付けず、認証情報を盗まれても何もできないようにします
 - fetcher の出口をプロキシ (例: Stripe の Smokescreen) かファイアウォールに通し、内部の IP への送信を止めます
 - ⚠️ GCP の VPC のファイアウォールは、メタデータサーバーへの送信を止めません。権限の無いサービスアカウントで守ります

</details>

<details><summary>[WANT] 🪪 <b>(設計) サーバーに URL を取りに行かせない / ファイルは、署名付き URL でストレージへ直接上げさせる</b></summary>

```mermaid
sequenceDiagram
    actor User as 🥸 利用者
    participant App as 🚀 正規サーバー
    participant GCS as 🪣 Cloud Storage

    User->>App: 画像を上げたい
    App-->>User: 署名付き URL (5 分だけ、その利用者の画像の置き場に PUT できる)
    User->>GCS: PUT 署名付き URL (画像の本文)
```

サーバーは署名付き URL (期限付きの書き込み先) を発行するだけで、利用者の URL へは送りません。<br/>
ファイルのアップロードを足すときは、この形にします。

 - ⚠️ Webhook や OGP のプレビューのように、外部の URL へ送ること自体が機能なら使えません。🌐 と ↪️ を実装します

</details>

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