docs(鉴权): 同类注释三处一起订正——执行器的身份来自 Session.request 钩子,不是调用点

PublishTaskService:1360 与 PublishOwnershipGuardrailTest 的立项理由都写成"执行器带
X-Internal-Token 不带 operatorId",AdminAuthSupport 的 resolve 注释写成"桌面客户端不带凭据"。
三处同源同错:add_product.py 那两条调用点 headers 只有 Content-Type,身份是
app_client/crawler_core/user_token.py 包 requests.Session.request 补的 Authorization: Bearer
(main.py:2115 装钩子、窗口桥 set_user_token 交令牌、执行器与页面同进程且未登录即跳过本轮),
4.0.14(96cf19b) 起随包出厂。留在匿名分支里的只是 4.0.14 之前的存量装机,
翻 require 的时机因此由升级通道决定,不是"桌面端整体不能翻"。
守卫扫的那句 "GET /tasks/{id}/items 与 POST /tasks/{id}/result" 原样保留(计数回读=1)。
This commit is contained in:
2026-10-07 23:47:57 +08:00
parent d93167eb8f
commit 5b310986bb
3 changed files with 12 additions and 6 deletions
@@ -212,7 +212,9 @@ public class AdminAuthSupport {
*
* <p>解析得出身份时:参数缺省就用会话 id("省略 user_id 时由 taskId 反查"从此不再是无归属通道);
* 参数与会话不一致直接 403(数据归属不再由请求参数说了算);管理角色豁免。
* 解析不出身份时原样返回参数——桌面客户端不带凭据也不带 operatorId,这条给它们留滚动窗口,
* 解析不出身份时原样返回参数——留在这一支的不是"桌面端整体",而是<b>不带登录 JWT 的存量装机</b>
* (4.0.14 之前;此后身份由 {@code app_client/crawler_core/user_token.py} 的
* {@code requests.Session.request} 钩子统一注入),这条给它们留滚动窗口,
* "必须带凭据"那一步由 aiimage.security.user-tool-guard-enabled 开关控制。</p>
*/
public Long resolveOwnershipUserId(HttpServletRequest request, Long requestedUserId) {
@@ -1357,9 +1357,10 @@ public class PublishTaskService {
throw new BusinessException("taskId 不合法");
}
// user_id 为空**不**等于跳过归属校验:这里留空只允许出现在桌面执行器的两个端点上
// (GET /tasks/{id}/items 与 POST /tasks/{id}/result,它们带 X-Internal-Token 但不带 operatorId,
// 服务端解析不出身份)。其余端点一律由 PublishController 用 requireOwnershipUserId 传入会话身份,
// 缺失即 401、冒名即 403。
// (GET /tasks/{id}/items 与 POST /tasks/{id}/result——执行器的身份由客户端
// crawler_core/user_token.py 的 Session.request 钩子补 Authorization: Bearer,4.0.14 之前的
// 存量装机不带,服务端才解析不出身份、userId 才落到 null)。其余端点一律由 PublishController
// 用 requireOwnershipUserId 传入会话身份,缺失即 401、冒名即 403。
FileTaskEntity task = fileTaskMapper.selectById(taskId);
if (task == null || !MODULE_TYPE.equals(task.getModuleType())
|| (userId != null && !userId.equals(task.getUserId()))) {
@@ -20,8 +20,11 @@ import static org.assertj.core.api.Assertions.assertThat;
* <li>带 user_id 的端点分母钉死(查询参数 8 个 + 请求体 4 个 = 12 个走会话推导)。
* 其中 10 个走 {@code requireOwnershipUserId}(解析不出登录身份即 401,网页端/后台专用),
* 2 个走 {@code resolveOwnershipUserId}——只有执行器可达的 {@code items}(取数)和
* {@code result}(回传):桌面端只带 X-Internal-Token、不带 operatorId,给它俩加 require
* 等于把上架整条链路挡在 401。resolve 对匿名请求是原样透传,对带凭据的请求仍然冒名即 403。</li>
* {@code result}(回传)。执行器的身份不是调用点写的({@code add_product.py} 那两处 headers 只有
* Content-Type),而是客户端 {@code crawler_core/user_token.py} 包 {@code requests.Session.request}
* 的钩子统一补的 {@code Authorization: Bearer},随包出厂自 4.0.14({@code 96cf19b})起;
* 所以"解析不出身份"的那总体是 4.0.14 之前的存量装机,给这俩加 require 就是把他们整条上架挡在 401。
* resolve 对匿名请求是原样透传,对带凭据的请求仍然冒名即 403。</li>
* <li>"null 即跳过归属校验"这个形状在服务层只能剩 1 处(publish 的 requireTaskRecord,
* 为执行器留的口子),外观专利与货源的 4 处已改为无条件比对。</li>
* </ol>