跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
安全

java-deserialization-audit

Java Web 源码反序列化漏洞审计工具。覆盖 Java 原生反序列化、Fastjson/Jackson/XStream/Hessian/JNDI/SnakeYAML 等反序列化入口检测,结合 classpath gadget 链分析进行利用链评估。适用于:(1) 识别反序列化入口点,(2) 检测 classpath 中已知 gadget 链,(3) 结合鉴权状态评估可利用性,(4) 审计 JNDI 注入风险。**支持反编译 .class/.jar 文件**。

Dest1ny-Sec · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add Dest1ny-Sec/Des-java-auto-skill --skill java-deserialization-audit

技能说明


name: java-deserialization-audit description: Java Web 源码反序列化漏洞审计工具。覆盖 Java 原生反序列化、Fastjson/Jackson/XStream/Hessian/JNDI/SnakeYAML 等反序列化入口检测,结合 classpath gadget 链分析进行利用链评估。适用于:(1) 识别反序列化入口点,(2) 检测 classpath 中已知 gadget 链,(3) 结合鉴权状态评估可利用性,(4) 审计 JNDI 注入风险。支持反编译 .class/.jar 文件。

Java 反序列化漏洞审计工具

扫描 Java Web 项目源码,识别所有反序列化入口,检测可用的 gadget 链,评估利用可行性。


漏洞分级标准

详见 SEVERITY_RATING.md

  • 漏洞编号格式: {C/H/M/L}-DESERIALIZE-{序号}
  • 反序列化入口 + 无鉴权 + classpath 含已知 gadget → 直接标记 Critical
  • Score = R × 0.40 + I × 0.35 + C × 0.25

检测范围

完整入口点详解(Java 原生/Fastjson/Jackson/XStream/Hessian/SnakeYAML/RMI/LDAP)见 DESERIALIZATION_ENTRIES.md

反序列化类型识别特征危险等级
Java 原生反序列化ObjectInputStream.readObject(), ObjectInputStream.readUnshared()🔴 Critical
FastjsonJSON.parseObject(), JSON.parse() + autoType 开启🔴 Critical
JacksonObjectMapper.enableDefaultTyping(), @JsonTypeInfo 注解🟡 High
XStreamXStream.fromXML(), new XStream() 无安全框架🟡 High
HessianHessianInput.readObject(), Hessian2Input.readObject()🔴 Critical
JNDI 注入InitialContext.lookup(), InitialDirContext.lookup()🔴 Critical
SnakeYAMLYaml.load() (非 loadAs), Constructor() 自定义🟡 High
RMINaming.lookup(), Registry.lookup() 远程 RMI🟡 High
LDAPnew InitialDirContext(env) + 用户可控 LDAP URL🟡 High

工作流程

1. 项目扫描初始化

# 步骤1: 识别反序列化依赖
find {source_path} -name "*.jar" | grep -iE "fastjson|jackson|xstream|hessian|snakeyaml|yaml|commons-collections|commons-beanutils|spring|groovy|aspectj"

# 步骤2: 扫描 pom.xml 反序列化相关依赖
grep -rE "fastjson|jackson|xstream|hessian|snakeyaml" {source_path}/pom.xml 2>/dev/null

# 步骤3: 扫描 deserialize 入口点
grep -rnE "readObject|readUnshared|readResolve|readExternal" {source_path} --include="*.java" --include="*.class"

2. 反序列化入口点检测

2.1 Java 原生反序列化

检测规则:

# 寻找 ObjectInputStream.readObject 调用
grep -rnE "readObject\(\)|readUnshared\(\)" --include="*.java"

# 寻找 ObjectInputStream 构造(网络输入 / 文件输入 / HTTP Body)
grep -rnE "new ObjectInputStream\(" --include="*.java" | grep -v "System.in"

# 寻找 Base64 解码 + ObjectInputStream(常见绕过 WAF 模式)
grep -rnE "Base64.*decode.*ObjectInputStream|ObjectInputStream.*Base64" --include="*.java"

关键判定:

  • ObjectInputStream 的构造函数参数来源是否为 request.getInputStream() → ✅ 可由 HTTP 触发
  • 是否经过过滤(ValidatingObjectInputStream、LookAheadObjectInputStream)→ 如有则降级
  • classpath 是否存在 ysoserial gadget 链 → 见 2.2 节

2.2 Fastjson 反序列化

检测规则:

