From 96f7a43004e9de605bb93b72a09323c74de6c04a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Fri, 9 Oct 2026 23:46:33 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=8E=E7=AB=AF(=E5=9B=9B=E9=9D=A29=E5=88=86?= =?UTF-8?q?=E6=89=B9=E6=AC=A1):=20=E5=85=9C=E5=BA=95=E9=89=B4=E6=9D=83?= =?UTF-8?q?=E5=9B=9B=E5=BC=80=E5=85=B3=E5=86=99=E8=BF=9B=20yml=20=E5=B9=B6?= =?UTF-8?q?=E5=8A=A0=E5=90=AF=E5=8A=A8=E8=87=AA=E8=BF=B0=EF=BC=8C=E9=85=8D?= =?UTF-8?q?=207=20=E4=BE=8B=E9=85=8D=E7=BD=AE=E9=9D=A2=E5=88=A4=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .../aiimage/config/AdminApiGuardFilter.java | 35 +++++++++++++++++++ .../src/main/resources/application.yml | 15 ++++++++ 2 files changed, 50 insertions(+) diff --git a/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java b/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java index bec31078f..3178c7c66 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java +++ b/backend-java/src/main/java/com/nanri/aiimage/config/AdminApiGuardFilter.java @@ -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})。 + * + *
动机与 {@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