SSRF

どのようなものか

SSRFはserver-side request
forgeryの略で、サーバーにURLを渡し、そのサーバーがいるネットワーク上
の位置から、代わりに内容を取得させる攻撃です。Common
Weakness
Enumerationは、これをCWE-918として分類しています。その説明は、コード
が何を確認していないかに着目しています。上流のコンポーネントからURL
を受け取り、そのURLが指すものを取得する一方で、リクエストが本来の宛
先へ向かっていることを確かめない、という欠陥です。攻撃者はサーバーの
コードを一切変更しません。攻撃者が渡すのはアドレスだけで、あとはサー
バーのネットワーク上の位置を利用します。

その位置こそが、この攻撃の要点です。データセンターやクラウドアカウン
ト内のサーバーは、通常、インターネット上の訪問者には届かないものへ到
達できます。内部アドレスだけで待ち受ける管理画面、データベースのポー
ト、監視ダッシュボード、メタデータサービスなどです。CWEの項目は、そ
の結果を具体的に示しています。サーバーが攻撃者のプロキシとなり、内部
ネットワーク上のホストのポートを走査させられます。また、`file://`、
`gopher://`、`tftp://`などのURLスキームを使うと、マシン自体の文書を
読んだり、リクエストの内容を攻撃者がより細かく制御したりできます。
CWEは、SSRFを、より広い弱点であるCWE-441の下に位置付けています。これ
は、権限を持つコンポーネントが、権限のない相手のために働く、意図しな
いプロキシ、または「混乱した代理人」の問題です。

入り口を作るのは、たいてい普通の機能です。OWASPの防止策チートシート
は、典型例を二つ挙げています。利用者が入力したURLからアプリがダウン
ロードするアバター画像と、後からアプリに呼び出させるため、利用者が登
録するWebhookやコールバックのURLです。リンクのプレビューやURLから取
り込むボタンも、同じ仲間です。他者が書いたアドレスをサーバーがたどる
機能なら、どれも該当します。CWEの項目名ではServer-Side
Request Forgeryと大文字を交えて表記され、同じ攻撃の古い呼び名とし
て、Cross Site Port
Attackの略であるXSPAも掲載されています。

なぜ重要なのか

OWASPがSSRFをTop
10のA10として追加したのは2021年ですが、発生件数の多さが理由ではあり
ません。データ上の発生率は比較的低かった一方、コミュニティー調査では
最も多く選ばれ、悪用のしやすさと影響の評価も平均を上回っていました。
OWASPは、URLの取得がウェブアプリの日常的な機能になり、クラウドサービ
スや複雑なアーキテクチャーが結果をより深刻にしていると説明していま
す。2025年版では、SSRFは独立した分類ではなくなりました。CWE-918は、
最上位の分類であるA01:2025のBroken
Access
Controlで、代表的な弱点の一つに挙げられています。MITREの順位も同じ方
向を示しています。CWE-918は、2021年から2025年まで毎年、CWE
Top 25 Most Dangerous Software Weaknessesに入っています。

理由は、SSRFが、チームの頼りにする主要な防御をそのまま通り抜けること
にあります。OWASPは、アプリがファイアウォール、VPN、ネットワークアク
セス制御リストの背後にあっても、リクエストはその内側から出るため攻撃
が成立すると強調しています。その攻撃例をたどると、境界の内側に何があ
るかが分かります。接続の結果や所要時間から内部ホストや開いているポー
トを調べ、`file:///etc/passwd`などのローカルファイルを読み、
`http://localhost:28017/`などの内部サービスと通信します。そのサービ
スをさらに悪用し、リモートコード実行やサービス拒否にまで至る場合があ
ります。

クラウドのメタデータが絡むと、単なる厄介事がセキュリティ侵害に発展し
ます。OWASPによると、多くのクラウド事業者は、インスタンスのメタデー
タを`http://169.254.169.254/`で提供しています。このアドレスは、IANA
の特殊用途レジストリーでリンクローカルとされる169.254.0.0/16の範囲に
あります。Amazon
EC2では、このアドレスにあるインスタンスメタデータサービスから、イン
スタンス上のソフトウェアが、そのインスタンスに付与されたロールのAWS
セキュリティ認証情報も取得します。誰のためにでも任意のURLを取得する
サーバーには、それらを取得するよう要求できてしまいます。

同じパターンの攻撃は、新しい用途にも広がり続けています。CWEの最近の
事例には、任意の画像URLを取得していたLLMツールキットの欠陥が含まれま
す。これは、2026年4月にはすでにポート走査に悪用されていました
（CVE-2026-33626）。別のLLMアプリフレームワークでは、細工した
`Location`ヘッダーによってURL取得機能をローカルアドレスへ向けられま
した（CVE-2024-3095）。利用者のためにウェブを閲覧するエージェント
は、ネットワークの視点では、他者が選んだURLを取得するサーバーです。

