feat(phase-1): AC-7 数据读取按归属收口、AC-8 匿名写端点要凭据

清空全部历史(ImageHistoryController/Service)不再接受请求参数里的
user_id 当归属:改走 DataReadScope.readScope(...).userIdsOr(),scope 为空
集时 service 直接 log.warn + return 0,绝不退化成"不筛=全库"。每日档下载
(AdminShopDataCrawlTasksController/ShopDataCrawlAdminTasksService)同样按
可见店铺 key 校验,越权回 BusinessException(403) 而非静默返回别人的文件。

AdminApiGuardFilter 新增 CREDENTIALED_WRITE_PATHS:/api/files/upload 与
/api/tasks/{id}/interrupted 这两个此前带 X-Internal-Token 即可匿名的写端点
改为解析不出身份即 401——静态共享密钥能证明走了内部通道,证明不了是谁。
该判定不吃 user-tool-guard-enabled 总闸,纯令牌存量客户端行为不变。

激活 Phase 0 预置的 3 支 pending 契约(AnonymousWriteGuard / HistoryClearScope /
DailyFileOwnership,去 @Disabled),另补 ImageHistoryServiceTest 迁移 + 2 例、
ShopDataCrawlAdminTasksDailyFileOwnershipTest 6 例行为判据。目标 127 例 0 失败。

他人的 collectdata in-flight 改动(CollectDataService/CollectDataHistoryItemVo/
BrandCollectDataTab/collect-data.ts 等)未卷入本提交。
This commit is contained in:
2026-10-28 17:03:24 +08:00
parent b3d90d2161
commit 0e2af88184
10 changed files with 307 additions and 27 deletions
@@ -51,6 +51,14 @@ import java.util.stream.Collectors;
* doFilterInternal 里仍解析不出身份、行为不变,存量客户端零影响。"要求凭据"这一步只能等客户端铺开后再开
* (user-tool-guard-enabled,配合 user-tool-guard-prefixes 按前缀分批收)。
*
* <p>两条写端点不再等总闸(2026-10-28 补,S0-7/AC-8):{@code POST /api/files/upload} 与
* {@code POST /api/tasks/{id}/interrupted} 收进 {@code CREDENTIALED_WRITE_PATHS}/
* {@code TASK_INTERRUPTED_SUFFIX},{@code user-tool-guard-enabled=false}(出厂默认)不再是它们的
* 豁免理由——匿名遍历 taskId 就能把别人的 RUNNING 任务置 FAILED,匿名上传能塞满临时盘。
* 可信内部令牌照常放行(4.0.66 客户端带令牌;旧客户端在这一跳会拿到 body.code=401,
* 崩溃残留上报退回服务端 stale 兜底,最长 30 分钟)。同前缀的 {@code pull-pending} 与
* {@code heartbeat} 不受影响:那条前缀下还有匿名直连的 worker 在用。
*
* <p>豁免项:OPTIONS 预检;以及 aiimage.security.admin-guard-exempt-prefixes 配置的前缀
* (逗号分隔,用于内部自动化/设备回调等确需匿名可达的端点)。紧急回退:
* aiimage.security.admin-guard-enabled=false 关闭本过滤器。
@@ -127,6 +135,13 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
"/api/user/cost-guard",
};
/** 必须解析得出身份才放行的确切写路径(S0-7/AC-8),不受 {@code user-tool-guard-enabled} 豁免。 */
private static final String[] CREDENTIALED_WRITE_PATHS = {"/api/files/upload"};
/** 打断任务这条动作:只收 {@code /api/tasks/{id}/interrupted},不动同前缀的 pull-pending/heartbeat。 */
private static final String TASK_PATH_PREFIX = "/api/tasks/";
private static final String TASK_INTERRUPTED_SUFFIX = "/interrupted";
private final AdminAuthSupport adminAuthSupport;
private final ObjectMapper objectMapper;
@@ -242,6 +257,14 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
writeFailure(response, code, ex.getMessage());
return;
}
if (identity == null && isCredentialRequiredWriteEndpoint(uri)) {
// 这两条写端点不接受"解析不出身份也照样往下走":requireUserOrInternal 对
// 某些空凭据形状是返回 null 而不是抛(S0-7 取证),只靠上面的 catch 会漏成放行。
log.warn("[admin-guard] {} {} 匿名写请求被拒:该端点不受 user-tool-guard-enabled 豁免",
request.getMethod(), uri);
writeFailure(response, 401, "未登录");
return;
}
} else {
// 归属绑定只约束"能解析出身份"的请求:存量匿名客户端(不带 JWT)解析不出身份,行为不变。
try {
@@ -308,6 +331,10 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
if (matchesPrefix(uri, ADMIN_API_PREFIX) || matchesPrefix(uri, DEBUG_PREFIX)) {
return true;
}
if (isCredentialRequiredWriteEndpoint(uri)) {
// S0-7/AC-8:匿名能打断别人的任务、匿名能塞满临时盘,这两条不挂总闸
return true;
}
for (String prefix : SELF_SERVICE_PREFIXES) {
if (matchesPrefix(uri, prefix)) {
return true;
@@ -316,6 +343,24 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
return userToolGuardEnabled && isUserToolPrefix(uri) && listedForGuard(uri);
}
/**
* 这两条写端点是否必须"解析得出身份"(或可信内部令牌)才放行——S0-7 收口。
*
* <p>刻意不收整条 {@code /api/tasks}:同前缀的 {@code pull-pending} 与 heartbeat 有
* 匿名直连的 worker 在用,蓝图 §3.1 只点名 interrupted 与 {@code /api/files/upload}。
* 收的是**确切路径 / 前后缀都对得上**的那一条动作,多一个字符都不算。
*/
static boolean isCredentialRequiredWriteEndpoint(String uri) {
String path = uri == null ? "" : uri;
for (String exact : CREDENTIALED_WRITE_PATHS) {
if (path.equals(exact)) {
return true;
}
}
return path.startsWith(TASK_PATH_PREFIX) && path.endsWith(TASK_INTERRUPTED_SUFFIX)
&& path.length() > TASK_PATH_PREFIX.length() + TASK_INTERRUPTED_SUFFIX.length();
}
/** 未强制要求凭据的用户态前缀:只要带了 user_id 参数,归属就得和令牌身份对齐。 */
private boolean needsOwnershipBinding(HttpServletRequest request, String uri) {
if (!isUserToolPrefix(uri)) {