0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

SSRFはURL検査だけでは防げない――JavaのリダイレクトとDNSの抜け道

0
Posted at

SSRFはURL検査だけでは防げない――JavaのリダイレクトとDNSの抜け道

SSRFは「https://で始まるか」の検査では防げない。検証をすり抜けるのは、リダイレクト・DNS・IP表記の3つの抜け道である。守るべきものはURLの文字列ではなく、解決したIPと、リダイレクトの各ホップと、送るクライアントの既定値である。接続先を固定できるなら画像IDだけを受け取るのが最も強い。固定できない場合の実装をJavaで示す。

OWASP実務セキュリティ学習の2026年11月3日のSSRFレッスンで扱った「URLを自由に決めさせない」設計が入口で、ここではその先、固定できない場合に何が残るかを扱う。Mass Assignmentの記事と同じく、OWASPのチートシートを起点に、Javaの実装に落としたときの壊れ方まで行く。

レッスンの問題コードはどこが危ないのか

2026年11月3日のOWASP実務セキュリティ学習で出た問題コードは、プロフィール画像の取り込みAPIだった。

public byte[] download(String imageUrl) {
    return restClient.get().uri(URI.create(imageUrl)) ...
}

このメソッド自体が必ず脆弱というわけではない。危ないのは、imageUrl が自由な利用者入力で、接続先の検証がない点である。レッスンでは「https://」だけの確認では不十分だと説明された。HTTPSでも社内サーバーへは接続できるし、DNS解決で想定外のIPへ接続する可能性もある。

レッスンの結論は、接続先を固定することだった。画像の取得元が固定サービスなら、URL全体ではなく画像IDだけを受け取る。

RestClient restClient = RestClient.builder()
        .baseUrl("https://images.example.com")
        .build();

public byte[] getImage(long imageId) {
    return restClient.get().uri("/images/{id}", imageId) ...
}

利用者は画像IDだけを指定でき、ホストはアプリが決める。これが最も強い対策で、OWASPも「信頼できる限られた接続先」と「任意の外部が必要な場合」を分けて考える。WebhookやコールバックURLのように、接続先を固定できない機能では、後者の対策が必要になる。この記事は後者を扱う。

1件のリクエストが1億600万件につながった

SSRFが実システムでどう壊れるかを示す事例が、2019年のCapital Oneである。攻撃者はサーバーにURLを1件渡し、サーバーがそのURLを取りに行く仕組みを悪用した。渡された先は、AWSのインスタンスメタデータサービス http://169.254.169.254/latest/meta-data/iam/security-credentials/ だった。

このアドレスはリンクローカルで、インスタンス自身のネットワークスタックの中にだけ存在する。認証なしで一時的なIAM認証情報(AccessKeyId、SecretAccessKey、Token)を返す。SSRFでサーバーにこのURLを踏ませると、サーバー自身のクラウド認証情報が攻撃者の手に渡る。Capital Oneでは、その認証情報で700超のS3バケットに到達し、約30GBが2019年3月22日から23日の2日間で抜かれた。漏れたのは約1億600万件のクレジットカード申込記録(米国約1億件、カナダ約600万件)で、OCC(米通貨監督庁)は2020年8月6日に8000万ドルの民事制裁金を科した。AWSは2019年11月19日にIMDSv2を公開し、メタデータの読み取りにPUTによるセッショントークンを必須にした。

数字の読み方に注意が要る。30GBを2日で抜く速度は平均で約0.18MB/秒とゆっくりで、4か月間気づかれなかった一因になっている。速い攻撃ではなく、目立たない攻撃だった。SSRFの被害は、1件のリクエストが通るかどうかではなく、その先にある認証情報の権限の広さで決まる。

抜け道1:検証済みのURLがリダイレクトで内部へ

最初の抜け道はリダイレクトである。https://images.example.com/a.png を検証して通したあと、サーバーが302で http://169.254.169.254/... へ転送する。クライアントが自動で追随すれば、検証は最初のURLにしかかかっていないのに、実際に届くのは内部である。

ここでJavaのクライアントごとの既定値が分かれる。

