Skip to content

ReaJason/MemShellParty

Repository files navigation

MemShellParty

ci-test ci-release release docker-pulls Telegram OnlinePartyWebSite

Warning

本工具仅供安全研究人员、网络管理员及相关技术人员进行授权的安全测试、漏洞评估和安全审计工作使用。使用本工具进行任何未经授权的网络攻击或渗透测试等行为均属违法,使用者需自行承担相应的法律责任。

Tip

由于本人仅是安全产品研发,无实战经验,如使用或实现有相关疑问或者适配请求可提 issue 或加入 TG 交流群,欢迎一起学习交流

MemShellParty 是一款可本地部署的一键生成常见中间件框架内存马的可视化平台,并且致力于打造内存马的全方位的学习平台。 在遍地是轮子的时代,是时候造车,带着大伙加速冲冲冲了。

MemShellParty 出现的原因有以下几个:

  1. 工作中有时候客户会有个别中间件的内存马测试需求,这个时候临时写一个太慢又太烦,在不忙的时候做一个工具,有需求就生成一个多好(之前用 Java Memshell Generator 生成一个 WAS 的内存马不能用,调了半天修好了)。
  2. Javassist 实在是太多了,字符串拼接的方式去弄方法 code 实在是看得眼睛疼,又不好维护,代码组织合理的话其实都可以,不过做项目我还是推荐 Byte Buddy ,高封装提供的 API 很好用的。单个利用脚本的话确实 Javassist 来得快,而且很多中间件也自带依赖直接能打。
  3. Java Memshell Generator 的出现确实帮大忙了,但是其极少的交互逻辑对于一个应用来说是难以接受的,刚好学习了前端对 UX 也感兴趣(对 Desktop 应用无感),必须得整一个玩玩。
  4. 因为对自动化测试特别感兴趣,刚好找到了 Testcontainers ,并且看了一圈武器化工具基本都是无测试的,所以尝试写写可行的集成测试分享分享,被测试包裹的代码,修改起来信心也大,同时也希望这个项目能长久发展。
  5. 特别多的师傅写了 Java 内存马相关的项目,不过都慢慢就不维护了(或者不公开代码了),我举手来整合一下,嘿嘿。

希望你能从这个项目学会或尝试做的:

  1. 学会编写常见中间件框架的内存马编写方式。
  2. 学会使用 Testcontainers 做 Java 应用的集成测试。
  3. 学会使用 GitHub Actions 编写 CI/CD,编写 CHANGELOG 并通过 CI 自动发布 Release。
  4. 尝试使用 Byte Buddy 生成类,编写 Agent。
  5. 尝试使用 Gradle 构建 Java 项目(platform 编写依赖版本管理,toolchain 可以在根项目设置 JDK17 环境下也能完成 JDK6 源代码的编译)

normal_generator

agent_generator

主要特性

  • 无侵入性:生成的内存马不会影响目标中间件正常流量,即使同时注入十几个不同的内存马。
  • 高可用性: 自带完备的 CI 集成测试
  • 最小化: 尽可能精简内存马大小,高效传输。
  • 强兼容性: 覆盖攻防场景下常见中间件和框架。

快速使用

在线站点

仅限尝鲜的小伙伴,对于其他暴露在公网的服务请谨慎使用,小心生成的内存马带后门

可直接访问 https://party.memshell.news (搭建在 Northflank US 节点上,访问较慢,Thanks @xcxmiku),每次 Release 都会自动部署最新的镜像。

本地部署(推荐)

适合内网或本地快速部署,直接使用 Docker 启动服务方便快捷

使用 docker 部署之后访问 http://127.0.0.1:8080

# 使用 Docker Hub 源,拉取最新的镜像
docker run --pull=always --rm -it -d -p 8080:8080 --name memshell-party reajason/memshell-party:latest

# 使用 Github Container Registry 源,拉取最新的镜像
docker run --pull=always --rm -it -d -p 8080:8080 --name memshell-party ghcr.io/reajason/memshell-party:latest

# 网络质量不太好?使用南大 Github Container Registry 镜像源
docker run --pull=always --rm -it -d -p 8080:8080 --name memshell-party ghcr.nju.edu.cn/reajason/memshell-party:latest

镜像是无状态的,在需要更新最新镜像时,直接移除新建就好了

# 移除之前部署的
docker rm -f memshell-party

# 使用之前的部署命令重新部署(会自动拉取最新的镜像部署)
docker run --pull=always --rm -it -d -p 8080:8080 --name memshell-party reajason/memshell-party:latest

本地构建

适合想编写代码的小伙伴,使用 Git Clone 下载到本地,并构建前后端项目以供使用

首先需要下载 bun,这是一款用于构建前端服务的工具。

  1. 使用 Git Clone 项目
    git clone https://github.com/ReaJason/MemShellParty.git
  2. 构建前端项目,build 结束会将静态资源自动移动到 Spring Boot 中以供使用
    cd MemShellParty/web
    
    bun install
    
    bun run build
  3. 构建后端项目,确保使用 JDK17 环境
    cd MemShellParty/boot
    
    ./gradlew :boot:bootjar -x test

构建完之后,可直接启动 jar 包,jar 包位于 MemShellParty/boot/build/libs/boot-1.0.0.jar

cd MemShellParty/boot

java -jar \
     --add-opens=java.base/java.util=ALL-UNNAMED \
     --add-opens=java.xml/com.sun.org.apache.xalan.internal.xsltc.trax=ALL-UNNAMED \
     --add-opens=java.xml/com.sun.org.apache.xalan.internal.xsltc.runtime=ALL-UNNAMED \
     build/libs/boot-1.0.0.jar

