fix(security): /debug/** 纳入兜底鉴权——修复 debug 端点可被匿名调用(含写操作)

2026-09-11 实测确认(本机公网直连):
  http://47.110.241.161:18080/debug/request-info        → 200 匿名返回实例元数据
  http://api.aishufu.top:18080/debug/request-info       → 200
  https://api.aishufu.top/debug/request-info            → 200
根因:SecurityConfig 是 anyRequest().permitAll(),唯一兜底过滤器 AdminApiGuardFilter 只覆盖
/api/admin/**(shouldNotFilter 对其它路径一律放行),而 modules/debug 两个控制器均无
@Profile/@ConditionalOn*/@PreAuthorize。其中 POST /debug/task-recovery/run-stale-finalize
是强制收尾指定 task 的写操作。

修法:不删端点(stale-task-finalize-guidelines.md 明确把该接口列为线上应急工具),
改为把 /debug 前缀纳入既有兜底过滤器——URL 不变、runbook 不破、复用已测鉴权逻辑,
应急调用方改用 X-Internal-Token 或管理员 JWT 即可通过。
另加 /debug 放行审计日志,便于事后追溯这类低频敏感调用。

单测 13 个全绿(新增 5 个):匿名调 /debug/request-info 与 run-stale-finalize 均被 401 拒绝、
带内部令牌可直达 controller、/debug 裸前缀纳入保护、/debugging 与 /debug-tools 等
同前缀不同段的路径不被误伤。
This commit is contained in:
2026-09-11 01:33:58 +08:00
parent dd45ffe34c
commit 47b2758fe8
2 changed files with 119 additions and 4 deletions
@@ -21,13 +21,19 @@ import java.util.Set;
import java.util.stream.Collectors;
/**
* /api/admin/** 兜底鉴权过滤器。
* /api/admin/**、/debug/** 兜底鉴权过滤器。
*
* <p>SecurityConfig 全局 permitAll 且无路径级拦截,历史上有多个 /api/admin 控制器遗漏方法级
* require*(公网 18080 直连可达即匿名裸奔)。本过滤器作为第二道网:凡进入 /api/admin 的请求
* require*(公网 18080 直连可达即匿名裸奔)。本过滤器作为第二道网:凡进入受保护前缀的请求
* 必须具备"有效身份"Java JWT,或可信内部令牌 X-Internal-Token + operatorId,复用
* AdminAuthSupport),否则直接返回与全局异常一致的 401 响应体(HTTP 200 + {success:false,code})。
*
* <p>/debug/** 于 2026-09-11 一并纳入:两个 debug 控制器都没有方法级鉴权,而主机A 18080 公网
* 直连、主机B nginx 的 location / 全量反代 Java,实测三处均可匿名调通——
* GET /debug/request-info(泄漏实例与转发头)与
* POST /debug/task-recovery/run-stale-finalize**写操作**,强制收尾指定 task)。
* 应急调用方改用 X-Internal-Token 或管理员 JWT 即可通过,不再裸奔。
*
* <p>只保证"已认证",管理员/菜单级校验仍由各控制器 require* 负责,避免拦截普通登录用户本可
* 访问的 /api/admin 接口(如权限菜单列表仅 requireUser)。
*
@@ -42,6 +48,9 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
private static final String ADMIN_API_PREFIX = "/api/admin";
/** 调试端点前缀:无方法级鉴权的诊断/运维入口,同样纳入兜底(2026-09-11)。 */
private static final String DEBUG_PREFIX = "/debug";
private final AdminAuthSupport adminAuthSupport;
private final ObjectMapper objectMapper;
@@ -57,7 +66,7 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
return true;
}
String uri = request.getRequestURI();
if (!(uri.equals(ADMIN_API_PREFIX) || uri.startsWith(ADMIN_API_PREFIX + "/"))) {
if (!isGuarded(uri)) {
return true;
}
if ("OPTIONS".equalsIgnoreCase(request.getMethod())) {
@@ -92,9 +101,24 @@ public class AdminApiGuardFilter extends OncePerRequestFilter {
response.getWriter().write(objectMapper.writeValueAsString(body));
return;
}
// /debug/** 是应急/诊断入口,调用频次极低但敏感,单独留一条审计日志便于事后追溯
String uri = request.getRequestURI();
if (matchesPrefix(uri, DEBUG_PREFIX)) {
log.warn("[debug-guard] {} {} 通过鉴权放行,remoteAddr={}",
request.getMethod(), uri, request.getRemoteAddr());
}
chain.doFilter(request, response);
}
/** 命中受保护前缀(/api/admin、/debug 及其子路径)才进入鉴权,其余请求直接放行。 */
private static boolean isGuarded(String uri) {
return matchesPrefix(uri, ADMIN_API_PREFIX) || matchesPrefix(uri, DEBUG_PREFIX);
}
private static boolean matchesPrefix(String uri, String prefix) {
return uri.equals(prefix) || uri.startsWith(prefix + "/");
}
private Set<String> exemptSet() {
if (exemptPrefixes == null || exemptPrefixes.isBlank()) {
return Collections.emptySet();