クライアント リダイレクトの既定値 出典
java.net.http.HttpClient(Java 11以降) Redirect.NEVER(追随しない) Javadocに「default value is NEVER」と明記
java.net.HttpURLConnection 追随する(followRedirects = true) OpenJDKソースに private static boolean followRedirects = true; とある
RestTemplate(既定) 追随する 既定のファクトリが SimpleClientHttpRequestFactory(HttpURLConnection)だから
Spring Bootの RestClient.Builder(注入されるもの) 下のファクトリで変わる ClientHttpRequestFactoryBuilder.detect() がクラスパスに合うものを自動選択する

最後の行が落とし穴である。依存関係を1つ足すと下のHTTPクライアントが入れ替わり、リダイレクトの既定も一緒に変わる。だから既定値に頼らず、followRedirects(HttpClient.Redirect.NEVER) を明示して固定する。HttpClient の既定が NEVER だから安全なのではなく、誰かが NORMAL に変えたときに壊れる設計にしないことが大事である。

リダイレクトを完全に禁止するのではなく、1ホップずつ自分で追う書き方が実務的である。各ホップで Location を読み、解決してから次の検証をかけ直す。

private static final int MAX_REDIRECTS = 5;
private static final long MAX_BYTES = 5L * 1024 * 1024; // 5 MiB
private static final Duration CONNECT_TIMEOUT = Duration.ofSeconds(3);
private static final Duration REQUEST_TIMEOUT = Duration.ofSeconds(10);

// 既定が Redirect.NEVER の HttpClient を、明示して固定する。
private final HttpClient client = HttpClient.newBuilder()
        .connectTimeout(CONNECT_TIMEOUT)
        .followRedirects(HttpClient.Redirect.NEVER)
        .build();

public byte[] fetch(String rawUrl) throws IOException, InterruptedException {
    URI uri = URI.create(rawUrl);
    for (int hop = 0; hop <= MAX_REDIRECTS; hop++) {
        validate(uri); // スキーム・ホスト・解決したIPを毎回検証する
        HttpRequest request = HttpRequest.newBuilder(uri)
                .timeout(REQUEST_TIMEOUT)
                .GET()
                .build();
        HttpResponse<InputStream> res =
                client.send(request, HttpResponse.BodyHandlers.ofInputStream());
        int status = res.statusCode();
        if (status >= 300 && status < 400) {
            if (hop == MAX_REDIRECTS) {
                throw new IOException("redirect limit exceeded");
            }
            String location = res.headers().firstValue("Location")
                    .orElseThrow(() -> new IOException("redirect without Location"));
            uri = uri.resolve(location); // 相対Locationもここで絶対化する
            continue;
        }
        if (status != 200) {
            throw new IOException("unexpected status: " + status);
        }
        try (InputStream in = res.body()) {
            byte[] body = in.readNBytes((int) MAX_BYTES + 1);
            if (body.length > MAX_BYTES) {
                throw new IOException("response too large");
            }
            return body;
        }
    }
    throw new IOException("redirect limit exceeded");
}

上限は5ホップにした。検証は最初のURLに1回かけるのではなく、転送先のURLにも毎回かけ直す。Location が相対パスなら uri.resolve(location) で絶対化してから検証する。応答サイズにも上限(ここでは5MiB)を付け、巨大な応答でメモリを食い潰されないようにする。タイムアウトは接続3秒・リクエスト10秒で固定する。上のコードは SsrfSafeFetcher クラスの断片で、importは java.net.http.*・java.net.*・java.io.*・java.time.Duration・java.util.* を使う。

抜け道2:検証時と接続時でIPが変わる

2つ目の抜け道はDNSリバインディングである。検証の時点では images.example.com が公開IPに解決されていたのに、実際に接続する瞬間のDNS引き直しで内部IPに変わる。検証と接続のあいだに時間差がある限り、このすり替えは防げない。検証時攻撃(TOCTOU)の一種である。

筋の通った対策は、検証したIPそのものに接続することである。名前を解決し、返ってきたIPを全部調べて、調べたIPに接続する。curlの --resolve に相当する考え方で、OWASPのチートシートもこの方法を挙げている。ホスト名は Host ヘッダとTLSのSNI・証明書検証のために残し、接続先だけ検証済みのIPにする。

