后端(四面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) {