From 31d3c0857d7c8beb71b088edeff61a39df100f7d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Mon, 28 Sep 2026 18:45:46 +0800 Subject: [PATCH] =?UTF-8?q?fix(=E5=AE=89=E5=85=A8):=20X-Internal-Token=20?= =?UTF-8?q?=E4=B8=8D=E5=86=8D=E7=BB=95=E5=BC=80=E7=94=A8=E6=88=B7=E6=80=81?= =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E7=9A=84=20user=5Fid=20=E5=BD=92=E5=B1=9E?= =?UTF-8?q?=E7=BB=91=E5=AE=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 守卫里"令牌可信即在 shouldNotFilter 整体放行"把刚上线的绑定又开了一个洞:这把 X-Internal-Token 是硬编码在分发出去的桌面客户端里的静态共享密钥(amazon/tool.py:20、 crawler_core/log_uploader.py:38),它能证明"走了内部通道",证明不了"这个 user_id 是谁"。 带 JWT + 这把钥匙的请求因此完全不参与绑定,等于给别人令牌就能读任意 user_id。 改法只拆语义不加开关:令牌继续豁免"要不要凭据"(否则仅凭令牌即鉴权的 /api/admin/shop-manages/credential 会被误拦 401),不再豁免"归属归谁"。 管理员/超管代客操作豁免照旧。 对现网零影响的取证:全工作区 .py 里 operatorId/operator_id 出现 0 处,所以纯令牌请求 进 requireUserOrInternal 后无 JWT→resolveToken 即抛→identity=null→绑定不触发; 不带 user_id 的按 task_id 回调仍然整体跳过守卫(新用例用 verify(never()) 守住)。 AdminApiGuardFilterTest 30 个用例全绿;新增 4 个,其中 internalTokenDoesNotBypassOwnershipBinding 在改代码前是红的,就是那个洞的可执行证明。 --- .../aiimage/config/AdminApiGuardFilter.java | 21 +++-- .../config/AdminApiGuardFilterTest.java | 80 +++++++++++++++++++ 2 files changed, 96 insertions(+), 5 deletions(-) diff --git a/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java b/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java index 406c535e5..69621e8cf 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java +++ b/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java @@ -40,10 +40,14 @@ import java.util.stream.Collectors; * 访问的 /api/admin 接口(如权限菜单列表仅 requireUser)。 * *

对 USER_TOOL_PREFIXES 另有一条**不依赖开关**的收紧:请求带 {@code user_id} 参数且本次能解析出 - * JWT 登录身份时,参数必须等于登录身份,否则返回 403——这些接口的数据归属从此不再由请求参数说了算。 + * 身份时,参数必须等于该身份,否则返回 403——这些接口的数据归属从此不再由请求参数说了算。 * 管理员/超管豁免(后台按客户查任务是本职)。匿名请求解析不出身份,因而完全不受影响:按 2026-09-28 - * 取证,桌面端调用这 14 个前缀的 15 个文件里只有 4 个带过凭据头,且带的都是 X-Internal-Token - * (在 shouldNotFilter 里就整体放行,同样不参与绑定)。"要求凭据"这一步只能等客户端铺开后再开 + * 取证,桌面端调用这 14 个前缀的 15 个文件里只有 4 个带过凭据头,且带的都是 X-Internal-Token。 + * + *

X-Internal-Token **不再**是绕开归属绑定的通行证(2026-09-28 补):它是硬编码在分发客户端里的 + * 静态共享密钥,能证明"走了内部通道",证明不了"这个 user_id 是谁";此前 shouldNotFilter 一见可信令牌 + * 就整体跳过过滤器,等于把刚收紧的绑定又开一个洞。收窄后纯令牌请求(不带 JWT、不带 operatorId)在 + * doFilterInternal 里仍解析不出身份、行为不变,存量客户端零影响。"要求凭据"这一步只能等客户端铺开后再开 * (user-tool-guard-enabled,配合 user-tool-guard-prefixes 按前缀分批收)。 * *