正直に書くと、Javaの HttpClient にはこの仕組みが既定でない。InetAddress.getAllByName(host) で検証したあと、HttpClient が送るときにDNSをもう一度引く。検証と接続のIPが一致することは、この実装では保証されない。残る穴はネットワーク層で受ける。サーバーからの外向き通信をegressのファイアウォールで制限し、クラウドのメタデータ取得先へはそもそも届かない構成にする。IMDSv2への移行とIMDSv1の無効化も同じ位置づけである。アプリ層の検証とネットワーク層の制限は、どちらか片方では足りない。

抜け道3:IPは文字列の見た目では判定できない

3つ目の抜け道は、IPの表記ゆれである。文字列のまま比較すると、次のものは全部 127.0.0.1 や 169.254.169.254 に見えない。

入力の文字列 実際に指す先 なぜ見逃されるか
2130706433 127.0.0.1 10進数の1パート形式。OpenJDKの textToNumericFormatV4 が「1パートだけ与えられた値はそのままネットワークアドレスに格納される」と解釈する
127.1 127.0.0.1 2パート形式。最後のパートが24ビット量として解釈される
::ffff:169.254.169.254 169.254.169.254 IPv4-mapped IPv6。見た目はIPv6だが中身はIPv4
64:ff9b::a9fe:a9fe 169.254.169.254 NAT64。Well-known prefix 64:ff9b::/96 の末尾32ビットがIPv4
http://example.com\@evil.com パーサでホストが変わる WHATWG式の読みではホストは example.com、Pythonの urlsplit では evil.com になる

OWASPのチートシートは、16進数・8進数・10進数・URLエンコード・混合エンコードをバイパスの候補として挙げ、検証ライブラリがこれらに曝されていないかを確認している。防御の要点は、文字列ではなく、解決後の InetAddress オブジェクトで判定することである。文字列で弾く検査は、表記を変えられるたびに追いつかなくなる。

Javaでは、解決したアドレスを正規化してから判定する。

// OWASPのdeny-list表に準拠した拒否範囲
private static final int[] BLOCKED_V4 = {
        0x00000000, 0x0A000000, 0x7F000000, 0xA9FE0000,
        0xAC100000, 0xC0A80000, 0xE0000000, 0xF0000000,
};
private static final int[] BLOCKED_V4_MASK = {
        0xFF000000, 0xFF000000, 0xFF000000, 0xFFFF0000,
        0xFFF00000, 0xFFFF0000, 0xF0000000, 0xF0000000,
};

private static boolean isPublic(InetAddress addr) {
    byte[] raw = normalize(addr); // IPv4-mapped / NAT64 を IPv4 に直す
    if (raw.length == 4) {
        int ip = ((raw[0] & 0xFF) << 24) | ((raw[1] & 0xFF) << 16)
               | ((raw[2] & 0xFF) << 8) | (raw[3] & 0xFF);
        for (int i = 0; i < BLOCKED_V4.length; i++) {
            if ((ip & BLOCKED_V4_MASK[i]) == BLOCKED_V4[i]) {
                return false;
            }
        }
        return true;
    }
    // IPv6: ::1、fc00::/7、fe80::/10、ff00::/8 を弾く
    if (isLoopbackV6(raw) || isUniqueLocal(raw)
            || isLinkLocalV6(raw) || isMulticastV6(raw)) {
        return false;
    }
    return true;
}

