refactor(ai): 三处本机判定统一到 LocalHostPolicy(D5)

AiToolRegistry/AiSmokeRunner/AiLocalReleaseExecutor 原各写一份本机白名单且互异(一处认 0:0:0:0:0:0:0:1 漏 [::1],另两处反之)。
新增 LocalHostPolicy.isLocalHost:去 IPv6 方括号归一 + 精确比对回环集 {localhost,127.0.0.1,::1,0:0:0:0:0:0:0:1},杜绝 127.0.0.1.evil.com 伪本地绕过;三处删副本统一委托。
验证:新增 LocalHostPolicyTest(全回环形态接受 + 伪本地/非本机拒绝)3/3 + 三处既有测试无回归,platform-ai 69/69 绿。见总览 §10 D5。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-24 11:12:22 +08:00
parent 21a181f44b
commit c4ef673b0a
6 changed files with 90 additions and 24 deletions

View File

@@ -181,7 +181,7 @@ public class AiLocalReleaseExecutor {
if (!"http".equalsIgnoreCase(scheme) && !"https".equalsIgnoreCase(scheme)) {
throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "baseUrl 只允许 http/https");
}
if (!isLocalHost(host)) {
if (!LocalHostPolicy.isLocalHost(host)) {
throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "本地发布仅允许访问本机地址");
}
String normalized = uri.toString();
@@ -191,14 +191,6 @@ public class AiLocalReleaseExecutor {
return URI.create(normalized);
}
private static boolean isLocalHost(String host) {
if (host == null) {
return false;
}
String h = host.toLowerCase(Locale.ROOT);
return "localhost".equals(h) || "127.0.0.1".equals(h) || "::1".equals(h) || "[::1]".equals(h);
}
private static String textOrBlank(JsonNode node) {
if (node == null || node.isNull()) {
return "";

View File

@@ -92,7 +92,7 @@ public class AiSmokeRunner {
if (!"http".equalsIgnoreCase(scheme) && !"https".equalsIgnoreCase(scheme)) {
throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "baseUrl 只允许 http/https");
}
if (!isLocalHost(host)) {
if (!LocalHostPolicy.isLocalHost(host)) {
throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "smoke 仅允许访问本机地址");
}
String normalized = uri.toString();
@@ -102,14 +102,6 @@ public class AiSmokeRunner {
return URI.create(normalized);
}
private static boolean isLocalHost(String host) {
if (host == null) {
return false;
}
String h = host.toLowerCase(Locale.ROOT);
return "localhost".equals(h) || "127.0.0.1".equals(h) || "::1".equals(h) || "[::1]".equals(h);
}
private static String text(JsonNode node, String field, String fallback) {
JsonNode value = node == null ? null : node.get(field);
if (value == null || value.isNull()) {

View File

@@ -156,11 +156,9 @@ public final class AiToolRegistry {
if (targetEnv.isBlank() || targetEnv.equals("local") || targetEnv.equals("dev")) {
return true;
}
// 解析 host 精确比对,而非 startsWith 前缀:防 http://127.0.0.1.evil.com / http://localhost.evil.com
// 这类「伪本地」域名绕过(对抗审查 major)。与下游 AiLocalReleaseExecutor.safeLocalBase 同口径。
String host = hostOf(targetEnv);
return host.equals("localhost") || host.equals("127.0.0.1")
|| host.equals("::1") || host.equals("0:0:0:0:0:0:0:1");
// 解析 host 后交统一的 LocalHostPolicy 精确比对(非前缀),防 http://127.0.0.1.evil.com /
// http://localhost.evil.com 伪本地绕过(对抗审查 major);三处本机判定同口径(总览 §10 D5)。
return LocalHostPolicy.isLocalHost(hostOf(targetEnv));
}
private static boolean isProductionEnv(String targetEnv) {

View File

@@ -0,0 +1,38 @@
package com.eip4.platform.ai.service;
import java.util.Locale;
import java.util.Set;
/**
* AI「仅限本机」红线的<strong>单一</strong>本机判定(总览 §10 D5)。
*
* <p>原先 {@code AiToolRegistry} / {@code AiSmokeRunner} / {@code AiLocalReleaseExecutor} 三处各写一份
* 白名单且互异——一处认展开式 {@code 0:0:0:0:0:0:0:1} 却漏方括号式 {@code [::1]},另两处反之,
* 同一回环地址一处放行一处拒绝。本类统一为去括号归一 + 精确比对的回环集,消除漂移。
*
* <p><strong>精确比对(非前缀)</strong>:杜绝 {@code http://127.0.0.1.evil.com} /
* {@code http://localhost.evil.com} 这类「伪本地」域名绕过(对抗审查曾揪出的 major)。
*/
final class LocalHostPolicy {
private static final Set<String> LOOPBACK = Set.of(
"localhost", "127.0.0.1", "::1", "0:0:0:0:0:0:0:1");
private LocalHostPolicy() {
}
/**
* host 是否为本机回环地址。接受 {@link java.net.URI#getHost()} 的形态:
* 自动小写化并剥去 IPv6 字面量方括号(getHost 对 {@code [::1]} 返回带括号串)。
*/
static boolean isLocalHost(String host) {
if (host == null) {
return false;
}
String h = host.trim().toLowerCase(Locale.ROOT);
if (h.startsWith("[") && h.endsWith("]")) {
h = h.substring(1, h.length() - 1);
}
return LOOPBACK.contains(h);
}
}