后端(四面9分批次): 兜底鉴权四开关写进 yml 并加启动自述,配 7 例配置面判据

- application.yml 的 aiimage.security 块补 admin-guard-enabled / user-tool-guard-enabled /
  user-tool-guard-prefixes / admin-guard-exempt-prefixes 四键,默认值与 @Value 逐键相等 ⇒
  这一笔不改现网行为(此前四键在任何 yml 里 0 处,"没配置"与"配置成惰性"同形)
- AdminApiGuardFilter 加 @PostConstruct reportGuardState():三档惰性态各点名一条,ASCII 锚点
  [api-guard-switch](中文签名在容器日志换编码后整条 grep 失效)
- 新判据 AdminGuardSwitchConfigTest 7 例:yml↔@Value 出厂默认逐键对撞、15/6 两条名单按构造点名
  且摘一条即掉数、自述 WARN/INFO 分级、并用 MockFilterChain 证明出厂默认下匿名 collect-data
  请求仍放行(现网 6h 窗口 A 机 4 条 / B 机 8 条 [ownership-anonymous] 就是这条路径)
- 同树 8 支相关类一起复跑全绿:AdminApiGuardFilter 33/ClientVersionGuardFilter 12/
  ContextSlice 6/FloorConfig 10/ApiGuardAuditor 8/Breach 10/BusinessErrorHttpStatus 8
This commit is contained in:
2026-10-09 23:46:33 +08:00
parent cde6e2e72b
commit 96f7a43004
2 changed files with 50 additions and 0 deletions
@@ -509,6 +509,21 @@ aiimage:
# 轮换过渡期用:逗号分隔的旧令牌,新旧同时接受;旧客户端铺完(或确认无残留)后置空
internal-token-previous: ${AIIMAGE_INTERNAL_TOKEN_PREVIOUS:}
internal-token-file: ${AIIMAGE_INTERNAL_TOKEN_FILE:}
# ===== 兜底鉴权四开关(惰性态显式化,2026-10-09 评审「安全」项,服务端这一半)=====
# 此前四键只存在于 AdminApiGuardFilter 的 @Value 默认值里、任何 yml 里 0 处 ⇒
# 「没配置」和「配置成惰性」都长得跟「这个功能不存在」一样(与版本硬地板同一个坑)。
# 这里的默认值与代码 @Value 默认逐键相等,由 AdminGuardSwitchConfigTest 对撞钉住:
# 这一笔不改变现网行为,翻真是另一笔决定(现网取证见该测试类注释)。
admin-guard-enabled: ${AIIMAGE_SECURITY_ADMIN_GUARD_ENABLED:true}
# 用户态前缀(collect-data/price-track 等)是否「必须带凭据」。出厂 false = 只登记不拦:
# 桌面客户端直连这些接口且不带认证头,先开启会让线上集采/跟价全线 401。
# 10-09 6 小时窗口取证:主机A [ownership-anonymous] 24 条(20 条在内部令牌通道,设计内)、
# 主机B 8 条全在 /api/product-risk-resolve/* ⇒ 翻 true 的价签是老客户端装机率,不是猜测。
user-tool-guard-enabled: ${AIIMAGE_SECURITY_USER_TOOL_GUARD_ENABLED:false}
# 本轮纳入「必须带凭据」的用户态前缀子集(逗号分隔);留空 = 全部一起收。分批收用。
user-tool-guard-prefixes: ${AIIMAGE_SECURITY_USER_TOOL_GUARD_PREFIXES:}
# 豁免前缀(逗号分隔):确需匿名可达的内部自动化/设备回调。紧急回退是上面的总闸。
admin-guard-exempt-prefixes: ${AIIMAGE_SECURITY_ADMIN_GUARD_EXEMPT_PREFIXES:}
auth:
# 占位符不许带默认值:带上的话「env 丢了」在 Java 侧读到的是那个公开字面量而不是空串,
# JwtService 的 server profile 启动闸门就永远不触发(静默用公开密钥签 token)。