private static byte[] normalize(InetAddress addr) {
    byte[] raw = addr.getAddress();
    if (raw.length == 16) {
        // ::ffff:a.b.c.d(先頭10バイトが0、次が 0xFF 0xFF)
        boolean mapped = true;
        for (int i = 0; i < 10; i++) {
            if (raw[i] != 0) { mapped = false; break; }
        }
        if (mapped && raw[10] == (byte) 0xFF && raw[11] == (byte) 0xFF) {
            return new byte[]{ raw[12], raw[13], raw[14], raw[15] };
        }
        // 64:ff9b::/96(先頭12バイトが 00 64 ff 9b 00 00 00 00 00 00 00 00)
        byte[] nat64Prefix = { 0x00, 0x64, (byte) 0xFF, (byte) 0x9B,
                0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
        boolean nat64 = true;
        for (int i = 0; i < 12; i++) {
            if (raw[i] != nat64Prefix[i]) { nat64 = false; break; }
        }
        if (nat64) {
            return new byte[]{ raw[12], raw[13], raw[14], raw[15] };
        }
    }
    return raw;
}

private static boolean isLoopbackV6(byte[] raw) {
    for (int i = 0; i < 15; i++) {
        if (raw[i] != 0) { return false; }
    }
    return raw[15] == 1; // ::1
}

private static boolean isUniqueLocal(byte[] raw) {
    return (raw[0] & 0xFE) == 0xFC; // fc00::/7
}

private static boolean isLinkLocalV6(byte[] raw) {
    return raw[0] == (byte) 0xFE && (raw[1] & 0xC0) == 0x80; // fe80::/10
}

private static boolean isMulticastV6(byte[] raw) {
    return raw[0] == (byte) 0xFF; // ff00::/8
}

isLoopbackAddress() のような既存の述語だけでは足りない。::ffff:127.0.0.1 は Inet6Address として返るため、ループバックの述語が拾わない。正規化してからIPv4の範囲で判定するのが、このコードの要点である。255.255.255.255 は 0xF0000000 のマスクで 240.0.0.0/4 に含まれるため、別途の判定は要らない。

固定できない場合の実装

接続先を固定できる場合は、レッスンの通り画像IDだけを受け取るのが最も強い。固定できない場合(WebhookやコールバックURL)は、上の fetch と isPublic を組み合わせ、さらにOWASPのCase 2の条件を足す。

private static final Set<String> ALLOWED_HOSTS =
        Set.of("images.example.com", "cdn.example.com");

private static void validate(URI uri) throws IOException {
    if (!"https".equalsIgnoreCase(uri.getScheme())) {
        throw new IOException("only https is allowed");
    }
    String host = uri.getHost();
    if (host == null) {
        throw new IOException("host is missing");
    }
    // 固定できる接続先は allow-list で厳密一致させる。
    // Webhookのように固定できない場合はこの検査を外し、IPの検査だけを残す。
    if (!ALLOWED_HOSTS.contains(host.toLowerCase(Locale.ROOT))) {
        throw new IOException("host is not allow-listed");
    }
    // allow-list のホストでも、解決したIPが内部を向いていないか確かめる。
    // 名前が1つでも非公開IPに解決されたら、そのホストは使わない。
    for (InetAddress addr : InetAddress.getAllByName(host)) {
        if (!isPublic(addr)) {
            throw new IOException("host resolves to a non-public address");
        }
    }
}

検証で使うのは uri.getHost() のようにパース済みの値で、利用者の入力文字列そのものではない。URLを1回だけパースし、パースした値を検証し、検証した値だけを送る。文字列を別のコンポーネントへ渡して再度パースさせる設計は、パーサの不一致を招く。URI.create が例外を投げるURLは、その時点で送らない。失敗は「送らない」側に倒す。

Case 2ではさらに、受け取り側とのあいだで正当性のトークンを取り決める。OWASPの例では、受け取り側が20文字の英数字トークンを発行し、呼び出し側はそれをPOSTのボディで渡す。トークンのパラメータ名は [a-z]{1,10}、トークン自体は [a-zA-Z0-9]{20} の文字集合だけを許す。URLの検証だけでは「誰が呼んだか」は分からないため、正当性の証明を別に持たせる。

エラー処理にも1つだけ注意がある。検証で弾いた理由に、解決したIPや内部のホスト名をそのまま載せないことである。内部ネットワークの構成がエラーメッセージ経由で外部に漏れる。理由はサーバー側のログにだけ残し、利用者には「接続先が許可されていません」だけを返す。レッスンのチェック表にも「エラー=内部ネットワークの情報を外部に返さないか」がある。OWASPログのマスキングの記事で扱った通り、ログに残す側と利用者に返す側で出す情報を分ける。

検証環境

Javaコードはこの環境にJDKがなく、JVMでは実行していない。同じロジックをPython 3.12.3に写し、40件のチェックをすべて確認した。

検証内容 件数 結果
IPの公開性判定(通常・RFC1918・リンクローカル・mapped・NAT64・マルチキャスト) 24件 すべて期待通り。::ffff:169.254.169.254 と 64:ff9b::a9fe:a9fe は正規化後に拒否、::ffff:8.8.8.8 と 64:ff9b::808:808 は許可
OpenJDKの1〜2パート形式 6件 2130706433 と 127.1 が 127.0.0.1 になることを確認。文字列比較では 2130706433 は 127.0.0.1 に見えないことも確認。Pythonの ipaddress は 2130706433 を拒否する
パーサの不一致 2件 urlsplit("http://example.com\@evil.com").hostname が evil.com になることを確認。WHATWG式の読み(example.com)と食い違う
リダイレクト連鎖モデル 6件 公開→公開は許可、2ホップ目で内部へ転送される連鎖は却下、6回リダイレクトは上限で却下、5回は許可
記事で使う数字 2件 1億件+600万件=1億600万件、30GBを2日で抜く速度は平均約0.18MB/秒

検証スクリプトは verify-2026-11-21-morning-ssrf.py として残した。Javaコードは目視で構文を確認した。InetAddress.getAllByName の返すアドレスが、実際に HttpClient が接続するアドレスと一致することまでは、この実装では保証されない。DNSリバインディングの節で書いた通り、残る穴はネットワーク層で受ける。

ネットワーク層で受けるもの

アプリ層の検証が通っても、ネットワーク層の制限がないと、検証の抜け道がそのまま内部への到達になる。OWASPはCase 1・Case 2のどちらでも、アプリ層とネットワーク層の両方を固める defense in depth を求めている。

  • サーバーからの外向き通信は、egressのファイアウォールで許可した宛先だけに絞る。SSRFの被害は、サーバーが内部に届くこと自体が前提になっている。
  • AWSではIMDSv2へ移行し、IMDSv1を無効化する。IMDSv2はPUTによるセッショントークンを要求するため、単純なGETのSSRFでは認証情報が取れない。GCPは Metadata-Flavor: Google ヘッダ、Azureは Metadata: true ヘッダを要求する。いずれも「ヘッダを付けたGET」が必要になるため、SSRFの primitive だけでは届かなくなる。ただしこれらは defense in depth であって、SSRF自体を直すものではない。
  • レスポンスの扱いも決めておく。取得した内容をそのまま利用者に返す設計では、内部サーバーの応答がそのまま外部に漏れる。必要な部分だけを抜き出して返すか、ステータスだけを返す。

今後見るべきもの

  • IMDSv2の適用率とIMDSv1の無効化:自社のAWSアカウントでIMDSv1が残っているインスタンスがないか。IMDSv2への移行は、SSRFが起きたときの被害の広がりを直接小さくする。
  • egressのログ:サーバーからの外向き通信で、許可した宛先以外への試行がないか。SSRFの試行は、成功しなくてもログに残る。
  • allow-listの棚卸し:固定した接続先の一覧が、実際の呼び出し先とずれていないか。使われなくなったホストが残っていると、そのホストのDNSが乗っ取られたときにSSRFの入口になる。
  • 依存ライブラリのSSRF関連のCVE:HTTPクライアントやURLパーサの更新で、リダイレクトやパースの既定値が変わることがある。既定値の変更は、検証の前提を変える。
  • HttpClientの既定値の変更:followRedirects を明示していないクライアントが、コードベースに残っていないか。既定値に頼るコードは、依存関係の追加で挙動が変わる。
  • DNSの監視:allow-listのホストが、ある日突然内部IPに解決されるようになっていないか。OWASPのチートシートにある監視スクリプトの考え方で、定期的に確かめる。

まとめ

SSRFの対策は、URLの文字列を検査することではない。接続先を固定できるなら、画像IDだけを受け取る。固定できないなら、解決したIPを全部調べ、リダイレクトの各ホップを検証し直し、送るクライアントの既定値を明示して固定する。検証と接続のあいだの時間差と、文字列の表記ゆれは、アプリ層の検査だけでは塞がらない。残る穴は、ネットワーク層の制限とIMDSv2で受ける。レビューで覚える質問は、レッスンの通り「このAPIは、誰が通信先を決めているのか」である。答えが「利用者」なら、次に問うのは「その利用者の指定を、どこまで検証しているか」ではなく「検証したIPに、実際に接続しているか」である。

参考資料

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?