后端(四面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
@@ -6,6 +6,7 @@ import com.nanri.aiimage.common.exception.BusinessException;
import com.nanri.aiimage.common.model.entity.AdminUserEntity;
import com.nanri.aiimage.common.security.AdminAuthSupport;
import com.nanri.aiimage.common.security.DeviceSessionPolicy;
import jakarta.annotation.PostConstruct;
import jakarta.servlet.FilterChain;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
@@ -149,8 +150,42 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
private String exemptPrefixes;
/** 用户态接口的数据归属参数:收紧前它由客户端随意填。 */
/** 巡检/发布记录用的 ASCII 锚点:三档开关的启动自述都带它(同 [client-version-floor] 口径)。 */
static final String SWITCH_ANCHOR = "[api-guard-switch]";
private static final String USER_ID_PARAM = "user_id";
/**
* 启动自述:把「三档开关各在什么位置」打成一条 grep 得动的日志(ASCII 锚点 {@value #SWITCH_ANCHOR})。
*
* <p>动机与 {@code ClientVersionGuardFilter.reportFloorState()} 同一件:这四键过去只在代码里,
* 「名单写了一堆但一条都不强制」在日志上和「这个过滤器不存在」完全同形。
* 锚点用 ASCII 是现网口径——中文签名在容器日志换了编码后整条 grep 失效。
*/
@PostConstruct
void reportGuardState() {
if (!enabled) {
log.warn("{} admin-guard-enabled=false ⇒ 本过滤器逐请求整体跳过(紧急回退态):"
+ "{} 条用户态前缀与 /api/admin、/debug 以及无条件名单 {} 条都没有兜底鉴权,"
+ "只剩 controller 里的 require*",
SWITCH_ANCHOR, USER_TOOL_PREFIXES.length, SELF_SERVICE_PREFIXES.length);
return;
}
if (!userToolGuardEnabled) {
log.warn("{} aiimage.security.user-tool-guard-enabled=false ⇒ 名单里 {} 条用户态前缀"
+ "不强制凭据(带 user_id 的匿名请求按参数定归属,只剩「身份能解析出来时参数必须对齐」那一半);"
+ "仍无条件强制的是 /api/admin、/debug 与 {} 条自助前缀",
SWITCH_ANCHOR, USER_TOOL_PREFIXES.length, SELF_SERVICE_PREFIXES.length);
return;
}
Set<String> listed = splitToSet(userToolGuardPrefixes);
log.info("{} aiimage.security.user-tool-guard-enabled=true scoped={}/{}({})exemptPrefixes={} ⇒"
+ " 名单内前缀的匿名请求会被 401 挡住",
SWITCH_ANCHOR,
listed.isEmpty() ? USER_TOOL_PREFIXES.length : listed.size(), USER_TOOL_PREFIXES.length,
listed.isEmpty() ? "全部" : String.join(",", listed),
splitToSet(exemptPrefixes).size());
}
@Override
protected boolean shouldNotFilter(HttpServletRequest request) {
if (!enabled) {
@@ -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)。