fix:"修复媒体下载DNS重绑定并隔离出站传输"
This commit is contained in:
1 parent
926aa64ba3
commit
32f6f67b9f
15 files changed
+791
-56
No files matched your search
@@ -8,9 +8,9 @@
|
||||
|
||||
## 当前工程状态
|
||||
|
||||
2026-10-21:当前产品为 Java/Vue 自研控制面与多模型网关,已补请求模块化、账务恢复、异步幂等和审计核账,并继续加固认证与 HTTP 边界。下文包含产品演进目标,不等于功能均已实现。**尚未完成完整 Codex WebSocket/续接、长请求续租、公平排队、账号全生命周期和媒体出站/DNS 绑定闭环。**
|
||||
2026-10-21:当前产品为 Java/Vue 自研控制面与多模型网关,已补请求模块化、账务恢复、异步幂等和审计核账,并继续加固认证与 HTTP 边界。本轮补齐了服务端参考图下载的 DNS 地址绑定与直连隔离;生产网络策略仍需验收。下文包含产品演进目标,不等于功能均已实现。**尚未完成完整 Codex WebSocket/续接、长请求续租、公平排队、账号全生命周期和生产安全验收。**
|
||||
|
||||
逐项完成状态与剩余验收见 [安全与 CPR 任务追踪](docs/24-security-and-cpr-task-tracker.md),本轮设计与限制见 [认证及有界 HTTP 增量](docs/25-auth-and-bounded-transport.md)。本地验证通过不代表已部署或全仓库安全审计完成。
|
||||
逐项完成状态与剩余验收见 [安全与 CPR 任务追踪](docs/24-security-and-cpr-task-tracker.md),认证边界见 [认证及有界 HTTP 增量](docs/25-auth-and-bounded-transport.md),最新出站加固与验收阻塞见 [媒体 DNS 绑定与验收状态](docs/26-media-dns-binding-and-acceptance.md)。本地验证通过不代表已部署或全仓库安全审计完成。
|
||||
|
||||
## 一、产品简介
|
||||
|
||||
|
||||
@@ -17,6 +17,9 @@
|
||||
|
||||
<properties>
|
||||
<java.version>21</java.version>
|
||||
<!-- Keep the new DNS-bound media transport on the matching stable Client/Core pair. -->
|
||||
<httpclient5.version>5.6.5</httpclient5.version>
|
||||
<httpcore5.version>5.4.4</httpcore5.version>
|
||||
</properties>
|
||||
|
||||
<dependencies>
|
||||
@@ -53,6 +56,10 @@
|
||||
<groupId>org.springframework.security</groupId>
|
||||
<artifactId>spring-security-crypto</artifactId>
|
||||
</dependency>
|
||||
<dependency>
|
||||
<groupId>org.apache.httpcomponents.client5</groupId>
|
||||
<artifactId>httpclient5</artifactId>
|
||||
</dependency>
|
||||
<dependency>
|
||||
<groupId>org.postgresql</groupId>
|
||||
<artifactId>postgresql</artifactId>
|
||||
|
||||
+59
@@ -0,0 +1,59 @@
|
||||
package com.moyi.controlplane.provider.media;
|
||||
|
||||
import com.moyi.controlplane.common.ApiException;
|
||||
import com.moyi.controlplane.provider.transport.BoundedHttpTransport;
|
||||
import com.moyi.controlplane.provider.transport.PinnedHttpsTransport;
|
||||
import java.time.Duration;
|
||||
import java.util.Locale;
|
||||
|
||||
/** Public reference-image input only. No provider credentials, routing, retries or billing. */
|
||||
public final class MediaDownloader {
|
||||
private static final int MAX_BYTES = 8 * 1024 * 1024;
|
||||
private final PublicMediaAddressPolicy policy = new PublicMediaAddressPolicy();
|
||||
private final PinnedHttpsTransport transport;
|
||||
private final PinnedHttpsTransport.AddressResolver resolver;
|
||||
|
||||
public MediaDownloader() { this(new PinnedHttpsTransport(), new PublicMediaAddressPolicy()::resolve); }
|
||||
MediaDownloader(PinnedHttpsTransport transport, PinnedHttpsTransport.AddressResolver resolver) {
|
||||
this.transport = transport;
|
||||
this.resolver = resolver;
|
||||
}
|
||||
|
||||
public record MediaBytes(byte[] bytes, String contentType, String filename) {
|
||||
@Override public String toString() { return "MediaBytes[type=" + contentType + ", bytes=" + bytes.length + "]"; }
|
||||
}
|
||||
|
||||
public MediaBytes download(String value) {
|
||||
java.net.URI uri;
|
||||
try { uri = policy.requireUri(value); }
|
||||
catch (IllegalArgumentException error) { throw invalidAddress(); }
|
||||
BoundedHttpTransport.Response response;
|
||||
try { response = transport.get(uri, resolver, Duration.ofSeconds(15), MAX_BYTES); }
|
||||
catch (BoundedHttpTransport.Failure failure) {
|
||||
if (failure.reason() == BoundedHttpTransport.Reason.INVALID_ADDRESS) throw invalidAddress();
|
||||
if (failure.reason() == BoundedHttpTransport.Reason.BODY_TOO_LARGE) throw new ApiException("MEDIA_TOO_LARGE", "媒体输入超过 8 MiB", 400);
|
||||
throw new ApiException("MEDIA_FETCH_FAILED", "无法在期限内读取媒体输入", 400);
|
||||
}
|
||||
if (response.statusCode() < 200 || response.statusCode() >= 300) {
|
||||
throw new ApiException("MEDIA_FETCH_FAILED", "无法读取媒体输入(HTTP " + response.statusCode() + ")", 400);
|
||||
}
|
||||
if (response.body().length == 0) throw new ApiException("MEDIA_TOO_LARGE", "媒体输入为空或超过 8 MiB", 400);
|
||||
String contentType = response.headers().firstValue("Content-Type").orElse("application/octet-stream")
|
||||
.split(";", 2)[0].trim().toLowerCase(Locale.ROOT);
|
||||
if (!contentType.matches("image/[a-z0-9.+-]{1,64}")) {
|
||||
throw new ApiException("MEDIA_TYPE_UNSUPPORTED", "图像编辑和视频参考图必须是 image/* 文件", 400);
|
||||
}
|
||||
String extension = switch (contentType) {
|
||||
case "image/jpeg" -> ".jpg";
|
||||
case "image/png" -> ".png";
|
||||
case "image/webp" -> ".webp";
|
||||
case "image/gif" -> ".gif";
|
||||
default -> ".bin";
|
||||
};
|
||||
return new MediaBytes(response.body(), contentType, "input" + extension);
|
||||
}
|
||||
|
||||
private ApiException invalidAddress() {
|
||||
return new ApiException("INVALID_MEDIA_URL", "媒体地址必须是公开 HTTPS 地址,不能指向本机、内网或特殊用途地址", 400);
|
||||
}
|
||||
}
|
||||
+53
@@ -0,0 +1,53 @@
|
||||
package com.moyi.controlplane.provider.media;
|
||||
|
||||
import com.moyi.controlplane.provider.transport.PinnedHttpsTransport;
|
||||
import java.io.IOException;
|
||||
import java.net.InetAddress;
|
||||
import java.net.URI;
|
||||
|
||||
/** Fail closed for non-global and special-purpose targets, including mixed DNS answer sets. */
|
||||
final class PublicMediaAddressPolicy {
|
||||
URI requireUri(String value) {
|
||||
try {
|
||||
URI uri = URI.create(value);
|
||||
if (!"https".equalsIgnoreCase(uri.getScheme()) || uri.getHost() == null || uri.getHost().contains("%")
|
||||
|| uri.getUserInfo() != null || uri.getRawFragment() != null || uri.getPort() == 0 || uri.getPort() > 65535) {
|
||||
throw new IllegalArgumentException();
|
||||
}
|
||||
return uri;
|
||||
} catch (RuntimeException error) { throw new IllegalArgumentException("Invalid public HTTPS media URL"); }
|
||||
}
|
||||
|
||||
InetAddress[] resolve(String host) throws IOException {
|
||||
return requirePublic(InetAddress.getAllByName(host));
|
||||
}
|
||||
|
||||
InetAddress[] requirePublic(InetAddress[] addresses) throws PinnedHttpsTransport.AddressRejectedException {
|
||||
if (addresses == null || addresses.length == 0 || addresses.length > 16) throw new PinnedHttpsTransport.AddressRejectedException();
|
||||
for (var address : addresses) if (address == null || !isPublic(address)) throw new PinnedHttpsTransport.AddressRejectedException();
|
||||
return addresses.clone();
|
||||
}
|
||||
|
||||
boolean isPublic(InetAddress address) {
|
||||
byte[] raw = address.getAddress();
|
||||
int a = Byte.toUnsignedInt(raw[0]), b = Byte.toUnsignedInt(raw[1]);
|
||||
if (raw.length == 4) {
|
||||
int c = Byte.toUnsignedInt(raw[2]), d = Byte.toUnsignedInt(raw[3]);
|
||||
return !(a == 0 || a == 10 || a == 127 || a >= 224
|
||||
|| a == 100 && b >= 64 && b <= 127
|
||||
|| a == 169 && b == 254 || a == 172 && b >= 16 && b <= 31
|
||||
|| a == 192 && (b == 168 || b == 0 && (c == 0 || c == 2) || b == 88 && c == 99)
|
||||
|| a == 198 && (b == 18 || b == 19 || b == 51 && c == 100)
|
||||
|| a == 203 && b == 0 && c == 113
|
||||
|| a == 168 && b == 63 && c == 129 && d == 16); // Azure platform virtual address
|
||||
}
|
||||
// Only native global unicast 2000::/3, excluding special/tunnel/documentation prefixes.
|
||||
// This also rejects ULA, link/site local, multicast, compatible/mapped IPv4 and well-known NAT64.
|
||||
if (raw.length != 16 || (a & 0xe0) != 0x20) return false;
|
||||
int c = Byte.toUnsignedInt(raw[2]), d = Byte.toUnsignedInt(raw[3]);
|
||||
return !(a == 0x20 && b == 0x01 && (c <= 1 || c == 0x0d && d == 0xb8)
|
||||
|| a == 0x20 && b == 0x02 // 6to4 can encode a private IPv4 target
|
||||
|| a == 0x3f && b == 0xfe // retired 6bone allocation
|
||||
|| a == 0x3f && b == 0xff && (c & 0xf0) == 0); // 3fff::/20 documentation
|
||||
}
|
||||
}
|
||||
+2
-2
@@ -27,11 +27,11 @@ public final class BoundedHttpTransport {
|
||||
public record Response(int statusCode, HttpHeaders headers, byte[] body) {
|
||||
@Override public String toString() { return "TransportResponse[status=" + statusCode + ", bytes=" + body.length + "]"; }
|
||||
}
|
||||
public enum Reason { TIMEOUT, INTERRUPTED, BODY_TOO_LARGE, IO }
|
||||
public enum Reason { TIMEOUT, INTERRUPTED, BODY_TOO_LARGE, IO, INVALID_ADDRESS, BUSY }
|
||||
public static final class Failure extends IOException {
|
||||
private final Reason reason;
|
||||
private final Integer observedStatus;
|
||||
private Failure(Reason reason, Integer status) {
|
||||
Failure(Reason reason, Integer status) {
|
||||
super("Bounded HTTP attempt failed: " + reason);
|
||||
this.reason = reason; this.observedStatus = status;
|
||||
}
|
||||
|
||||
+187
@@ -0,0 +1,187 @@
|
||||
package com.moyi.controlplane.provider.transport;
|
||||
|
||||
import java.io.ByteArrayOutputStream;
|
||||
import java.io.IOException;
|
||||
import java.net.InetAddress;
|
||||
import java.net.Proxy;
|
||||
import java.net.Socket;
|
||||
import java.net.URI;
|
||||
import java.net.UnknownHostException;
|
||||
import java.net.http.HttpHeaders;
|
||||
import java.time.Duration;
|
||||
import java.util.ArrayList;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.concurrent.ExecutionException;
|
||||
import java.util.concurrent.ExecutorService;
|
||||
import java.util.concurrent.Future;
|
||||
import java.util.concurrent.RejectedExecutionException;
|
||||
import java.util.concurrent.SynchronousQueue;
|
||||
import java.util.concurrent.ThreadPoolExecutor;
|
||||
import java.util.concurrent.TimeUnit;
|
||||
import java.util.concurrent.TimeoutException;
|
||||
import java.util.concurrent.atomic.AtomicInteger;
|
||||
import javax.net.ssl.SSLContext;
|
||||
import org.apache.hc.client5.http.DnsResolver;
|
||||
import org.apache.hc.client5.http.classic.methods.HttpGet;
|
||||
import org.apache.hc.client5.http.config.ConnectionConfig;
|
||||
import org.apache.hc.client5.http.config.RequestConfig;
|
||||
import org.apache.hc.client5.http.config.TlsConfig;
|
||||
import org.apache.hc.client5.http.impl.DefaultSchemePortResolver;
|
||||
import org.apache.hc.client5.http.impl.classic.HttpClients;
|
||||
import org.apache.hc.client5.http.impl.io.BasicHttpClientConnectionManager;
|
||||
import org.apache.hc.client5.http.impl.io.DefaultHttpClientConnectionOperator;
|
||||
import org.apache.hc.client5.http.impl.io.ManagedHttpClientConnectionFactory;
|
||||
import org.apache.hc.client5.http.impl.routing.DefaultRoutePlanner;
|
||||
import org.apache.hc.client5.http.ssl.DefaultClientTlsStrategy;
|
||||
import org.apache.hc.client5.http.ssl.DefaultHostnameVerifier;
|
||||
import org.apache.hc.client5.http.ssl.HostnameVerificationPolicy;
|
||||
import org.apache.hc.core5.http.config.Http1Config;
|
||||
import org.apache.hc.core5.io.CloseMode;
|
||||
import org.apache.hc.core5.ssl.SSLContexts;
|
||||
import org.apache.hc.core5.util.Timeout;
|
||||
import static com.moyi.controlplane.provider.transport.BoundedHttpTransport.Reason;
|
||||
|
||||
/**
|
||||
* A credential-free HTTPS GET with per-attempt DNS binding. The caller supplies address policy;
|
||||
* this module owns only bounded transport. Never rewrite the URI to an IP: TLS/SNI and Host use
|
||||
* the original authority. No proxy, cookies, redirects, retry or connection reuse across attempts.
|
||||
*/
|
||||
public final class PinnedHttpsTransport {
|
||||
private static final ExecutorService WORKERS = new ThreadPoolExecutor(0, 8, 60, TimeUnit.SECONDS,
|
||||
new SynchronousQueue<>(), task -> {
|
||||
var thread = new Thread(task, "moyi-media-fetch");
|
||||
thread.setDaemon(true);
|
||||
return thread;
|
||||
}, new ThreadPoolExecutor.AbortPolicy());
|
||||
private final SSLContext sslContext;
|
||||
private final ExecutorService workers;
|
||||
|
||||
public PinnedHttpsTransport() { this(SSLContexts.createDefault(), WORKERS); }
|
||||
PinnedHttpsTransport(SSLContext sslContext, ExecutorService workers) {
|
||||
this.sslContext = sslContext;
|
||||
this.workers = workers;
|
||||
}
|
||||
|
||||
@FunctionalInterface
|
||||
public interface AddressResolver { InetAddress[] resolve(String host) throws IOException; }
|
||||
public static final class AddressRejectedException extends IOException {
|
||||
public AddressRejectedException() { super("Target address rejected"); }
|
||||
}
|
||||
|
||||
public BoundedHttpTransport.Response get(URI uri, AddressResolver resolver, Duration deadline, int maxBytes)
|
||||
throws BoundedHttpTransport.Failure {
|
||||
if (uri == null || !"https".equalsIgnoreCase(uri.getScheme()) || uri.getHost() == null
|
||||
|| uri.getUserInfo() != null || uri.getRawFragment() != null || uri.getHost().contains("%")
|
||||
|| uri.getPort() == 0 || uri.getPort() > 65535) throw new IllegalArgumentException("Invalid HTTPS target");
|
||||
if (maxBytes < 1 || maxBytes > 32 * 1024 * 1024 || deadline == null || deadline.isNegative()
|
||||
|| deadline.isZero() || deadline.compareTo(Duration.ofMinutes(1)) > 0) throw new IllegalArgumentException("Invalid transport limits");
|
||||
var request = new HttpGet(uri);
|
||||
var observed = new AtomicInteger();
|
||||
Future<BoundedHttpTransport.Response> attempt;
|
||||
try {
|
||||
attempt = workers.submit(() -> execute(uri, resolver, request, deadline, maxBytes, observed));
|
||||
} catch (RejectedExecutionException error) {
|
||||
throw failure(Reason.BUSY, observed);
|
||||
}
|
||||
try {
|
||||
return attempt.get(Math.max(1, deadline.toMillis()), TimeUnit.MILLISECONDS);
|
||||
} catch (TimeoutException error) {
|
||||
cancel(request, attempt);
|
||||
throw failure(Reason.TIMEOUT, observed);
|
||||
} catch (InterruptedException error) {
|
||||
cancel(request, attempt);
|
||||
Thread.currentThread().interrupt();
|
||||
throw failure(Reason.INTERRUPTED, observed);
|
||||
} catch (ExecutionException error) {
|
||||
cancel(request, attempt);
|
||||
if (error.getCause() instanceof BoundedHttpTransport.Failure safe) throw safe;
|
||||
if (error.getCause() instanceof AddressRejectedException) throw failure(Reason.INVALID_ADDRESS, observed);
|
||||
if (error.getCause() instanceof java.net.SocketTimeoutException) throw failure(Reason.TIMEOUT, observed);
|
||||
// Do not attach causes: TLS/DNS/parser exceptions can contain signed URLs or response data.
|
||||
throw failure(Reason.IO, observed);
|
||||
}
|
||||
}
|
||||
|
||||
private BoundedHttpTransport.Response execute(URI uri, AddressResolver resolver, HttpGet request,
|
||||
Duration deadline, int maxBytes, AtomicInteger observed) throws IOException {
|
||||
String host = unbracket(uri.getHost());
|
||||
InetAddress[] addresses = resolver.resolve(host);
|
||||
if (addresses == null || addresses.length == 0 || addresses.length > 16
|
||||
|| java.util.Arrays.stream(addresses).anyMatch(java.util.Objects::isNull)) throw new AddressRejectedException();
|
||||
// DNS lookup may ignore interruption. Once timed out, it must never resume with a late HTTP GET.
|
||||
if (request.isCancelled() || Thread.currentThread().isInterrupted()) throw failure(Reason.INTERRUPTED, observed);
|
||||
InetAddress[] pinned = addresses.clone();
|
||||
var timeout = Timeout.ofMilliseconds(Math.max(1, deadline.toMillis()));
|
||||
var boundDns = new DnsResolver() {
|
||||
@Override public InetAddress[] resolve(String target) throws UnknownHostException {
|
||||
if (!host.equalsIgnoreCase(unbracket(target))) throw new UnknownHostException("Unexpected target");
|
||||
return pinned.clone();
|
||||
}
|
||||
@Override public String resolveCanonicalHostname(String target) throws UnknownHostException {
|
||||
if (!host.equalsIgnoreCase(unbracket(target))) throw new UnknownHostException("Unexpected target");
|
||||
return host;
|
||||
}
|
||||
};
|
||||
var tls = new DefaultClientTlsStrategy(sslContext, HostnameVerificationPolicy.BOTH, new DefaultHostnameVerifier());
|
||||
// A direct HTTP route alone is insufficient: new Socket() can still use the JVM's SOCKS selector.
|
||||
var operator = new DefaultHttpClientConnectionOperator(ignored -> new Socket(Proxy.NO_PROXY),
|
||||
DefaultSchemePortResolver.INSTANCE, boundDns, scheme -> "https".equalsIgnoreCase(scheme) ? tls : null);
|
||||
var manager = new BasicHttpClientConnectionManager(operator, ManagedHttpClientConnectionFactory.builder()
|
||||
.http1Config(Http1Config.custom().setMaxLineLength(8192).setMaxHeaderCount(64).build()).build());
|
||||
manager.setConnectionConfig(ConnectionConfig.custom().setConnectTimeout(timeout).setSocketTimeout(timeout).build());
|
||||
manager.setTlsConfig(TlsConfig.custom().setHandshakeTimeout(timeout).build());
|
||||
request.setConfig(RequestConfig.custom().setResponseTimeout(timeout).setConnectionRequestTimeout(timeout)
|
||||
.setHardCancellationEnabled(true).setAuthenticationEnabled(false).setRedirectsEnabled(false).build());
|
||||
request.setHeader("Accept", "image/*");
|
||||
request.setHeader("Accept-Encoding", "identity");
|
||||
request.setHeader("Connection", "close");
|
||||
try (var client = HttpClients.custom().setConnectionManager(manager)
|
||||
.setRoutePlanner(new DefaultRoutePlanner(DefaultSchemePortResolver.INSTANCE))
|
||||
.disableAutomaticRetries().disableRedirectHandling().disableCookieManagement()
|
||||
.disableAuthCaching().disableContentCompression().disableDefaultUserAgent().build()) {
|
||||
try {
|
||||
var response = client.executeOpen(null, request, null);
|
||||
try {
|
||||
observed.set(response.getCode());
|
||||
var entity = response.getEntity();
|
||||
int limit = response.getCode() >= 200 && response.getCode() < 300 ? maxBytes : Math.min(maxBytes, 64 * 1024);
|
||||
if (entity != null && entity.getContentLength() > limit) throw failure(Reason.BODY_TOO_LARGE, observed);
|
||||
// Compressed images are already encoded; do not accept a decompression bomb or compressed MIME wrapper.
|
||||
if (entity != null && entity.getContentEncoding() != null
|
||||
&& !"identity".equalsIgnoreCase(entity.getContentEncoding())) throw failure(Reason.IO, observed);
|
||||
var body = new ByteArrayOutputStream();
|
||||
if (entity != null) {
|
||||
var input = entity.getContent();
|
||||
byte[] chunk = new byte[8192];
|
||||
int count;
|
||||
while ((count = input.read(chunk)) != -1) {
|
||||
if (request.isCancelled() || Thread.currentThread().isInterrupted()) throw failure(Reason.INTERRUPTED, observed);
|
||||
if (count > limit - body.size()) throw failure(Reason.BODY_TOO_LARGE, observed);
|
||||
body.write(chunk, 0, count);
|
||||
}
|
||||
}
|
||||
var headers = new LinkedHashMap<String, List<String>>();
|
||||
for (var header : response.getHeaders()) headers.computeIfAbsent(header.getName(), ignored -> new ArrayList<>()).add(header.getValue());
|
||||
return new BoundedHttpTransport.Response(response.getCode(), HttpHeaders.of(headers, (key, value) -> true), body.toByteArray());
|
||||
} finally {
|
||||
// Cancel BEFORE closing the entity: close/consume must not drain an oversized/never-ending body.
|
||||
request.cancel();
|
||||
try { response.close(); }
|
||||
catch (IOException expectedAfterCancellation) { /* Never replace the primary outcome with a closed-socket cleanup error. */ }
|
||||
}
|
||||
} finally {
|
||||
request.cancel();
|
||||
client.close(CloseMode.IMMEDIATE);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private static String unbracket(String host) {
|
||||
return host.startsWith("[") && host.endsWith("]") ? host.substring(1, host.length() - 1) : host;
|
||||
}
|
||||
private static void cancel(HttpGet request, Future<?> attempt) { request.cancel(); attempt.cancel(true); }
|
||||
private static BoundedHttpTransport.Failure failure(Reason reason, AtomicInteger observed) {
|
||||
return new BoundedHttpTransport.Failure(reason, observed.get() == 0 ? null : observed.get());
|
||||
}
|
||||
}
|
||||
+5
-49
@@ -8,8 +8,9 @@ import com.moyi.controlplane.security.SecretCipher;
|
||||
import com.moyi.controlplane.provider.credentials.UpstreamCredentialResolver;
|
||||
import com.moyi.controlplane.provider.transport.ProviderRequestException;
|
||||
import com.moyi.controlplane.provider.transport.BoundedHttpTransport;
|
||||
import com.moyi.controlplane.provider.media.MediaDownloader;
|
||||
import com.moyi.controlplane.provider.media.MediaDownloader.MediaBytes;
|
||||
import java.net.URI;
|
||||
import java.net.InetAddress;
|
||||
import java.net.http.HttpRequest;
|
||||
import java.time.Duration;
|
||||
import java.io.ByteArrayOutputStream;
|
||||
@@ -42,6 +43,7 @@ public class AsyncProviderClient {
|
||||
* every request otherwise selected the first upstream key forever. */
|
||||
private final ConcurrentMap<String, AtomicInteger> keyCursors = new ConcurrentHashMap<>();
|
||||
private final BoundedHttpTransport transport = new BoundedHttpTransport();
|
||||
private final MediaDownloader mediaDownloader = new MediaDownloader();
|
||||
|
||||
public AsyncProviderClient(JdbcTemplate jdbc, SecretCipher cipher, ObjectMapper mapper, Environment environment) {
|
||||
this.jdbc = jdbc; this.cipher = cipher; this.mapper = mapper; this.environment = environment;
|
||||
@@ -221,7 +223,7 @@ public class AsyncProviderClient {
|
||||
String media=mediaUrl(input);
|
||||
if(media!=null) {
|
||||
try {
|
||||
MediaBytes file=downloadMedia(media);
|
||||
MediaBytes file=mediaDownloader.download(media);
|
||||
parts.add(Map.of("inlineData",Map.of("mimeType",file.contentType(),"data",Base64.getEncoder().encodeToString(file.bytes()))));
|
||||
} catch(ApiException e) { throw e; }
|
||||
catch(Exception e) { throw new ApiException("MEDIA_FETCH_FAILED","无法读取参考图",400); }
|
||||
@@ -351,7 +353,7 @@ public class AsyncProviderClient {
|
||||
multipartField(out, boundary, entry.getKey(), String.valueOf(entry.getValue()));
|
||||
}
|
||||
if (fileField != null && media != null) {
|
||||
MediaBytes file = downloadMedia(media);
|
||||
MediaBytes file = mediaDownloader.download(media);
|
||||
multipartFile(out, boundary, fileField, file.filename(), file.contentType(), file.bytes());
|
||||
}
|
||||
out.write(("--" + boundary + "--\r\n").getBytes(java.nio.charset.StandardCharsets.UTF_8));
|
||||
@@ -400,52 +402,6 @@ public class AsyncProviderClient {
|
||||
out.write("\r\n".getBytes(java.nio.charset.StandardCharsets.UTF_8));
|
||||
}
|
||||
|
||||
private MediaBytes downloadMedia(String value) throws IOException, InterruptedException {
|
||||
URI uri = URI.create(value);
|
||||
if (!"https".equalsIgnoreCase(uri.getScheme()) || uri.getHost() == null || uri.getUserInfo() != null) {
|
||||
throw new ApiException("INVALID_MEDIA_URL", "媒体地址必须是可公开访问的 HTTPS URL", 400);
|
||||
}
|
||||
for (InetAddress address : InetAddress.getAllByName(uri.getHost())) {
|
||||
if (address.isAnyLocalAddress() || address.isLoopbackAddress() || address.isLinkLocalAddress()
|
||||
|| address.isSiteLocalAddress() || address.isMulticastAddress()) {
|
||||
throw new ApiException("INVALID_MEDIA_URL", "媒体地址不能指向内网或本机地址", 400);
|
||||
}
|
||||
}
|
||||
HttpRequest request = HttpRequest.newBuilder(uri).timeout(Duration.ofSeconds(15)).GET().build();
|
||||
BoundedHttpTransport.Response response;
|
||||
try { response = transport.send(request, 8 * 1024 * 1024); }
|
||||
catch (BoundedHttpTransport.Failure failure) {
|
||||
if (failure.reason() == BoundedHttpTransport.Reason.BODY_TOO_LARGE) throw new ApiException("MEDIA_TOO_LARGE", "媒体输入超过 8 MiB", 400);
|
||||
throw new ApiException("MEDIA_FETCH_FAILED", "无法在期限内读取媒体输入", 400);
|
||||
}
|
||||
if (response.statusCode() < 200 || response.statusCode() >= 300) {
|
||||
throw new ApiException("MEDIA_FETCH_FAILED", "无法读取媒体输入(HTTP " + response.statusCode() + ")", 400);
|
||||
}
|
||||
byte[] bytes = response.body();
|
||||
if (bytes.length == 0 || bytes.length > 8 * 1024 * 1024) {
|
||||
throw new ApiException("MEDIA_TOO_LARGE", "媒体输入为空或超过 8 MiB", 400);
|
||||
}
|
||||
String contentType = response.headers().firstValue("Content-Type").orElse("application/octet-stream")
|
||||
.split(";", 2)[0].trim().toLowerCase(java.util.Locale.ROOT);
|
||||
if (!contentType.startsWith("image/")) {
|
||||
throw new ApiException("MEDIA_TYPE_UNSUPPORTED", "图像编辑和视频参考图必须是 image/* 文件", 400);
|
||||
}
|
||||
String filename = "input" + extension(contentType);
|
||||
return new MediaBytes(bytes, contentType, filename);
|
||||
}
|
||||
|
||||
private String extension(String contentType) {
|
||||
return switch (contentType) {
|
||||
case "image/jpeg" -> ".jpg";
|
||||
case "image/png" -> ".png";
|
||||
case "image/webp" -> ".webp";
|
||||
case "image/gif" -> ".gif";
|
||||
default -> ".bin";
|
||||
};
|
||||
}
|
||||
|
||||
private record MediaBytes(byte[] bytes, String contentType, String filename) {}
|
||||
|
||||
private Map<String,Object> request(String method, String url, String key, Map<String,Object> body, String message) {
|
||||
boolean sending = false;
|
||||
try {
|
||||
|
||||
+5
@@ -20,6 +20,11 @@ class ModuleDependencyTest {
|
||||
assertTrue(Files.exists(root.resolve("task/TaskSettlementService.java")));
|
||||
disallow(root.resolve("task/TaskSettlementService.java"), List.of("java.net.http", "AsyncProviderClient", "OpenAiCompatibleProvider"));
|
||||
}
|
||||
@Test void mediaInputDoesNotOwnCredentialsRoutingOrBilling() throws Exception {
|
||||
disallow(root.resolve("provider/media"), List.of(".gateway.", ".wallet.", ".auth.", ".task.",
|
||||
".provider.credentials", "org.springframework.jdbc", ".security.SecretCipher", "java.net.http.HttpClient"));
|
||||
assertFalse(Files.readString(root.resolve("task/AsyncProviderClient.java")).contains("InetAddress"), "DNS policy belongs to the media boundary");
|
||||
}
|
||||
private void disallow(Path path, List<String> forbidden) throws Exception {
|
||||
assertTrue(Files.exists(path), "Expected source boundary: " + path);
|
||||
try (var paths = Files.isDirectory(path) ? Files.walk(path) : java.util.stream.Stream.of(path)) {
|
||||
|
||||
+58
@@ -0,0 +1,58 @@
|
||||
package com.moyi.controlplane.provider.media;
|
||||
|
||||
import com.moyi.controlplane.common.ApiException;
|
||||
import com.moyi.controlplane.provider.transport.BoundedHttpTransport;
|
||||
import com.moyi.controlplane.provider.transport.PinnedHttpsTransport;
|
||||
import java.net.URI;
|
||||
import java.net.http.HttpHeaders;
|
||||
import java.time.Duration;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.junit.jupiter.params.ParameterizedTest;
|
||||
import org.junit.jupiter.params.provider.CsvSource;
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
import static org.mockito.ArgumentMatchers.*;
|
||||
import static org.mockito.Mockito.*;
|
||||
|
||||
class MediaDownloaderTest {
|
||||
private final PinnedHttpsTransport transport = mock(PinnedHttpsTransport.class);
|
||||
private final MediaDownloader downloader = new MediaDownloader(transport, host -> { throw new AssertionError("Unexpected network"); });
|
||||
|
||||
@Test void normalizesImagesAndPreservesBoundedTransportContract() throws Exception {
|
||||
byte[] bytes = {1, 2, 3};
|
||||
when(transport.get(any(), any(), any(), anyInt())).thenReturn(response(200, "IMAGE/PNG; charset=utf-8", bytes));
|
||||
var image = downloader.download("https://media.test/a?signature=synthetic");
|
||||
assertArrayEquals(bytes, image.bytes()); assertEquals("image/png", image.contentType()); assertEquals("input.png", image.filename());
|
||||
verify(transport).get(eq(URI.create("https://media.test/a?signature=synthetic")), any(), eq(Duration.ofSeconds(15)), eq(8 * 1024 * 1024));
|
||||
assertFalse(image.toString().contains("synthetic"));
|
||||
}
|
||||
|
||||
@Test void invalidUrlsFailBeforeTransport() {
|
||||
assertEquals("INVALID_MEDIA_URL", assertThrows(ApiException.class, () -> downloader.download("https://user:secret@media.test/a")).getCode());
|
||||
verifyNoInteractions(transport);
|
||||
}
|
||||
|
||||
@ParameterizedTest @CsvSource({"BODY_TOO_LARGE,MEDIA_TOO_LARGE", "INVALID_ADDRESS,INVALID_MEDIA_URL", "TIMEOUT,MEDIA_FETCH_FAILED", "INTERRUPTED,MEDIA_FETCH_FAILED", "BUSY,MEDIA_FETCH_FAILED", "IO,MEDIA_FETCH_FAILED"})
|
||||
void transportFailuresExposeOnlySafeDomainCodes(BoundedHttpTransport.Reason reason, String code) throws Exception {
|
||||
var failure = mock(BoundedHttpTransport.Failure.class); when(failure.reason()).thenReturn(reason);
|
||||
when(transport.get(any(), any(), any(), anyInt())).thenThrow(failure);
|
||||
var error = assertThrows(ApiException.class, () -> downloader.download("https://media.test/a?signature=private"));
|
||||
assertEquals(code, error.getCode()); assertFalse(error.getMessage().contains("private")); assertNull(error.getCause());
|
||||
}
|
||||
|
||||
@ParameterizedTest @CsvSource({"302,image/png,MEDIA_FETCH_FAILED", "404,image/png,MEDIA_FETCH_FAILED", "200,text/html,MEDIA_TYPE_UNSUPPORTED", "200,image/invalid:type,MEDIA_TYPE_UNSUPPORTED"})
|
||||
void redirectsErrorsAndUnsupportedTypesAreRejected(int status, String type, String code) throws Exception {
|
||||
when(transport.get(any(), any(), any(), anyInt())).thenReturn(response(status, type, new byte[] {1}));
|
||||
assertEquals(code, assertThrows(ApiException.class, () -> downloader.download("https://media.test/a")).getCode());
|
||||
}
|
||||
|
||||
@Test void emptyBodyIsRejected() throws Exception {
|
||||
when(transport.get(any(), any(), any(), anyInt())).thenReturn(response(200, "image/png", new byte[0]));
|
||||
assertEquals("MEDIA_TOO_LARGE", assertThrows(ApiException.class, () -> downloader.download("https://media.test/a")).getCode());
|
||||
}
|
||||
|
||||
private BoundedHttpTransport.Response response(int status, String type, byte[] body) {
|
||||
return new BoundedHttpTransport.Response(status, HttpHeaders.of(Map.of("Content-Type", List.of(type)), (key, value) -> true), body);
|
||||
}
|
||||
}
|
||||
+65
@@ -0,0 +1,65 @@
|
||||
package com.moyi.controlplane.provider.media;
|
||||
|
||||
import com.moyi.controlplane.provider.transport.PinnedHttpsTransport;
|
||||
import java.net.InetAddress;
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.junit.jupiter.params.ParameterizedTest;
|
||||
import org.junit.jupiter.params.provider.ValueSource;
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
|
||||
class PublicMediaAddressPolicyTest {
|
||||
private final PublicMediaAddressPolicy policy = new PublicMediaAddressPolicy();
|
||||
|
||||
@ParameterizedTest
|
||||
@ValueSource(strings = {
|
||||
"0.0.0.0", "0.255.255.255", "10.0.0.1", "127.0.0.1", "127.255.255.254",
|
||||
"100.64.0.1", "100.127.255.254", "169.254.169.254", "172.16.0.1", "172.31.255.254",
|
||||
"192.0.0.1", "192.0.0.9", "192.0.2.1", "192.88.99.1", "192.168.1.1",
|
||||
"198.18.0.1", "198.19.255.254", "198.51.100.1", "203.0.113.1", "224.0.0.1",
|
||||
"239.255.255.255", "240.0.0.1", "255.255.255.255", "168.63.129.16",
|
||||
"::", "::1", "::127.0.0.1", "::ffff:127.0.0.1", "::ffff:169.254.169.254",
|
||||
"fc00::1", "fd00::1", "fe80::1", "fec0::1", "ff02::1", "64:ff9b::a00:1", "64:ff9b:1::1",
|
||||
"100::1", "2001::1", "2001:1ff:ffff::1", "2001:2::1", "2001:20::1", "2001:db8::1",
|
||||
"2002:7f00:1::1", "2002:0808:0808::1", "3ffe::1", "3fff::1", "3fff:fff:ffff::1", "4000::1"
|
||||
})
|
||||
void rejectsNonGlobalSpecialAndTranslationTargets(String literal) throws Exception {
|
||||
InetAddress address = InetAddress.getByName(literal);
|
||||
assertFalse(policy.isPublic(address), literal);
|
||||
assertThrows(PinnedHttpsTransport.AddressRejectedException.class, () -> policy.requirePublic(new InetAddress[] {address}));
|
||||
}
|
||||
|
||||
@ParameterizedTest
|
||||
@ValueSource(strings = {"1.1.1.1", "8.8.8.8", "100.63.255.254", "100.128.0.1", "172.15.255.254", "172.32.0.1",
|
||||
"192.0.1.1", "198.17.255.254", "198.20.0.1", "223.255.255.254", "2606:4700:4700::1111", "2001:4860:4860::8888", "3fff:1000::1"})
|
||||
void permitsOrdinaryGlobalAddressesWithoutMakingInternetRequests(String literal) throws Exception {
|
||||
var address = InetAddress.getByName(literal);
|
||||
assertTrue(policy.isPublic(address), literal);
|
||||
assertArrayEquals(new InetAddress[] {address}, policy.requirePublic(new InetAddress[] {address}));
|
||||
}
|
||||
|
||||
@Test void rejectsTheWholeMixedAnswerSetInEitherOrder() throws Exception {
|
||||
var external = InetAddress.getByName("8.8.8.8");
|
||||
var internal = InetAddress.getByName("fd00::1");
|
||||
assertThrows(PinnedHttpsTransport.AddressRejectedException.class, () -> policy.requirePublic(new InetAddress[] {external, internal}));
|
||||
assertThrows(PinnedHttpsTransport.AddressRejectedException.class, () -> policy.requirePublic(new InetAddress[] {internal, external}));
|
||||
assertThrows(PinnedHttpsTransport.AddressRejectedException.class, () -> policy.requirePublic(new InetAddress[0]));
|
||||
assertThrows(PinnedHttpsTransport.AddressRejectedException.class, () -> policy.requirePublic(new InetAddress[] {null}));
|
||||
assertThrows(PinnedHttpsTransport.AddressRejectedException.class, () -> policy.requirePublic(new InetAddress[17]));
|
||||
}
|
||||
|
||||
@ParameterizedTest
|
||||
@ValueSource(strings = {"http://example.test/a", "file:///etc/passwd", "data:image/png,a", "//example.test/a",
|
||||
"https://user:secret@example.test/a", "https://example.test/a#fragment", "https://example.test:0/a", "https://example.test:65536/a",
|
||||
"https://[fe80::1%25eth0]/a", "https://example.test\\@127.0.0.1/a", "https://example.test/%0d%0a/x\r\n", "https:///a", ""})
|
||||
void rejectsAmbiguousOrNonHttpsUris(String value) {
|
||||
var failure = assertThrows(IllegalArgumentException.class, () -> policy.requireUri(value));
|
||||
assertFalse(failure.getMessage().contains("secret"));
|
||||
assertNull(failure.getCause());
|
||||
}
|
||||
|
||||
@Test void permitsSignedHttpsUrlsAndExplicitHttpsPortsWithoutRewritingAuthority() {
|
||||
String value = "https://media.example.test:8443/a.png?signature=synthetic";
|
||||
assertEquals(value, policy.requireUri(value).toString());
|
||||
assertEquals("[2606:4700:4700::1111]", policy.requireUri("https://[2606:4700:4700::1111]/a").getHost());
|
||||
}
|
||||
}
|
||||
+279
@@ -0,0 +1,279 @@
|
||||
package com.moyi.controlplane.provider.transport;
|
||||
|
||||
import com.sun.net.httpserver.HttpsConfigurator;
|
||||
import com.sun.net.httpserver.HttpsServer;
|
||||
import java.net.InetAddress;
|
||||
import java.net.InetSocketAddress;
|
||||
import java.net.URI;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
import java.security.KeyStore;
|
||||
import java.time.Duration;
|
||||
import java.util.concurrent.CountDownLatch;
|
||||
import java.util.concurrent.ExecutorService;
|
||||
import java.util.concurrent.SynchronousQueue;
|
||||
import java.util.concurrent.ThreadPoolExecutor;
|
||||
import java.util.concurrent.TimeUnit;
|
||||
import java.util.concurrent.atomic.AtomicInteger;
|
||||
import java.util.concurrent.atomic.AtomicReference;
|
||||
import javax.net.ssl.ExtendedSSLSession;
|
||||
import javax.net.ssl.KeyManagerFactory;
|
||||
import javax.net.ssl.SNIHostName;
|
||||
import javax.net.ssl.SSLContext;
|
||||
import javax.net.ssl.TrustManagerFactory;
|
||||
import org.junit.jupiter.api.AfterEach;
|
||||
import org.junit.jupiter.api.BeforeAll;
|
||||
import org.junit.jupiter.api.BeforeEach;
|
||||
import org.junit.jupiter.api.Test;
|
||||
import org.junit.jupiter.api.io.TempDir;
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
|
||||
class PinnedHttpsTransportTest {
|
||||
@TempDir static Path temporary;
|
||||
private static SSLContext serverTls, trustedTls;
|
||||
private HttpsServer server;
|
||||
private ExecutorService workers;
|
||||
private PinnedHttpsTransport transport;
|
||||
private final CountDownLatch release = new CountDownLatch(1);
|
||||
|
||||
@BeforeAll static void createEphemeralTestCertificate() throws Exception {
|
||||
// No committed key, no trust-all TLS: mint a .test certificate and trust only this test key.
|
||||
String password = java.util.UUID.randomUUID().toString();
|
||||
Path store = temporary.resolve("media-test.p12");
|
||||
var process = new ProcessBuilder(Path.of(System.getProperty("java.home"), "bin", "keytool").toString(),
|
||||
"-genkeypair", "-alias", "test", "-keyalg", "RSA", "-keysize", "2048", "-validity", "2",
|
||||
"-dname", "CN=media.test", "-ext", "SAN=dns:media.test", "-storetype", "PKCS12",
|
||||
"-keystore", store.toString(), "-storepass", password, "-keypass", password, "-noprompt")
|
||||
.redirectErrorStream(true).start();
|
||||
assertTrue(process.waitFor(15, TimeUnit.SECONDS));
|
||||
assertEquals(0, process.exitValue(), () -> "Unable to create ephemeral TLS fixture");
|
||||
var keys = KeyStore.getInstance("PKCS12");
|
||||
try (var input = Files.newInputStream(store)) { keys.load(input, password.toCharArray()); }
|
||||
var kmf = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());
|
||||
kmf.init(keys, password.toCharArray());
|
||||
serverTls = SSLContext.getInstance("TLS");
|
||||
serverTls.init(kmf.getKeyManagers(), null, null);
|
||||
var trust = KeyStore.getInstance(KeyStore.getDefaultType()); trust.load(null, null);
|
||||
trust.setCertificateEntry("test", keys.getCertificate("test"));
|
||||
var tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm()); tmf.init(trust);
|
||||
trustedTls = SSLContext.getInstance("TLS"); trustedTls.init(null, tmf.getTrustManagers(), null);
|
||||
}
|
||||
|
||||
@BeforeEach void setup() throws Exception {
|
||||
server = HttpsServer.create(new InetSocketAddress("127.0.0.1", 0), 0);
|
||||
server.setHttpsConfigurator(new HttpsConfigurator(serverTls));
|
||||
workers = new ThreadPoolExecutor(0, 2, 5, TimeUnit.SECONDS, new SynchronousQueue<>(),
|
||||
runnable -> { var thread = new Thread(runnable, "test-pinned-get"); thread.setDaemon(true); return thread; });
|
||||
transport = new PinnedHttpsTransport(trustedTls, workers);
|
||||
}
|
||||
@AfterEach void cleanup() throws Exception {
|
||||
release.countDown(); workers.shutdownNow(); server.stop(0);
|
||||
assertTrue(workers.awaitTermination(3, TimeUnit.SECONDS));
|
||||
}
|
||||
private URI uri(String path) { return URI.create("https://media.test:" + server.getAddress().getPort() + path); }
|
||||
private InetAddress[] loopback(String host) throws java.io.IOException { return new InetAddress[] {InetAddress.getByName("127.0.0.1")}; }
|
||||
private BoundedHttpTransport.Response get(String path, long timeoutMs, int maxBytes) throws Exception {
|
||||
return transport.get(uri(path), this::loopback, Duration.ofMillis(timeoutMs), maxBytes);
|
||||
}
|
||||
|
||||
@Test void bindsDnsOnceWhilePreservingHostSniAndCredentialIsolation() throws Exception {
|
||||
var lookups = new AtomicInteger(); var host = new AtomicReference<String>(); var sni = new AtomicReference<String>();
|
||||
server.createContext("/", exchange -> {
|
||||
host.set(exchange.getRequestHeaders().getFirst("Host"));
|
||||
var session = (ExtendedSSLSession) ((com.sun.net.httpserver.HttpsExchange) exchange).getSSLSession();
|
||||
sni.set(((SNIHostName) session.getRequestedServerNames().getFirst()).getAsciiName());
|
||||
assertNull(exchange.getRequestHeaders().getFirst("Authorization"));
|
||||
assertNull(exchange.getRequestHeaders().getFirst("Cookie"));
|
||||
assertNull(exchange.getRequestHeaders().getFirst("Proxy-Authorization"));
|
||||
assertEquals("identity", exchange.getRequestHeaders().getFirst("Accept-Encoding"));
|
||||
exchange.getResponseHeaders().set("Content-Type", "image/png");
|
||||
byte[] bytes = "synthetic-image".getBytes(StandardCharsets.UTF_8); exchange.sendResponseHeaders(200, bytes.length);
|
||||
try (var output = exchange.getResponseBody()) { output.write(bytes); }
|
||||
}); server.start();
|
||||
var response = transport.get(uri("/?signature=synthetic-private-query"), target -> {
|
||||
assertEquals("media.test", target);
|
||||
if (lookups.incrementAndGet() != 1) throw new AssertionError("DNS was resolved twice");
|
||||
return loopback(target);
|
||||
}, Duration.ofSeconds(3), 1024);
|
||||
assertEquals(200, response.statusCode()); assertEquals(1, lookups.get());
|
||||
assertEquals("media.test:" + server.getAddress().getPort(), host.get()); assertEquals("media.test", sni.get());
|
||||
assertEquals("synthetic-image", new String(response.body(), StandardCharsets.UTF_8));
|
||||
assertFalse(response.toString().contains("synthetic"));
|
||||
}
|
||||
|
||||
@Test void aTrustedCertificateForAnotherHostnameStillFails() throws Exception {
|
||||
var calls = new AtomicInteger();
|
||||
server.createContext("/", exchange -> { calls.incrementAndGet(); exchange.sendResponseHeaders(200, -1); exchange.close(); }); server.start();
|
||||
URI wrong = URI.create("https://wrong.test:" + server.getAddress().getPort() + "/?signature=private");
|
||||
var failure = assertThrows(BoundedHttpTransport.Failure.class, () -> transport.get(wrong, this::loopback, Duration.ofSeconds(3), 1024));
|
||||
assertEquals(BoundedHttpTransport.Reason.IO, failure.reason()); assertEquals(0, calls.get());
|
||||
assertNull(failure.getCause()); assertFalse(failure.toString().contains("private"));
|
||||
}
|
||||
|
||||
@Test void theDefaultTrustStoreDoesNotAcceptOurSelfSignedTestCertificate() throws Exception {
|
||||
server.createContext("/", exchange -> { exchange.sendResponseHeaders(200, -1); exchange.close(); }); server.start();
|
||||
var strict = new PinnedHttpsTransport(org.apache.hc.core5.ssl.SSLContexts.createDefault(), workers);
|
||||
assertEquals(BoundedHttpTransport.Reason.IO, assertThrows(BoundedHttpTransport.Failure.class,
|
||||
() -> strict.get(uri("/"), this::loopback, Duration.ofSeconds(3), 1024)).reason());
|
||||
}
|
||||
|
||||
@Test void redirectsAreNeverFollowed() throws Exception {
|
||||
var calls = new AtomicInteger();
|
||||
server.createContext("/", exchange -> {
|
||||
calls.incrementAndGet(); exchange.getResponseHeaders().set("Location", "https://127.0.0.1/private");
|
||||
exchange.sendResponseHeaders(302, -1); exchange.close();
|
||||
}); server.start();
|
||||
assertEquals(302, get("/", 3000, 1024).statusCode()); assertEquals(1, calls.get());
|
||||
}
|
||||
|
||||
@Test void declaredOversizeDoesNotWaitForTheBodyOrDrainItOnClose() {
|
||||
server.createContext("/", exchange -> {
|
||||
exchange.sendResponseHeaders(200, 1_000_000);
|
||||
try { release.await(3, TimeUnit.SECONDS); } catch (InterruptedException error) { Thread.currentThread().interrupt(); }
|
||||
exchange.close();
|
||||
}); server.start();
|
||||
var failure = assertThrows(BoundedHttpTransport.Failure.class, () -> get("/", 2000, 8192));
|
||||
assertEquals(BoundedHttpTransport.Reason.BODY_TOO_LARGE, failure.reason()); assertEquals(200, failure.observedStatus());
|
||||
}
|
||||
|
||||
@Test void chunkedOversizeIsStoppedDuringRead() {
|
||||
server.createContext("/", exchange -> {
|
||||
exchange.sendResponseHeaders(200, 0);
|
||||
try (var output = exchange.getResponseBody()) { for (int i = 0; i < 100; i++) output.write(new byte[4096]); }
|
||||
catch (java.io.IOException expectedAfterCancellation) { }
|
||||
}); server.start();
|
||||
assertEquals(BoundedHttpTransport.Reason.BODY_TOO_LARGE, assertThrows(BoundedHttpTransport.Failure.class, () -> get("/", 3000, 8192)).reason());
|
||||
}
|
||||
|
||||
@Test void deadlineIncludesSlowResponseBodyAndRestoresWorkerCapacity() throws Exception {
|
||||
var arrived = new CountDownLatch(1);
|
||||
server.createContext("/", exchange -> {
|
||||
exchange.sendResponseHeaders(200, 0);
|
||||
try (var output = exchange.getResponseBody()) {
|
||||
output.write('x'); output.flush(); arrived.countDown();
|
||||
try { release.await(5, TimeUnit.SECONDS); } catch (InterruptedException error) { Thread.currentThread().interrupt(); }
|
||||
} catch (java.io.IOException expectedAfterCancellation) { }
|
||||
}); server.start();
|
||||
long start = System.nanoTime();
|
||||
var failure = assertThrows(BoundedHttpTransport.Failure.class, () -> get("/", 1000, 8192));
|
||||
assertEquals(BoundedHttpTransport.Reason.TIMEOUT, failure.reason()); assertEquals(200, failure.observedStatus());
|
||||
assertEquals(0, arrived.getCount()); assertTrue(TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start) < 2500);
|
||||
workers.shutdown(); assertTrue(workers.awaitTermination(2, TimeUnit.SECONDS));
|
||||
}
|
||||
|
||||
@Test void lateDnsResolutionCannotStartHttpAfterTheDeadline() throws Exception {
|
||||
var resolving = new CountDownLatch(1); var finished = new CountDownLatch(1); var calls = new AtomicInteger();
|
||||
server.createContext("/", exchange -> { calls.incrementAndGet(); exchange.sendResponseHeaders(200, -1); exchange.close(); }); server.start();
|
||||
var failure = assertThrows(BoundedHttpTransport.Failure.class, () -> transport.get(uri("/"), host -> {
|
||||
resolving.countDown();
|
||||
boolean interrupted = false;
|
||||
while (release.getCount() != 0) try { release.await(1, TimeUnit.SECONDS); }
|
||||
catch (InterruptedException ignoredForSimulatedNativeResolver) { interrupted = true; }
|
||||
if (interrupted) Thread.currentThread().interrupt();
|
||||
finished.countDown(); return loopback(host);
|
||||
}, Duration.ofMillis(200), 1024));
|
||||
assertEquals(BoundedHttpTransport.Reason.TIMEOUT, failure.reason()); assertEquals(0, resolving.getCount());
|
||||
release.countDown(); assertTrue(finished.await(2, TimeUnit.SECONDS));
|
||||
workers.shutdown(); assertTrue(workers.awaitTermination(2, TimeUnit.SECONDS)); assertEquals(0, calls.get());
|
||||
}
|
||||
|
||||
@Test void interruptionCancelsSocketAndRestoresCallerInterruptFlag() throws Exception {
|
||||
var arrived = new CountDownLatch(1); var observed = new AtomicReference<BoundedHttpTransport.Reason>(); var flag = new AtomicReference<Boolean>();
|
||||
server.createContext("/", exchange -> {
|
||||
exchange.sendResponseHeaders(200, 0);
|
||||
try (var output = exchange.getResponseBody()) {
|
||||
output.write('x'); output.flush(); arrived.countDown();
|
||||
try { release.await(5, TimeUnit.SECONDS); } catch (InterruptedException error) { Thread.currentThread().interrupt(); }
|
||||
} catch (java.io.IOException expectedAfterCancellation) { }
|
||||
}); server.start();
|
||||
var caller = new Thread(() -> {
|
||||
try { get("/", 5000, 1024); }
|
||||
catch (BoundedHttpTransport.Failure failure) { observed.set(failure.reason()); flag.set(Thread.currentThread().isInterrupted()); }
|
||||
catch (Exception unexpected) { throw new AssertionError(unexpected); }
|
||||
}); caller.setDaemon(true); caller.start();
|
||||
try {
|
||||
assertTrue(arrived.await(3, TimeUnit.SECONDS)); caller.interrupt(); caller.join(2000);
|
||||
assertFalse(caller.isAlive()); assertEquals(BoundedHttpTransport.Reason.INTERRUPTED, observed.get()); assertEquals(true, flag.get());
|
||||
} finally { release.countDown(); caller.interrupt(); }
|
||||
}
|
||||
|
||||
@Test void refusedOrDroppedRequestsAreNotAutomaticallyRetried() {
|
||||
var calls = new AtomicInteger();
|
||||
server.createContext("/", exchange -> { calls.incrementAndGet(); exchange.close(); }); server.start();
|
||||
assertThrows(BoundedHttpTransport.Failure.class, () -> get("/", 3000, 1024)); assertEquals(1, calls.get());
|
||||
}
|
||||
|
||||
@Test void compressedBodiesAreNotDecompressedOrTreatedAsImages() {
|
||||
server.createContext("/", exchange -> {
|
||||
exchange.getResponseHeaders().set("Content-Encoding", "gzip"); exchange.sendResponseHeaders(200, 0);
|
||||
try (var output = exchange.getResponseBody()) { output.write(new byte[16]); }
|
||||
catch (java.io.IOException expectedAfterCancellation) { }
|
||||
}); server.start();
|
||||
assertEquals(BoundedHttpTransport.Reason.IO, assertThrows(BoundedHttpTransport.Failure.class, () -> get("/", 3000, 1024)).reason());
|
||||
}
|
||||
|
||||
@Test void busyPoolRejectsImmediatelyRatherThanQueueingUnlimitedDnsRequests() throws Exception {
|
||||
var occupied = new CountDownLatch(1);
|
||||
var oneWorker = new ThreadPoolExecutor(0, 1, 5, TimeUnit.SECONDS, new SynchronousQueue<>());
|
||||
try {
|
||||
oneWorker.submit(() -> {
|
||||
occupied.countDown();
|
||||
try { release.await(5, TimeUnit.SECONDS); } catch (InterruptedException error) { Thread.currentThread().interrupt(); }
|
||||
});
|
||||
assertTrue(occupied.await(2, TimeUnit.SECONDS));
|
||||
var rejected = new PinnedHttpsTransport(trustedTls, oneWorker);
|
||||
var failure = assertThrows(BoundedHttpTransport.Failure.class, () -> rejected.get(uri("/"), this::loopback, Duration.ofSeconds(3), 1024));
|
||||
assertEquals(BoundedHttpTransport.Reason.BUSY, failure.reason()); assertNull(failure.observedStatus());
|
||||
assertEquals(0, oneWorker.getQueue().size());
|
||||
} finally { release.countDown(); oneWorker.shutdownNow(); assertTrue(oneWorker.awaitTermination(2, TimeUnit.SECONDS)); }
|
||||
}
|
||||
|
||||
@Test void defaultSystemProxySelectorCannotBypassDnsBinding() throws Exception {
|
||||
var original = java.net.ProxySelector.getDefault();
|
||||
var selections = new AtomicInteger();
|
||||
server.createContext("/", exchange -> { exchange.sendResponseHeaders(200, 1); exchange.getResponseBody().write('x'); exchange.close(); }); server.start();
|
||||
try {
|
||||
java.net.ProxySelector.setDefault(new java.net.ProxySelector() {
|
||||
@Override public java.util.List<java.net.Proxy> select(URI target) {
|
||||
selections.incrementAndGet();
|
||||
return java.util.List.of(new java.net.Proxy(java.net.Proxy.Type.SOCKS, new InetSocketAddress("127.0.0.1", 1)));
|
||||
}
|
||||
@Override public void connectFailed(URI target, java.net.SocketAddress address, java.io.IOException failure) { }
|
||||
});
|
||||
assertEquals(200, get("/", 3000, 1024).statusCode()); assertEquals(0, selections.get());
|
||||
} finally { java.net.ProxySelector.setDefault(original); }
|
||||
}
|
||||
|
||||
@Test void independentAttemptsRevalidateDnsAndNeverReuseCookiesOrThePreviousConnection() throws Exception {
|
||||
var calls = new AtomicInteger(); var lookups = new AtomicInteger();
|
||||
server.createContext("/", exchange -> {
|
||||
calls.incrementAndGet(); assertNull(exchange.getRequestHeaders().getFirst("Cookie"));
|
||||
exchange.getResponseHeaders().set("Set-Cookie", "synthetic=value; Secure");
|
||||
exchange.sendResponseHeaders(200, 1); exchange.getResponseBody().write('x'); exchange.close();
|
||||
}); server.start();
|
||||
PinnedHttpsTransport.AddressResolver resolver = host -> {
|
||||
if (lookups.incrementAndGet() == 3) throw new PinnedHttpsTransport.AddressRejectedException();
|
||||
return loopback(host);
|
||||
};
|
||||
assertEquals(200, transport.get(uri("/"), resolver, Duration.ofSeconds(3), 1024).statusCode());
|
||||
assertEquals(200, transport.get(uri("/"), resolver, Duration.ofSeconds(3), 1024).statusCode());
|
||||
assertEquals(BoundedHttpTransport.Reason.INVALID_ADDRESS, assertThrows(BoundedHttpTransport.Failure.class,
|
||||
() -> transport.get(uri("/"), resolver, Duration.ofSeconds(3), 1024)).reason());
|
||||
assertEquals(3, lookups.get()); assertEquals(2, calls.get());
|
||||
}
|
||||
|
||||
@Test void errorBodyLimitRetainsStatusAndIsSmallerThanTheImageLimit() {
|
||||
server.createContext("/", exchange -> { exchange.sendResponseHeaders(401, 1_000_000); exchange.close(); }); server.start();
|
||||
var failure = assertThrows(BoundedHttpTransport.Failure.class, () -> get("/", 3000, 8 * 1024 * 1024));
|
||||
assertEquals(BoundedHttpTransport.Reason.BODY_TOO_LARGE, failure.reason()); assertEquals(401, failure.observedStatus());
|
||||
}
|
||||
|
||||
@Test void oversizedResponseHeadersAreNotBufferedWithoutLimits() {
|
||||
server.createContext("/", exchange -> {
|
||||
exchange.getResponseHeaders().set("X-Large", "x".repeat(16 * 1024));
|
||||
exchange.sendResponseHeaders(200, 1); exchange.getResponseBody().write('x'); exchange.close();
|
||||
}); server.start();
|
||||
assertEquals(BoundedHttpTransport.Reason.IO, assertThrows(BoundedHttpTransport.Failure.class, () -> get("/", 3000, 1024)).reason());
|
||||
}
|
||||
}
|
||||
+18
@@ -322,6 +322,24 @@ class AsyncProviderClientTest {
|
||||
assertEquals("INVALID_MEDIA_URL", failure.getCode());
|
||||
}
|
||||
|
||||
@ParameterizedTest
|
||||
@CsvSource({"image,gpt-image-2", "video,sora-2", "image,gemini-3-pro-image-preview"})
|
||||
void localReferenceImageIsRejectedBeforeAnyGenerationPost(String type, String model) throws Exception {
|
||||
var calls = new java.util.concurrent.atomic.AtomicInteger();
|
||||
HttpServer server = HttpServer.create(new InetSocketAddress("127.0.0.1", 0), 0);
|
||||
server.createContext("/", exchange -> { calls.incrementAndGet(); exchange.sendResponseHeaders(500, -1); exchange.close(); }); server.start();
|
||||
try {
|
||||
var jdbc = mock(JdbcTemplate.class); var cipher = new SecretCipher("test-encryption");
|
||||
when(jdbc.queryForMap(any(String.class), eq("relay"))).thenReturn(Map.of("code", "relay", "protocol", "openai-compatible",
|
||||
"base_url", "http://127.0.0.1:" + server.getAddress().getPort(), "credential_ciphertext", cipher.encrypt("test-key")));
|
||||
var client = new AsyncProviderClient(jdbc, cipher, new ObjectMapper(), mock(Environment.class));
|
||||
var failure = assertThrows(ProviderRequestException.class, () -> client.submit("relay", model, type,
|
||||
Map.of("prompt", "synthetic", "media_url", "https://127.0.0.1/private")));
|
||||
assertEquals(ProviderRequestException.Acceptance.NOT_SENT, failure.acceptance()); assertEquals("INVALID_MEDIA_URL", failure.getCode());
|
||||
assertEquals(0, calls.get());
|
||||
} finally { server.stop(0); }
|
||||
}
|
||||
|
||||
private AsyncProviderClient clientFor(String baseUrl) {
|
||||
JdbcTemplate jdbc = mock(JdbcTemplate.class);
|
||||
SecretCipher cipher = new SecretCipher("test-encryption");
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
| SEC-03 | 改密与会话撤销、登录竞态 | 本轮已实现并验证:撤销全部会话、清 Cookie、行锁与二次校验 | 改密两种锁顺序、MFA 失败计数及审计回滚 |
|
||||
| SEC-04 | 任务用户隔离与回执安全 | 已实现核心用户级查询/幂等/冻结/核账,并补跨用户读取回归;完整授权审计仍待继续 | 跨用户读取/列表不可见;核账拒绝普通用户 |
|
||||
| SEC-05 | Provider 有界 HTTP Transport | 部分完成:异步 JSON/multipart/音频/媒体已接有界读取和总期限;同步/SSE 生命周期尚未统一抽取 | 超大 chunk、慢响应体、已观察拒绝状态、取消、重定向及原适配器回归 |
|
||||
| SEC-06 | 媒体下载出站 / SSRF | 部分加固但未闭环:体积/期限/重定向有界,DNS 重绑定窗口和保留地址复核仍待补 | 私网/保留地址、DNS 绑定或可信出站代理尚待完整验证 |
|
||||
| SEC-06 | 媒体下载出站 / SSRF | 服务端参考图下载的代码级 DNS 绑定已实现并通过本地回归;生产网络隔离与实际部署验收仍未完成 | 一次解析、整组地址校验、固定地址直连、原域名 TLS/SNI、禁代理与跳转;109 项新增回归,见 26 号文档 |
|
||||
| SEC-07 | 整体安全审查与生产验收 | 未完成:管理接口、注册/重置原子性、默认配置、依赖、备份恢复需继续 | 独立用例、部署与恢复演练,禁止宣称“全仓库安全” |
|
||||
| COD-01 | Codex 协议能力及验收矩阵 | 未实现完整兼容;保留有限文本 Responses 的明确拒绝语义 | 指定客户端版本、模型、工具和计费联合验收 |
|
||||
| COD-02 | Responses WebSocket 与响应归属续接 | 未实现,不可宣传完整 Codex 支持 | 原账号/凭据版本归属、断线、取消、租约、费用一致性 |
|
||||
@@ -31,8 +31,10 @@
|
||||
|
||||
## 实施边界
|
||||
|
||||
已补 SEC-01/02/03,下一优先级是 SEC-06 出站/DNS 绑定、同步 Transport 与完整 provider 配置版本,再处理 COD-01/02/03 的协议/续接/长请求合同。Codex WebSocket 与 OAuth 不是添加 URL 即可安全完成的能力,须连同状态归属、计量、预留续期和客户端验收逐步实施。未部署、未真实供应商验证或待设计的项必须保持未完成标记。
|
||||
已补 SEC-01/02/03 和 SEC-06 的本地下载代码边界,下一优先级是注册/密码重置事务审查、同步 Transport 与完整 provider 配置版本,再处理 COD-01/02/03 的协议/续接/长请求合同。SEC-06 的生产网络隔离仍属待验收。Codex WebSocket 与 OAuth 不是添加 URL 即可安全完成的能力,须连同状态归属、计量、预留续期和客户端验收逐步实施。未部署、未真实供应商验证或待设计的项必须保持未完成标记。
|
||||
|
||||
本轮设计与验证细节见 `25-auth-and-bounded-transport.md`。这份表按用户粘贴报告的锁定基线追踪本地实施,不把旧的 CPR 版本号冒充实时最新版,也没有重新部署 CPR。只做本地 Git commit,不 push,不修改业务数据库。
|
||||
|
||||
2026-10-21 本轮最终验证:247 项后端测试全部通过(含真实 PostgreSQL/Redis,0 跳过),前端构建与 25 项测试通过,另完成隔离改密界面交互检查。新增 GitHub 配置只保存本地,远端未执行。本轮没有把剩余 COD/SCH/出站/运营验收项目标为完成。
|
||||
|
||||
2026-10-21 媒体安全后续增量:使用 HttpClient 5.6.5 / HttpCore 5.4.4 重新执行 `mvn -B -o clean verify`,356 项后端测试通过(0 失败/错误/跳过),前端构建及 25 项测试通过。服务端本地下载不再使用 DNS 预检后交给 JDK 客户端二次解析的路径。用户指定的规格驱动验收尚未执行:`testingflow` 的 `.venv` 指向不存在的 Python,首个 `qa project list` 失败;没有绕过工具门禁,也没有自行批准规格。细节及下一步审阅范围见 `26-media-dns-binding-and-acceptance.md`。
|
||||
@@ -27,7 +27,7 @@
|
||||
|
||||
这还不是全项目统一 Transport:同步/SSE 的现有有界读取和整体 deadline 仍在原 Provider 生命周期内;长请求续租、逐 attempt 交付状态、统一取消与跨路由共享预算未完成。
|
||||
|
||||
**媒体 SSRF 仍未闭环。** 本阶段约束了响应体、总期限和重定向,但旧 DNS 预检与 JDK HTTP 实际解析之间的重绑定窗口仍存在,保留地址范围也需完整复核。不得标记 SEC-06 完成;生产应通过可信出站代理/网络策略控制访问,后续实现可证明的 DNS 绑定或等价控制。没有擅自更改业务网络或把任意用户 URL 加入可信名单。
|
||||
**该提交时的媒体 SSRF 尚未闭环。** 本阶段约束了响应体、总期限和重定向,但当时旧 DNS 预检与 JDK HTTP 实际解析之间的重绑定窗口仍存在。2026-10-21 的后续增量已用固定地址直连替换该路径,并补特殊地址范围回归,详见 `26-media-dns-binding-and-acceptance.md`;生产网络策略仍未验收。不能将本地下载修复扩大为全项目出站安全保证,也没有擅自更改业务网络或把任意用户 URL 加入可信名单。
|
||||
|
||||
## 工程验证与限制
|
||||
|
||||
|
||||
@@ -0,0 +1,46 @@
|
||||
# 媒体 DNS 绑定与功能验收状态
|
||||
|
||||
日期:2026-10-21。增量范围是服务端为 Gemini 图像输入、OpenAI 兼容图像编辑和视频参考图下载的 HTTPS 文件。不是完整生产安全审计,不涉及 CPR 部署、业务数据迁移或付费上游生成。
|
||||
|
||||
## 已实现边界
|
||||
|
||||
- `provider.media.PublicMediaAddressPolicy`:校验 HTTPS URI,拒绝 userinfo、fragment、zone ID 与非法端口。DNS 答案整组校验;只要存在非公开/特殊用途地址就全部拒绝,不选择其中的公网地址继续。答案为空、含 null 或超过 16 个地址同样拒绝。IPv4 覆盖本机、私网、共享地址、链路本地、基准测试、文档、组播、保留地址和平台虚拟地址;IPv6 仅接受原生 global-unicast 候选,排除特殊、文档、6to4、已退役 6bone 等前缀。策略采用保守拒绝,某些特殊用途的实际可达地址也可能被拒绝。
|
||||
- `provider.transport.PinnedHttpsTransport`:每次调用只向系统解析一次,经策略验证后使用这份不可变地址集合连接。HTTP 库自己的 DNS 回调只返回该集合,不调用系统 DNS,也不反向解析。URI 始终保留原域名,Host、TLS 证书链、主机名校验和 SNI 不替换为 IP;证书校验未放宽。
|
||||
- 路由层固定直连,底层 Socket 显式 `Proxy.NO_PROXY`,防止 JVM 的系统 SOCKS 代理绕过本地 DNS 绑定。没有自动跳转、HTTP 重试、Cookie 管理、认证缓存或跨下载连接复用;不接受任意请求头、上游 Key 或浏览器 Cookie。
|
||||
- 15 秒总期限覆盖 DNS、连接、TLS 和整个响应体;超时/中断取消 socket,调用方中断标志保留。DNS 原生实现可能不能及时中断,迟到的解析结果会检查取消状态,不能在超时后再发起 HTTP。最多 8 个后台工作线程、无等待队列;饱和直接安全失败,避免无限积压。
|
||||
- 成功体最多 8 MiB,错误体最多 64 KiB;声明超限提前拒绝,chunked 在读取过程中计数。HTTP/1 响应行最多 8192 字符、头数量最多 64。禁自动解压,拒绝非 identity 的 Content-Encoding。先取消再关闭,关闭时不排空超大/无限响应,清理异常不覆盖主要超限原因。
|
||||
- `provider.media.MediaDownloader` 只负责文件输入、MIME 类型及域错误映射;`AsyncProviderClient` 不再自行执行 DNS 策略。模块不依赖凭据、路由、风控、认证或账务,新增依赖方向检查。媒体下载失败仍是生成之前的 `NOT_SENT`,不制造“上游已受理未知”的结果。
|
||||
|
||||
## 依赖与本地验证
|
||||
|
||||
新模块使用 Apache HttpClient **5.6.5** 和配套 HttpCore **5.4.4**,在 POM 中固定属性,不沿用 Spring Boot 3.4.5 管理的旧组合,也不采用 5.7 alpha。版本在 2026-10-21 通过 Maven Central metadata/POM 与 Apache 官方发布记录核对;这不是完整依赖漏洞扫描或零漏洞承诺。参考资料:
|
||||
|
||||
- Apache 发布记录:`https://hc.apache.org/news.html`
|
||||
- HttpClient 父 POM:`https://repo.maven.apache.org/maven2/org/apache/httpcomponents/client5/httpclient5-parent/5.6.5/httpclient5-parent-5.6.5.pom`
|
||||
|
||||
最终后端命令为 `mvn -B -o clean verify`,Java 21 / Maven 3.9.9 容器,共享本机依赖缓存。**356 项测试,0 失败、0 错误、0 跳过,JAR 构建成功**;结束时间 2026-10-21 22:44:03(Asia/Shanghai)。相对前一基线增加 109 项:76 项 URI/地址策略、13 项下载域边界、16 项真实本地 HTTPS 传输、3 项适配器发送前语义,以及 1 项模块依赖方向检查。
|
||||
|
||||
TLS 测试用 keytool 临时生成 `.test` 证书,仅测试客户端信任该证书;默认客户端必须拒绝它,可信但域名不匹配同样拒绝。测试还验证原 Host/SNI、DNS 只查一次、后续下载重新校验、Cookie 不复用、系统 SOCKS 代理不被读取、重定向不跟随、超限/响应头/压缩/慢体/中断/DNS 迟到和无队列饱和。没有通过关闭证书校验来获得绿灯。
|
||||
|
||||
数据库测试使用本轮独立 PostgreSQL 15.18 和 Redis 7 容器,共享隔离 network namespace,未映射业务数据库端口、未连接业务库。前端 `npm run build` 和 `npm test` 也通过,25 项测试零失败。日志 `.tools/media-dns-final-verify.log` 与构建目录忽略,不进入 Git。提交前再执行 `git diff --check`、逐路径检查差异与暂存区,只本地提交,不 push。
|
||||
|
||||
## 尚未完成的安全边界
|
||||
|
||||
本增量只证明上述本地下载路径。传给供应商由其下载的 URL、同步聊天输入中的第三方 URL、浏览器展示结果文件、管理员配置的 Provider Base URL 不属于这条下载路径;不能将它们标成已通过该策略。未知 NAT64/自定义翻译前缀、透明代理、组织路由将公网 IP 引向内部服务等部署行为,需要网络 egress ACL/防火墙控制;地址表也要随地址分配变化维护。生产出站允许范围、部署连通性和真实供应商兼容性均未验收。
|
||||
|
||||
图片目前校验媒体类型和字节大小,不解码文件、扫描内容或限制解码后像素;MIME 声明不是内容真实性保证。并发数 8 是保守传输资源上限,不是租户公平队列;长请求续租、完整 Provider 配置版本、WebSocket 续接、公平调度与备份恢复仍在 24 号任务表中保持待完成。
|
||||
|
||||
## 规格驱动验收的真实状态
|
||||
|
||||
已按用户指定的 `spec-driven-acceptance-testing` 读取完整技能、方法决策表、字段格式、框架 README 和模板。技能记录的 `E:/PROJECT/xpp_dev_agent` 在当前主机不存在,实际框架位于 `D:/PROJECT/xpp_dev_agent/dev-test`,档案目录位于同级 `qa-projects`。
|
||||
|
||||
首先执行了框架规定的项目发现命令:
|
||||
|
||||
```powershell
|
||||
# 工作目录 D:\PROJECT\xpp_dev_agent\dev-test
|
||||
.\.venv\Scripts\python.exe -m qa project list
|
||||
```
|
||||
|
||||
退出码 **1**,提示 Python 路径 `C:/Users/xpp/.conda/envs/ctf/python.exe` 不存在;`.venv/pyvenv.cfg` 仍记录旧的 E 盘创建路径。因此尚未完成项目登记/体检,**未创建或批准业务规格、未执行 `qa run --project`,没有验收报告可交付**。没有手动读取档案代替项目命令、改写共享 Python 环境、绕过批准门禁,或把本轮 Maven/前端测试冒称规格驱动验收。
|
||||
|
||||
后续先确认并修复共享框架环境,成功运行项目发现/体检;项目不存在时按 `qa project init` 建档并只填写源码核实的事实。首批建议审阅范围是隔离环境下匿名访问拒绝、普通用户/管理员权限、任务跨用户隔离、改密撤销会话、错误响应不暴露凭据,以及媒体失败不发起生成。规格始终先 draft,必须向用户展示具体输入、预期与清理步骤,获明确批准后才记录批准并执行。变更真实账号、付费模型调用和生产环境测试不在当前授权范围。
|
||||
Reference in new issue
Block a user