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 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) { diff --git a/backend-java/src/main/resources/application.yml b/backend-java/src/main/resources/application.yml index 37b330a8b..7c330ea75 100644 --- a/backend-java/src/main/resources/application.yml +++ b/backend-java/src/main/resources/application.yml @@ -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)。