SSRFはURL検査だけでは防げない――JavaのリダイレクトとDNSの抜け道
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に、実際に接続しているか」である。
参考資料
- Server Side Request Forgery Prevention Cheat Sheet(OWASP Cheat Sheet Series)
- HttpClient(Java SE 17)
- HttpURLConnection(OpenJDKソース)
- IPAddressUtil(OpenJDKソース)
- ClientHttpRequestFactoryBuilder(Spring Boot 3.4 API)
- Server-Side Request Forgery (SSRF)(MDN)
- Lessons Learned from the Capital One Data Breach(Zscaler)