豁免项:OPTIONS 预检;以及 aiimage.security.admin-guard-exempt-prefixes 配置的前缀 @@ -150,10 +154,17 @@ public class AdminApiGuardFilter extends OncePerRequestFilter { if ("OPTIONS".equalsIgnoreCase(request.getMethod())) { return true; } - // 可信内部令牌(X-Internal-Token 匹配服务端配置)直接放行:让"仅凭令牌即鉴权"的 + // 可信内部令牌(X-Internal-Token 匹配服务端配置)放行"需要凭据"这一半:让"仅凭令牌即鉴权"的 // 内部端点(如 /api/admin/shop-manages/credential)由 controller 自校验令牌兜底, // 避免 guard 把它们误拦为 401。放行后仍可达 controller,不会裸露敏感端点。 - if (adminAuthSupport.isTrustedInternalToken(request)) { + // + // 但归属绑定不随令牌豁免:这个令牌是硬编码在分发出去的桌面客户端里的静态共享密钥 + // (app_client/amazon/tool.py 与 crawler_core/log_uploader.py 各有一份字面量),拿到任意一份 + // 安装包即可伪造,它证明的是"内部通道"而不是"这个 user_id 是谁"。因此带 user_id 的用户态请求 + // 必须继续进 doFilterInternal 解析身份。2026-09-28 取证:全工作区 Python 调用方没有一处传 + // operatorId/operator_id,requireUserOrInternal 对纯令牌请求解析不出身份(绑定不触发), + // 所以这条收窄对存量客户端零影响,只挡住"伪造令牌 + 冒名 user_id"。 + if (adminAuthSupport.isTrustedInternalToken(request) && !needsOwnershipBinding(request, uri)) { return true; } for (String prefix : exemptSet()) { diff --git a/backend-java/src/test/java/com/nanri/aiimage/config/AdminApiGuardFilterTest.java b/backend-java/src/test/java/com/nanri/aiimage/config/AdminApiGuardFilterTest.java index 197fa9969..a45a48014 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/config/AdminApiGuardFilterTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/config/AdminApiGuardFilterTest.java @@ -488,6 +488,86 @@ class AdminApiGuardFilterTest { assertThat(otherChain.getRequest()).as("未列入清单的前缀本轮不动,留给客户端铺开后再收").isNotNull(); } + // ---- X-Internal-Token 的豁免不能把"归属绑定"一起绕开(2026-09-28 发现) ---- + // 令牌是硬编码在桌面客户端里的静态共享密钥(amazon/tool.py:20,32 字符字面量,随客户端分发给每个用户), + // 而旧逻辑在 shouldNotFilter 里对"令牌可信"的请求**整体跳过**过滤器,包括带 user_id 的用户态前缀。 + // 于是刚上线的 user_id↔JWT 绑定对"同时带 JWT 与内部令牌"的请求完全不生效 —— 拿别人 JWT + 自己客户端里的 + // 这把钥匙,就能读任意 user_id 的数据。 + + @Test + void internalTokenDoesNotBypassOwnershipBinding() throws Exception { + AdminAuthSupport authSupport = mock(AdminAuthSupport.class); + when(authSupport.isTrustedInternalToken(any())).thenReturn(true); + when(authSupport.requireUserOrInternal(any())).thenReturn(user(7L, "user")); + when(authSupport.currentRole(any())).thenReturn("user"); + AdminApiGuardFilter filter = newFilter(authSupport, true, "", false); + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/query-asin/tasks/detail"); + request.setParameter("user_id", "8"); + MockHttpServletResponse response = new MockHttpServletResponse(); + MockFilterChain chain = new MockFilterChain(); + + filter.doFilter(request, response, chain); + + assertThat(chain.getRequest()).as("内部令牌不能成为冒读他人数据的通行证").isNull(); + JsonNode body = objectMapper.readTree(response.getContentAsString()); + assertThat(body.path("code").asInt()).isEqualTo(403); + } + + /** + * 真实客户端形状必须不受影响:`price_match_new.py:1292` 就是"内部令牌 + user_id、无 JWT、无 operatorId" + * 往 /api/shop-match/** 回调。这类请求解析不出登录身份,绑定不该拦它(也拦不了——没有身份可比)。 + */ + @Test + void internalTokenWithoutLoginIdentityIsNotBound() throws Exception { + AdminAuthSupport authSupport = mock(AdminAuthSupport.class); + when(authSupport.isTrustedInternalToken(any())).thenReturn(true); + when(authSupport.requireUserOrInternal(any())).thenThrow(new BusinessException(401, "未登录")); + AdminApiGuardFilter filter = newFilter(authSupport, true, "", false); + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/query-asin/tasks/detail"); + request.setParameter("user_id", "8"); + MockHttpServletResponse response = new MockHttpServletResponse(); + MockFilterChain chain = new MockFilterChain(); + + filter.doFilter(request, response, chain); + + assertThat(chain.getRequest()).isNotNull(); + assertThat(response.getContentAsString()).isEmpty(); + } + + /** 按 task_id 回调、不带 user_id 的内部令牌请求:仍整体豁免,不因为它多跑一遍身份解析。 */ + @Test + void internalTokenOnTaskScopedCallbackStaysExempt() throws Exception { + AdminAuthSupport authSupport = mock(AdminAuthSupport.class); + when(authSupport.isTrustedInternalToken(any())).thenReturn(true); + AdminApiGuardFilter filter = newFilter(authSupport, true, "", false); + MockHttpServletRequest request = new MockHttpServletRequest("POST", "/api/shop-match/tasks/7123/stage-finished"); + MockHttpServletResponse response = new MockHttpServletResponse(); + MockFilterChain chain = new MockFilterChain(); + + filter.doFilter(request, response, chain); + + assertThat(chain.getRequest()).isNotNull(); + verify(authSupport, never()).requireUserOrInternal(any()); + } + + /** 管理员用内部令牌代客操作是本职,豁免照旧。 */ + @Test + void adminInternalOperatorIsStillExemptFromBinding() throws Exception { + AdminAuthSupport authSupport = mock(AdminAuthSupport.class); + when(authSupport.isTrustedInternalToken(any())).thenReturn(true); + when(authSupport.requireUserOrInternal(any())).thenReturn(user(1L, "admin")); + when(authSupport.currentRole(any())).thenReturn("admin"); + AdminApiGuardFilter filter = newFilter(authSupport, true, "", false); + MockHttpServletRequest request = new MockHttpServletRequest("GET", "/api/query-asin/tasks/detail"); + request.setParameter("user_id", "8"); + MockHttpServletResponse response = new MockHttpServletResponse(); + MockFilterChain chain = new MockFilterChain(); + + filter.doFilter(request, response, chain); + + assertThat(chain.getRequest()).isNotNull(); + } + private AdminUserEntity user(Long id, String role) { AdminUserEntity user = new AdminUserEntity(); user.setId(id);