実際の活用例

誰かがリンクを貼るとプレビューカードを表示する、`app.example.com`上
のチャットアプリを考えます。ブラウザーがURLをサーバーへ送り、サー
バーがそのページを取得して、タイトルと画像を読みます。

```http
POST /api/link-preview HTTP/1.1
Host: app.example.com
Content-Type: application/json

{"url": "https://news.example.org/2026/10/harbour-reopens"}
```

これが通常の機能です。次に、AWSのドキュメントがインスタンスメタデー
タの一覧取得に使っているURLへ、同じリクエストの宛先を変えます。

```http
POST /api/link-preview HTTP/1.1
Host: app.example.com
Content-Type: application/json

{"url": "http://169.254.169.254/latest/meta-data/"}
```

サーバーがEC2上で動き、古いIMDSv1が引き続き許可されていれば、リクエ
ストはインスタンス内から送信され、メタデータサービスが応答します。プ
レビューのコードが返す内容は、そのまま攻撃者へ届きます。何かが注入さ
れたわけでも、クラッシュしたわけでもありません。サーバーは、作られた
とおりの処理を、違う宛先に対して行ったのです。

宛先の確認は、URLの文字列ではなく、名前解決の後でリクエストが実際に
どこへ向かうかから始めます。Pythonの標準ライブラリーの`ipaddress`モ
ジュールは、IANAの特殊用途レジストリーを使い、アドレスがグローバルか
どうかを分類します。アドレス自体がループバック、プライベート、リンク
ローカル、共有、文書用の範囲に属する場合は除外します。以下のヘルパー
は、その分類を示す例であり、完全なSSRF対策ではありません。実際の導入
では、リクエストを許容されるユニキャスト宛先に限定し、NAT64などのア
ドレス変換も考慮する必要があります。変換ゲートウェイを持つネットワー
クでは、グローバルと分類されたアドレスが、アドレス内に埋め込まれた、
遮断すべきIPv4宛先へ到達する場合があります。このヘルパーが行う分類テ
ストは、次のとおりです。

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

ALLOWED_SCHEMES = {"http", "https"}


def resolve_public(url: str) -> tuple[str, int, list[str]]:
    parts = urlsplit(url)
    if parts.scheme not in ALLOWED_SCHEMES or not parts.hostname:
        raise ValueError("scheme or host not allowed")
    port = parts.port or (443 if parts.scheme == "https" else 80)
    infos = socket.getaddrinfo(parts.hostname, port, type=socket.SOCK_STREAM)
    addresses = sorted({info[4][0] for info in infos})
    for address in addresses:
        if not ipaddress.ip_address(address).is_global:
            raise ValueError(f"{address} is not a public address")
    return parts.hostname, port, addresses
```

名前解決で返るすべてのアドレスが、最初の一つだけでなく、検査を通らな
ければなりません。その後の取得処理は、検証済みアドレスの一つへ接続し
つつ、`Host`ヘッダーでは元のホスト名を送り、TLS証明書の検証にもその
名前を使います。リダイレクトは無効にします。HTTPクライアントにもう一
度名前解決させると、検査が無意味になります。これは、OWASPのチート
シートが、難しいケースであるWebhookに対して説明している構成です。利
用者が宛先を選ぶため、許可リストで事前にすべてを列挙できません。宛先
が分かっている場合は、完全一致のホスト名の許可リストでさらに絞り込め
ます。ただし、チートシートは、解決されたアドレスにも同じ検査が必要だ
と明記しています。

アプリ内の検査は、一つの層にすぎません。フェイルオーバーと配信ログを
備えたメール機能の構築記事では、送信経路にSSRF対策付きクライアントを
使い、タイムアウトを30秒に設定していると記載しています。アプリの背後
でも、OWASPのネットワーク層の助言が当てはまります。外部リソースを取
得するコードを独立したネットワーク区画に置き、ファイアウォールのルー
ルを既定で拒否する形にします。そうすれば、検査に漏れがあっても、その
先の扉は閉じています。

問題が起きるところ

拒否リストとパターン照合。
`127.0.0.1`、`localhost`、`169.254.169.254`を含むURLを拒否するフィル
ターでは、すでに防御が破られています。POSIXの`inet_addr()`は、IPv4ア
ドレスを一つから四つの部分として受け取り、それぞれを十進数、八進数、
十六進数で記述できます。そのルールに従うパーサーにとって、
`2852039166`と`0xa9.0xfe.0xa9.0xfe`は、どちらもメタデータのアドレス
です。CWEには、十進数を想定した検査を八進数と十六進数の表記がすり抜
け、SSRF対策を破った事例が掲載されています（CVE-2016-4029）。OWASPの
Top
10の項目は、「拒否リストや正規表現を使ってSSRFを緩和しないでくださ
い」と明言しています。前述のように、名前解決後のアドレスで判断し、拒
否するものではなく、許可するものを決めます。

一度確認しただけで、後の接続を任せる。
ホスト名を検証した後でHTTPクライアントに再度検索させると、隙間ができ
ます。DNSリバインディングでは、攻撃者が管理するホスト名が、検査時に
は公開アドレスを、接続時には内部アドレスを返します。検証したそのアド
レスへ接続し、再試行やフォールバック接続にも同じポリシーを適用しま
す。OWASPのチートシートも、それらを明示しています。

リダイレクトをたどる。
検証済みのURLが、`http://169.254.169.254/`や`file://`のURLへの転送を
返し、クライアントが確認せずにたどってしまいます。CWEの事例には、
`file://`や`scp://`のURLへのリダイレクトをたどったURLダウンロードラ
イブラリーがあります（CVE-2009-0037）。リダイレクトを無効にするか、
一段ごとに新しいURLとして扱い、検査全体をやり直します。

