Arthas 查杀 Tomcat WebSocket 内存马:枚举 WsServerContainer.configExactMatchMap 并移除恶意 Endpoint
defense/detection · verified
一句话结论
WebSocket 内存马通过 ServerEndpointConfig.Builder.create(...).build() 加 WsServerContainer#addEndpoint 动态注册恶意 Endpoint,路由与配置保存在 configExactMatchMap(ConcurrentHashMap<path, ExactPathMatch>);用 Arthas vmtool 枚举该 map 的 key 和 config.endpointClass.name 即可定位,确认恶意类名后直接 configExactMatchMap.remove(path) 卸载。
原理
- 注入逻辑:攻击者从
ServletContext属性javax.websocket.server.ServerContainer取得WsServerContainer,用ServerEndpointConfig.Builder.create(MyWebSocketEndpoint.class, "/evil").build()构造配置,再调用serverContainer.addEndpoint(config)动态注册。Tomcat 提供该 API,属于正常能力,因此内存马不需要修改字节码。 - 存储位置:
org.apache.tomcat.websocket.server.WsServerContainer#addEndpoint把path与ExactPathMatch(sec)写入configExactMatchMap;ExactPathMatch是简单 bean,持有ServerEndpointConfig,其中endpointClass就是恶意 Endpoint 类。 - 检测:
configExactMatchMap的 key 是注册路由,value 的config.endpointClass.name是处理类。只按路由判断不可靠(可能与正常业务路由重名/相似),必须同时输出路由与 Endpoint 类名,再人工确认是否为恶意类。 - 卸载:
configExactMatchMap.remove(path)即可让新连接无法再匹配到该 Endpoint;已经建立的 WebSocket 连接不会被切断(连接已建立),但无法建立新连接。 - 为什么有效:动态注册的 Endpoint 没有对应的
web.xml/注解声明,也不在磁盘 class 路径中;configExactMatchMap是运行时注册表的唯一事实来源,删除即撤销路由。
触发条件
- 目标为 Tomcat(含
org.apache.tomcat.websocket.server.WsServerContainer),已注入 WebSocket 型内存马(wsMemShell 等)。 - 可 attach Arthas 到目标 JVM,能执行
vmtool。 - 能确认恶意 Endpoint 的类名/路由,避免误删正常 WebSocket 业务。
利用步骤
- attach Arthas,执行
vmtool获取WsServerContainer实例。 - 枚举
configExactMatchMap的所有 key(路由),并输出每个路由对应的config.endpointClass.name:text vmtool --action getInstances --className org.apache.tomcat.websocket.server.WsServerContainer --express '#container=instances[0],#name=#container.configExactMatchMap.keySet().toArray().{#name=#this,#this+":"+#container.configExactMatchMap[#name].config.endpointClass.name}' - 对可疑路由用
jad反编译其 Endpoint 类,确认是否读取消息并执行命令/回显。 - 仅在类名与恶意类匹配时删除路由:
text vmtool --action getInstances --className org.apache.tomcat.websocket.server.WsServerContainer --express '#container=instances[0],#className=#container.configExactMatchMap["恶意路由"].config.endpointClass.name,#className,{#className.equals("恶意类名")?#container.configExactMatchMap.remove("恶意路由"):"failed"}' - 验证:再次枚举 map,恶意路由应消失;用
websocat ws://target/恶意路由新建连接应返回 404/握手失败;已建立的连接仍可能存活,需结合业务侧断开或重启。
PoC
# 1) 枚举路由与 Endpoint 类名
vmtool --action getInstances --className org.apache.tomcat.websocket.server.WsServerContainer --express '#container=instances[0],#name=#container.configExactMatchMap.keySet().toArray().{#name=#this,#this+":"+#container.configExactMatchMap[#name].config.endpointClass.name}'
# 2) 确认后删除恶意路由
vmtool --action getInstances --className org.apache.tomcat.websocket.server.WsServerContainer --express '#container=instances[0],#className=#container.configExactMatchMap["/evil"].config.endpointClass.name,#className,{#className.equals("com.MyWebSocketEndpoint")?#container.configExactMatchMap.remove("/evil"):"failed"}'
# 3) 验证新连接失败
websocat "ws://127.0.0.1:8080/app/evil"
变体与关联
- 多路由/多 Endpoint:一次注入可能注册多个路由;枚举结果需逐条核对,删除时逐个 remove。
- 路由伪装:恶意路由可能伪装成正常业务路径(如
/ws、/chat),不能只凭路径判断,必须看endpointClass。 - 连接残留:
remove只影响新连接,已建立的 WebSocket 会话仍存活;需要业务侧主动关闭或重启才能彻底断开。 - 关联卡片:[[web-java-classloader-websocket-endpoint-memshell]](WebSocket Endpoint 内存马注入)、[[defense-detection-tomcat-memshell-scanner-arthas]](Tomcat 组件枚举与 Arthas 排查)、[[defense-detection-proxyvalve-memshell-arthas-remove]](另一类动态代理型内存马查杀)。
检测与防御
- 检测:
WsServerContainer.configExactMatchMap中出现未在web.xml/注解声明的路由;endpointClass为随机/伪装类名、不在应用 classpath 中;WebSocket 握手日志出现异常路径;Endpoint 类反编译后含Runtime/ProcessBuilder/命令读取逻辑。 - 防御:对 WebSocket 路由做启动基线并定期比对;监控
WsServerContainer.addEndpoint调用(RASP/Agent);限制运行期动态注册;限制 Arthas/attach 的生产可用性;发现内存马后删除路由、断开连接并排查初始入口。 - 注意:删除前必须确认
endpointClass类名,避免误删正常 WebSocket 业务;卸载后已建立连接仍可通信,需评估是否需要重启或主动断开。