也可这基础上再继续构建容器来使用

cd MemShellParty/boot

docker buildx build -t memshell-party:latest . --load

docker run -it -d --name memshell-party -p 8080:8080 memshell-party:latest

Dockerfile 一键构建

适合于希望构建自定义访问路径的小伙伴,例如 NGINX 反代的场景(#44

下载项目根目录的 Dockerfile

  • VERSION: 版本信息,随意,建议用最新的 tag 号,仅作前端展示
  • ROUTE_ROOT_PATH: 前端根路由配置
  • CONTEXT_PATH: 后端访问前缀
# 基础构建
docker buildx build \
    --build-arg VERSION=1.3.1 \
    -t memshell-party:latest . --load

# 基础镜像启动,访问 127.0.0.1:8080
docker run -it -d -p 8080:8080 memshell-party:latest

# 自定义访问路径构建
docker buildx build \
    --build-arg VERSION=1.3.1 \
    --build-arg ROUTE_ROOT_PATH=/memshell-party \
    --build-arg CONTEXT_PATH=/memshell-party \
    -t memshell-party:latest . --load
    
# 自定义路径构建镜像启动,访问 127.0.0.1:8080/memshell-party
docker run -it -p 8080:8080 \
    -e BOOT_OPTS=--server.servlet.context-path=/memshell-party \
    memshell-party:latest

如果需要使用 NGINX 反代,请先使用自定义访问路径构建容器,并配置 NGINX 如下:

其中 location /memshell-partyROUTE_ROOT_PATH=/memshell-partyCONTEXT_PATH=/memshell-partyBOOT_OPTS=--server.servlet.context-path=/memshell-party 都要一致才行。

location /memshell-party {
  proxy_pass http://127.0.0.1:8080;
  proxy_set_header Host $http_host;
  proxy_set_header X-Forwarded-By $server_addr:$server_port;
  proxy_set_header X-Forwarded-For $remote_addr;
  proxy_http_version 1.1;
  proxy_connect_timeout 3s;
  proxy_read_timeout 300s;
  proxy_send_timeout 300s;
  proxy_buffer_size 16k;
  proxy_buffers 8 64k;
  proxy_busy_buffers_size 128k;
}

适配情况

已兼容 Java6 ~ Java8、Java9、Java11、Java17、Java21

中间件以及框架

Tomcat(5 ~ 11) Jetty(6 ~ 11) GlassFish(3 ~ 7) Payara(5 ~ 6)
Servlet Servlet Filter Filter
Filter Filter Listener Listener
Listener Listener Valve Valve
Valve ServletHandler - Agent FilterChain - Agent FilterChain - Agent
FilterChain - Agent ContextValve - Agent ContextValve - Agent
ContextValve - Agent
Resin(3 ~ 4) SpringMVC SpringWebFlux XXL-JOB
Servlet Interceptor WebFilter NettyHandler
Filter ControllerHandler HandlerMethod
Listener FrameworkServlet - Agent HandlerFunction
FilterChain - Agent NettyHandler
JBossAS(4 ~ 7) JBossEAP(6 ~ 7) WildFly(9 ~ 30) Undertow
Filter Filter Servlet Servlet
Listener Listener Filter Filter
Valve Valve(6) Listener Listener
FilterChain - Agent FilterChain - Agent (6) ServletHandler - Agent ServletHandler - Agent
ContextValve - Agent ContextValve - Agent (6)
ServletHandler - Agent (7)
WebSphere(7 ~ 9) WebLogic (10.3.6 ~ 14)
Servlet Servlet
Filter Filter
Listener Listener
FilterManager - Agent ServletContext - Agent
BES(9.5.x) TongWeb(6 ~ 7) InforSuite AS (9 ~ 10) Apusic AS (9)
Filter Filter Filter Servlet
Listener Listener Listener Filter
Valve Valve Valve Listener
FilterChain - Agent FilterChain - Agent FilterChain - Agent
ContextValve - Agent ContextValve - Agent ContextValve - Agent

内存马功能

  • Godzilla 哥斯拉
  • Behinder 冰蝎
  • 命令执行
  • Suo5
  • AntSword 蚁剑
  • Neo-reGeorg
  • Custom

封装方式

  • BASE64
  • GZIP BASE64
  • JSP
  • JSPX
  • JAR
  • BCEL
  • 内置脚本引擎、Rhino 脚本引擎
  • EL、SpEL、OGNL、Aviator、MVEL、JEXL、Groovy、JXPath、BeanShell
  • Velocity、Freemarker、JinJava
  • 原生反序列化(CB4)
  • Agent
  • XXL-JOB Executor
  • Hessian、Hessian2 反序列化(XSLT链)
  • JNDI
  • JDBC 连接
  • 其他常见反序列化

How

  1. 如何使用 bytebuddy 生成类,为属性赋值,添加方法,指定位置调用方法?(WIP
  2. 如何调试内存马,为什么内存马注入了却不可用?(WIP

Contribute

你的任何反馈以及 issue 交流都是对当前项目的贡献

It will be so nice if you want to contribute. 🎉

  1. 如果你有高超的 Docker 环境构建技术,可以尝试添加 CVE 相关的集成测试用例。
  2. 如果你有高超的内存马编写技术,可以尝试添加一个内存马试试。
  3. 如果你有丰富的实战经验,可以尝试写写 issue 来提提建议。

项目结构目录、构建和编译可参考 CONTRIBUTING.md

Thanks

Let's start the party 🎉