コンテンツにスキップ

🛡️ SSRF (Server-Side Request Forgery) 攻撃

攻撃者が指定した宛先へ、サーバーにリクエストを送らせる攻撃

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

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

次の 3 つがそろうと成立します。

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

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.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) は次のとおりです。

{
"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 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 で別に弾きます。
上の表の書き方は、名前解決した後の 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 にまとまっています。