fix(安全): X-Internal-Token 不再绕开用户态接口的 user_id 归属绑定

守卫里"令牌可信即在 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
在改代码前是红的,就是那个洞的可执行证明。
This commit is contained in:
2026-09-28 18:45:46 +08:00
parent 812ac31a48
commit 31d3c0857d
2 changed files with 96 additions and 5 deletions
@@ -40,10 +40,14 @@ import java.util.stream.Collectors;
* 访问的 /api/admin 接口(如权限菜单列表仅 requireUser)。
*
* <p>对 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。
*
* <p>X-Internal-Token **不再**是绕开归属绑定的通行证(2026-09-28 补):它是硬编码在分发客户端里的
* 静态共享密钥,能证明"走了内部通道",证明不了"这个 user_id 是谁";此前 shouldNotFilter 一见可信令牌
* 就整体跳过过滤器,等于把刚收紧的绑定又开一个洞。收窄后纯令牌请求(不带 JWT、不带 operatorId)在
* doFilterInternal 里仍解析不出身份、行为不变,存量客户端零影响。"要求凭据"这一步只能等客户端铺开后再开
* (user-tool-guard-enabled,配合 user-tool-guard-prefixes 按前缀分批收)。
*
* <p>豁免项: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()) {