Spring Controller 内存马检测:反射遍历 RequestMappingHandlerMapping.mappingRegistry 枚举路由与处理类
defense/detection · verified
一句话结论
Controller 型内存马不实现 Filter/Servlet 接口、也不继承 HttpServlet,按接口/父类黑名单 dump 类抓不到;但恶意 controller 必须注册进 Spring MVC 的 RequestMappingHandlerMapping 才能接收请求,因此可反射读取 AbstractHandlerMethodMapping.mappingRegistry 里的 registry 映射,枚举每个 RequestMappingInfo 的路径与 MappingRegistration.handlerMethod 的声明类/方法,得到完整的“URL → 类#方法”清单,再用类名、路径与源码对照发现运行时注册的恶意 controller。
原理
- Spring MVC 在启动时扫描
@Controller/@RequestMapping,把每个 handler 方法登记到RequestMappingHandlerMapping(继承AbstractHandlerMethodMapping)。内部核心是mappingRegistry字段,其registry是一个Map<RequestMappingInfo, MappingRegistration>: - key
RequestMappingInfo保存路径、HTTP 方法等匹配条件; - value
MappingRegistration持有handlerMethod(HandlerMethod),可从中得到声明类、方法名与参数。 RequestMappingHandlerMapping同时暴露运行期registerMapping(RequestMappingInfo, Object handler, Method method);Controller 内存马正是调用它(或等价反射写入 registry)把恶意类/方法注册成新路由。只要内存马要工作,就必然在这个映射表里留下条目。- 该手法解决了“无特征”问题:Controller 内存马可以是一个不实现任何接口、不继承任何 Servlet 类的普通类,基于接口/父类/类名的 dump 黑名单会漏掉它;而路由清单会直接暴露它。
- 获取映射表的路径:当前请求线程通过
RequestContextHolder.currentRequestAttributes()取ServletRequestAttributes,用DispatcherServlet.CONTEXT属性拿到WebApplicationContext,再getBean(RequestMappingHandlerMapping.class);反射mappingRegistry→registry即可遍历。 - 路径条件的读取需兼容 Spring 版本:旧版用
RequestMappingInfo.getPatternsCondition().getPatterns(),Spring 5.3+ 常用getPathPatternsCondition().getPatterns()(PathPattern),两者都读才能覆盖不同注册方式。 HandlerMethod的description字段给出类名#方法(参数类型),可直接和已知 controller 源码/路由文档比对。
触发条件
- 目标为 Spring MVC 应用(非纯 WebFlux),classpath 中存在
spring-webmvc,且当前线程能拿到WebApplicationContext。 - 排查者能在应用中临时加入一个诊断 controller/JSP,或能通过 Actuator、Arthas 等等价手段执行 Java 代码读取该映射表。
- 反射访问 Spring 私有字段未被模块系统/安全管理器阻断(Spring 通常在应用 classpath 的 unnamed module 中,常规环境可反射)。
- 需要结合应用已知路由基线或源码,才能判断哪些条目是异常注册的。
利用步骤
- 在应用中加入临时诊断 controller(例如
/mappings),通过RequestContextHolder获取WebApplicationContext与RequestMappingHandlerMappingBean。 - 反射读取
AbstractHandlerMethodMapping.mappingRegistry,再读取其registry字段,得到Map<RequestMappingInfo, MappingRegistration>。 - 遍历条目:读取
RequestMappingInfo的patternsCondition/pathPatternsCondition得到路径;反射MappingRegistration.handlerMethod,取HandlerMethod的description(类名#方法)。 - 输出完整“路径 → 类#方法”表,与源码中的
@RequestMapping、网关/网关白名单、接口文档比对;重点标记: - 源码中不存在的路径或类; - 类名陌生、伪装成框架类、带随机后缀; - 方法签名只接收HttpServletRequest/HttpServletResponse且方法体执行命令; - 同一路径对应多个 handler 或近期新增的映射。 - 对可疑类用 sa-jdi ClassDump/Arthas
jad/ASM 做字节码取证(见关联卡),确认是否存在请求参数到命令执行的数据流。 - 取证完成后删除临时诊断 controller;对确认的内存马,重启进程或调用
unregisterMapping移除映射,并修复注入入口。
PoC
@RequestMapping("/mappings")
@ResponseBody
public String mappings() {
try {
WebApplicationContext context = (WebApplicationContext) RequestContextHolder
.currentRequestAttributes()
.getAttribute("org.springframework.web.servlet.DispatcherServlet.CONTEXT", 0);
RequestMappingHandlerMapping rmhMapping =
context.getBean(RequestMappingHandlerMapping.class);
Field mappingRegistryField =
AbstractHandlerMethodMapping.class.getDeclaredField("mappingRegistry");
mappingRegistryField.setAccessible(true);
Object mappingRegistry = mappingRegistryField.get(rmhMapping);
Field registryField = mappingRegistry.getClass().getDeclaredField("registry");
registryField.setAccessible(true);
Map<Object, Object> registry =
(Map<Object, Object>) registryField.get(mappingRegistry);
// 反射取 MappingRegistration.handlerMethod
Class<?> registrationClass = null;
for (Class<?> inner : AbstractHandlerMethodMapping.class.getDeclaredClasses()) {
if (inner.getName().endsWith("$MappingRegistration")) {
registrationClass = inner;
}
}
Field handlerMethodField = registrationClass.getDeclaredField("handlerMethod");
handlerMethodField.setAccessible(true);
StringBuilder sb = new StringBuilder("<pre>| path | info |\n");
for (Map.Entry<Object, Object> entry : registry.entrySet()) {
RequestMappingInfo key = (RequestMappingInfo) entry.getKey();
if (key.getPatternsCondition() != null) {
sb.append(key.getPatternsCondition().getPatterns()).append("\t-->");
}
if (key.getPathPatternsCondition() != null) {
sb.append(key.getPathPatternsCondition().getPatterns()).append("\t-->");
}
HandlerMethod handlerMethod =
(HandlerMethod) handlerMethodField.get(entry.getValue());
Field descField = handlerMethod.getClass().getDeclaredField("description");
descField.setAccessible(true);
sb.append(descField.get(handlerMethod)).append("\n");
}
sb.append("</pre>");
return sb.toString();
} catch (Exception e) {
e.printStackTrace();
}
return "";
}
访问 /mappings 输出示例(每行:路径 --> 类#方法):
/save_user --> com.example.web.BasicController#saveUser(User)
/user --> com.example.web.BasicController#user()
/mappings --> com.example.web.controller.Map#mappings()
/shell --> com.example.evil.Controller#exec(HttpServletRequest,HttpServletResponse)
# 最后一行是源码中不存在的运行时注册路由,应重点取证
变体与关联
- 数据源变体:Spring Boot Actuator 的
/actuator/mappings(若暴露且未授权)能直接看到类似映射,排查时可作为只读入口;不能执行代码时可用 Arthas/vmtool反射读取mappingRegistry或 heap dump 搜索RequestMappingInfo。 - 框架变体:Spring WebFlux 使用响应式 handler mapping,字段与 API 不同,需按对应类实现;Spring MVC 旧版(
getPatternsCondition)与 5.3+(getPathPatternsCondition)都要兼容。 - 覆盖范围:Filter/Listener/Valve/Interceptor/内存马不一定出现在 MVC 映射表,需与
defense-detection-tomcat-memshell-scanner-arthas、Agent 检测等组合。 - 关联卡片:[[web-java-framework-spring-mvc-dynamic-controller-memshell]](Controller 内存马攻击链)、[[defense-detection-sajdi-classdump-memshell-bytecode]](对可疑类做字节码/ASM 取证)、[[defense-detection-tomcat-memshell-scanner-arthas]]、[[defense-forensics-java-memshell-heapdump-bytecode]]。
- 边界:无法在应用内执行代码且 Actuator 不可用时,只能走离线 heap dump/Arthas;映射表只能发现“已注册”的 controller 内存马,若攻击者改用 Filter/Agent 等其他类型则不适用;诊断 controller 本身也是代码注入,操作需授权并事后清理。
检测与防御
- 检测:定期导出并基线化路由清单,监控
RequestMappingHandlerMapping.registerMapping/unregisterMapping的运行期调用;出现源码/网关白名单之外的路径、陌生类名或伪装成框架类的 handler;同一路径重复注册。 - 防御:限制 Actuator
mappings端点暴露并加认证;对动态注册 API 使用 RASP/Java Agent 监控;应用以最小权限运行,禁止 JSP/临时 controller 写入;发现异常映射后重启并修复注入入口。 - 加固:启动时校验 controller 清单完整性;容器/框架升级到受支持版本;对 classpath 与 web 目录做完整性监控,防止攻击者先写入 class 再反射注册。