Files
ssw-ontology/server
adminandClaude Code 25bbd15fd6 fix(authz): 封堵 X-Principal 头越权洞(裸头即可取得 manager)
principalFromRequest 曾把客户端可任意设置的 X-Principal 请求头列为最高
优先级、且完全不校验地决定主体。任何能发 HTTP 请求的一方带一个
X-Principal: manager 即取得平台最高权限;managerAuth /
ingestOrManagerAuth / mcpAuth / connectorAuth 读路径过滤全部沦陷。
该头排在真实凭据之前,合法的低权限 key 配该头即提权。

修复:外部入口一律不认该头,主体只来自真实凭据。
- 新增 server/principal_ctx.go:主体挂在 *http.Request 的 context 上。
  context 由代码构造、网络请求携带不了,外部伪造不命中。
- callHandler / mcpCall 两处进程内自调用改走 context 注入。
  callConn 不动(v2 已透传调用方真实 api_key / session cookie)。
- review-kit 代理 mcp-review-proxy.js 的 CORS 允许头去掉 X-Principal:
  该代理是 Access-Control-Allow-Origin: * 且原本显式放行该头,
  任意网页 JS 可借它伪造身份(main.go 的 corsMiddleware 管不到这条路)。

不采用降优先级 / 回环 IP 白名单 / 内部签名头——三者都仍留下一条外部
可构造的提权路径。

测试:新增 server/xprincipal_authz_test.go 覆盖匿名伪造(managerAuth 401 /
ingestOrManagerAuth 403 / mcpAuth 401)、该头不覆盖已解析的真实主体、
真实 manager key 仍放行;集成测试 60 处 X-Principal: manager 测试捷径
改为查库取真实 api_key。变异检查确认 MCP 进程内路径确实依赖新注入。

顺带转绿既有的 TestIntegration_ClassificationFilter:共享测试库 5 个主体
均已配 api_key,connectorAuth 要求 X-API-Key 而该测试只带 X-Principal,
迁移后自然修复。

验证:go test ./server/... 与 go test -tags=integration ./server/... 全绿;
./build.sh 通过(server/reviewkit 是 //go:embed 的,需重新编译进二进制)。
server/ai 的 TestHeuristicA5 仍红,是仓库外硬编码 fixture 路径不存在,
与本次无关。

Co-Authored-By: Claude Code <[email protected]>
2026-10-17 12:14:47 +08:00
..