# 寻找 parseObject / parse 调用
grep -rnE "JSON\.parseObject\(|JSON\.parse\(|JSONObject\.parseObject\(|JSONArray\.parseArray\(" --include="*.java"

# 检查 autoType 是否开启
grep -rnE "ParserConfig.*AutoTypeSupport|autoTypeSupport.*true" --include="*.java"
grep -rnE "autoTypeEnable|setAutoTypeSupport" --include="*.java"

Fastjson 版本与利用条件速查:

版本利用方式条件
≤ 1.2.24直接 autoType RCE无限制
≤ 1.2.47autoType 绕过需开启 autoType 或有特定 class
≤ 1.2.68expectClass 绕过需 @type 可控
≤ 2.0.x新 autoType 绕过需特定 JDK 版本

2.3 Jackson 反序列化

检测规则:

# enableDefaultTyping 开启检测
grep -rnE "enableDefaultTyping|ENABLE_DEFAULT_TYPING|DefaultTyping" --include="*.java"

# @JsonTypeInfo 注解使用
grep -rnE "@JsonTypeInfo\(|@JsonSubTypes\(" --include="*.java"

# polymorphic 反序列化(readValue 含泛型 Object.class)
grep -rnE "readValue\(.*Object\.class|readValue\(.*Serializable" --include="*.java"

2.4 XStream 反序列化

检测规则:

# XStream 实例化 - 检查是否设置安全框架
grep -rnE "new XStream\(\)|XStream.*fromXML" --include="*.java"
grep -rnE "setClassLoader|addPermission|allowTypes|denyTypes|XStream\.setupDefaultSecurity" --include="*.java"

# 版本检测
find . -name "xstream-*.jar" -o -name "xstream-*-*.jar"

XStream 历史 CVE 速查:

CVE影响版本CVSS
CVE-2021-39144≤ 1.4.179.8
CVE-2021-29505≤ 1.4.169.8
CVE-2021-21351≤ 1.4.159.1
CVE-2020-26217≤ 1.4.139.8

2.5 Hessian 反序列化

检测规则:

# Hessian 输入
grep -rnE "HessianInput|Hessian2Input|SerializerFactory" --include="*.java"
grep -rnE "HessianServlet|HessianServiceExporter|HessianProxyFactory" --include="*.java"

# Dubbo 中 Hessian2 使用
grep -rnE "DubboProtocol|hessian2" --include="*.java"
grep -rnE "SerializationOptimizer|Hessian2Serialization" --include="*.java"

2.6 JNDI 注入

完整 JNDI 注入详解(JDK 版本限制矩阵 + Log4Shell + Spring Cloud Gateway + marshalsec 利用)见 JNDI_INJECTION.md

检测规则:

# JNDI lookup 调用 - 最高优先级
grep -rnE "\.lookup\(|InitialDirContext" --include="*.java"

# 判断 lookup 参数来源是否为用户可控
# 需要配合 route-tracer 做数据流追踪

# Log4j JNDI 特征(即使已打补丁也要标记)
grep -rnE "JndiLookup|JndiManager|log4j.*jndi" --include="*.java"

JNDI 注入利用条件:

JDK 版本ldap://rmi://条件
≤ 8u113✅✅无限制
8u113-8u191✅✅trustURLCodebase=true
≥ 8u191❌❌需本地 gadget 链 (deserialize + JNDI)

2.7 SnakeYAML 注入

检测规则:

# Yaml.load — 危险!不要用 loadAs 过滤
grep -rnE "Yaml\(\)\.load\(|new Yaml\(\)" --include="*.java" | grep -v "loadAs"

# Spring Boot yaml 配置注入
grep -rnE "spring\.yaml\.|YamlPropertiesFactoryBean" --include="*.java"

3. Classpath Gadget 链分析(CRITICAL)

这是决定反序列化漏洞能否 RCE 的关键步骤。

完整 Gadget 链矩阵(24 条 ysoserial 链 + Fastjson/Jackson/Hessian/XStream 专用链)见 GADGET_CHAINS.md

# 扫描 WEB-INF/lib 中是否存在已知 gadget 库
find {source_path} -name "*.jar" | grep -iE "commons-collections|commons-beanutils|commons-logging|spring-|groovy|aspectj|jython|rome|click-nodeps|vaadin|c3p0|hessian|jboss|wicket|mojarra|myfaces"

Gadget 库与对应的 ysoserial 利用链:

Gadget 库ysoserial 链名JDK 限制
commons-collections 3.xCommonsCollections1-7JDK ≤
阅读完整来源 ↗