すべてのスキームを許可する。
`file`、`gopher`、`dict`にも対応するクライアントは、攻撃者へローカル
ファイルを渡したり、内部サービスへ届く内容を、HTTPリクエストよりはる
かに細かく制御させたりします。OWASPのチートシートは、二つ目のリクエ
ストが使えるスキームとして、これらを挙げています。その機能に必要な
ポート上の`http`と`https`だけを許可します。

二つのパーサーが、二つのホストを読む。
OWASPのチートシートは、一つの文字列が異なる二つのホストを指し得るこ
とを示しています。`http://good.example\@bad.example`では、WHATWG
URL
Standardに従うパーサーは、バックスラッシュをスラッシュと同様に扱うた
め、そこでパスが始まり、ホストは`good.example`となります。一方、
Pythonの`urlsplit`は、最後の`@`より前をすべてユーザー情報として扱
い、`bad.example`を返します。検証するコンポーネントと取得するコン
ポーネントが別だと、宛先の解釈が食い違うことがあります。一度だけ解析
し、通過するすべてのパーサーがホストを同じように読めないURLは拒否し
ます。

生の応答を返してしまう。
取得した本文をそのまま呼び出し側へ返すプレビュー用エンドポイントは、
エラーや所要時間から内部を推測するだけだった攻撃を、内容を読める攻撃
へ変えてしまいます。OWASPの助言のとおり、タイトルや画像への参照な
ど、その機能に必要なものだけを返し、生の応答は決して返しません。

IMDSv1を有効にしたままにする。
AWSのドキュメントによると、既定では両バージョンのインスタンスメタ
データサービスを使えます。IMDSv2では、まず`PUT`で`/latest/api/token`
へセッショントークンを要求し、その後は`X-aws-ec2-metadata-token`ヘッ
ダーでそのトークンを送る必要があります。IMDSv2を必須にすると
（`httpTokens=required`）、IMDSv1は使えなくなります。OWASPのチート
シートは、IMDSv2を、SSRFの一部を緩和する多層防御の仕組みと位置付け、
すべてを防ぐものとはしていません。すべてのインスタンスでIMDSv2を必須
にし、それでもアプリの欠陥は修正します。

ネットワークが分割されていない。
取得サービスが、データベース、管理画面、メタデータサービスのすべてへ
到達できると、一つの検査漏れが全面的な影響を持ちます。ネットワークの
区画分け、内部通信を既定で拒否するファイアウォールのルール、許可した
通信と遮断した通信のログという、OWASPのネットワーク層の制御を適用し
ます。そうすれば、探りを入れる通信も見えるようになります。

参考資料

  * CWE-918: Server-Side Request Forgery (SSRF) —
この弱点の項目です。影響、親分類である混乱した代理人の問題、観測され
たCVEを説明しています。

  * OWASP Top 10:2021: A10 Server Side Request Forgery (SSRF) —
分類が追加された理由、ネットワークとアプリの制御、四つの攻撃例を説明
しています。

  * OWASP Cheat Sheet Series: Server Side Request Forgery Prevention
— 許可リスト、検証済みアドレスだけへの接続、パーサー間の解釈の違い、
Webhookのケースを説明しています。

  * OWASP Top 10:2025: A01 Broken Access Control —
2025年版でCWE-918がどこに位置付けられるかを示しています。

  * Amazon EC2: Access instance metadata for an EC2 instance —
IMDSv1とIMDSv2、トークンの要求、IMDSv2が必須かどうかを確認する方法を
説明しています。

  * Python documentation: ipaddress —
`is_global`と、その判断に使うIANAレジストリーを説明しています。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/ssrf/	engineer.company	70
