🛡️ SSRF (Server-Side Request Forgery) 攻撃
攻撃者が指定した宛先へ、サーバーにリクエストを送らせる攻撃
サーバーは、外からは届かない場所 (メタデータサーバー・内部の API・DB) にも届きます。URL を受け取って取りに行く機能があると、攻撃者はサーバーを踏み台にして、そこへ送らせます。
📚 攻撃手順
Section titled “📚 攻撃手順”次の 3 つがそろうと成立します。
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 を呼ぶだけで副作用が起き、応答の時間やエラーの違いから、内部のホストやポートも調べられます
💻 コードで見る: ① の URL はどう取りに行かれるか
② で狙われるサーバーの実装 (FastAPI の例)
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 します。
POST /avatar/import HTTP/1.1Host: api.exampleContent-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) は次のとおりです。
{ "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 の文字列を見ても見抜けません。
サーバーから届く場所は、すべて狙われます。
| 狙われる場所 | 被害 |
|---|---|
| クラウドのメタデータサーバー | サーバーの権限の認証情報を盗まれ、ストレージや DB を読まれる (例: 2019 年の Capital One の情報流出、1 億人超) |
| 内部の API・管理画面 | 認証の無い内部の API を呼ばれ、データを読まれる・消される |
| DB・キャッシュ (Redis など) | gopher:// を扱うクライアント (curl など) だと、任意のコマンドを送られる |
| サーバーのファイル | file:// を扱うクライアント (urllib など) だと、設定ファイルや秘密鍵を読まれる |
| 内部ネットワーク | 応答の時間やエラーの違いから、ホストとポートを調べられる |
| 外部のサイト | サーバーを踏み台にして攻撃される (送り元がサーバーの IP になる) |
ケースごとに、次の対策を組み合わせます。
| ケース | 対策 |
|---|---|
| 送り先が決まっている (連携先の API・決まった CDN の画像など) | 📋 許可リスト + ↪️ リダイレクトを追わない |
| 任意の URL へ送る (Webhook・OGP のプレビュー・URL からの画像の取り込み) | 🌐 名前解決した IP の確認 + ↪️ リダイレクトを追わない |
| 利用者のファイルを受け取るだけ (画像のアップロード) | 🪪 サーバーに URL を取りに行かせない (署名付き URL) |
| どのケースでも | 🙈 応答とエラーをそのまま返さない・🔑 メタデータサーバーのヘッダー必須・🧱 出口をネットワークで絞る |
[MUST] 📋 許可リスト / 決めたホストにだけ送る
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 も弾かれます。
URL の代わりに ID (連携先の名前など) を受け取り、サーバーで URL を組み立てられるなら、さらに確実です。
- ⚠️ ブロックリスト (
169.254.169.254・localhostを弾く) にしないでください。上の表の書き方で破られます - ⚠️ 許可したホストにオープンリダイレクトがあると、そこから内部へ飛ばされます。↪️ リダイレクトを追わない、も実装します
- ⚠️ Next.js の
next/imageも、サーバーが画像を取りに行きます。images.remotePatternsは必要なホストだけにし、hostname: "**"やimages.dangerouslyAllowLocalIP: trueにしません
[MUST] 🌐 名前解決した IP の確認 / 内部の IP なら送らず、確かめた IP に送る
SSRF 以外の対策 (応答の大きさ・時間の上限など) は # ... で省いています。
import asyncioimport ipaddressimport socketfrom 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 で別に弾きます。
上の表の書き方は、名前解決した後の IP で確かめるので弾かれます (http:// はスキームの確認で先に弾かれます)。302 のリダイレクトだけは、次の ↪️ で弾きます。
- ⚠️ スキームは
httpsだけにします。file://・gopher://を扱うクライアントにそのまま渡しません - ⚠️ ネットワークで独自の NAT64 のプレフィックスを使うなら、それも
NAT64と同じように確かめます
[MUST] ↪️ リダイレクトを追わない / 確かめた URL から、内部へ飛ばされないようにする
# httpx2 は既定でリダイレクトを追わない。follow_redirects=True にしないresponse = await fetch_public(url)# 2xx 以外 (Location の無い 3xx も) は使わないif not response.is_success: raise ForbiddenDestinationError(url)// Node.js (Next.js のサーバー) の fetch は、既定でリダイレクトを追うconst response = await fetch(url, { redirect: "error" });- ⚠️
requests・urllibも既定で追います - ⚠️ 追う必要があるときは、リダイレクト先ごとに IP の確認からやり直します
- ⚠️ Node でも、
redirect: "error"だけでは足りません。🌐 と同じ IP の確認と固定が要ります (または、fetch_publicを持つ backend を通して取りに行きます)
[SHOULD] 🙈 応答とエラーをそのまま返さない / 内部の中身や、内部を調べる手がかりを渡さない
# ... 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 秒)。🧱 の出口のプロキシか、取り込みを非同期のジョブにすると消せます
[SHOULD] 🔑 メタデータサーバーにヘッダーを必須にする / URL を渡すだけでは、認証情報を読めなくする
# 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 は守れません。ほかの対策と組み合わせます
[SHOULD] 🧱 出口をネットワークで絞る / アプリの確認をすり抜けても、内部へ届かせない
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 のファイアウォールは、メタデータサーバーへの送信を止めません。権限の無いサービスアカウントで守ります
[WANT] 🪪 (設計) サーバーに URL を取りに行かせない / ファイルは、署名付き URL でストレージへ直接上げさせる
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 へは送りません。
ファイルのアップロードを足すときは、この形にします。
- ⚠️ Webhook や OGP のプレビューのように、外部の URL へ送ること自体が機能なら使えません。🌐 と ↪️ を実装します
詳しくは OWASP の SSRF Prevention Cheat Sheet にまとまっています。