← 返回列表

JGD:面向 Java 反序列化 Gadget Chain 的自主挖掘 Agent

聚合站 SecWiki技术 入库 2026-11-18T01:43:07

🌐 English

v0.4.0(2026-10-28):安全左移版本。JGD 现在可插入 GitHub Actions、GitLab CI、Jenkins、pre-commit 和 Nexus 仓库事件,提供 SARIF、baseline 差异和确定性失败卡点。

v0.3.0(2026-10-28):集成、性能与正确性版本。JGD 现在可通过 CLI/JSON/SARIF、MCP 和 A2A 被其他代码审计 agent 调用;字节码索引与动态探测已提速;修复 CC3、延迟触发、增量覆盖等正确性问题。

  1. 可接入其他代码审计 agent:CLI + JSON/SARIF、MCP stdio、A2A JSON-RPC/SSE;外部 agent 只传目标、授权、profile 和预算,JGD 内部完成桥发现、链配对、动态验证与 PoC 终止。
  2. 速度:SQLite 字节码索引支持增量跳过;828-JAR 热查询约 0.038s,旧路径约 2.56s(约 67 倍);动态探针按 classpath 批量复用 JVM。
  3. 正确性:修复 CC3 ChainedTransformer 构造与 getMethod -> invoke -> exec 链、延迟 HashMap 触发、热索引覆盖统计、Spring Boot 嵌套 JAR 索引,以及 LLM 终态把关残留。

一个自主挖掘 agent:输入任意 JAR 目录,输出:

  1. 已知公开链 — 四态判定(在场 / 版本 / 可组装 / 可点火)
  2. 未公开新链 — 静态+动态分析 + 对抗式 LLM 审计发现
  3. 武器化 PoC — 序列化载荷 + RCE 闭环演示(良性标记文件)

全部决策已内化:jar 进 → 链子出,零中间用户交互。

┌─────────────────────────────────────────────────────────────────┐
│  输入: 任意 JAR 目录                输出: 链 + PoC               │
│                                                                 │
│  ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   │
│  │ 公开链   │──▶│ 桥发现   │──▶│ 链配对   │──▶│ PoC      │   │
│  │ 判定     │   │ (静态)   │   │ (动态)   │   │ 武器化   │   │
│  └──────────┘   └──────────┘   └──────────┘   └──────────┘   │
│    签名+版本门    字节码+CHA图    契约合成       良性载荷       │
│                   +分派边        +五载体       +点火测试      │
└─────────────────────────────────────────────────────────────────┘

这些是历史研究候选,不代表当前任何目标的结论;只有 fired_at_deser=true 才由确定性 verifier 记为 CHAIN_CONFIRMED。

链 桥接类 载体 JDK 状态
objlongpair-hashmap org.apache.activemq.artemis.api.core.ObjLongPair HashMap rehash 17+ ✅ RCE已闭环
HashMap.readObject() → rehash → hash(key)
  → ObjLongPair.hashCode() → Objects.hash(first, second)
    → Arrays.hashCode() → first.hashCode()     [Object 字段 — isInstance 恒真]
      → EqualsBean.hashCode() → beanHashCode()
        → ObjectBean.toString() → ToStringBean.toString()
          → Templates.getOutputProperties() → TemplatesImpl.newTransformer()
            → TemplatesImpl.defineClass() → payload 静态块 → RCE

新颖性:入口侧经对抗审计确认 T1 —— 未见于 ysoserial、GadgetInspector
及全部公开 CVE writeup。与所有已知 ROME 入口范式正交。

链 桥接类 载体 JDK
tuple1-8-hashmap io.vavr.Tuple1…Tuple8 HashMap 11
either$left/right io.vavr.control.Either$Left/Right HashMap 11
option$some io.vavr.control.Option$Some HashMap 11
validation$valid/invalid io.vavr.control.Validation$Valid/Invalid HashMap 11
hamt$leafsingleton io.vavr.HashArrayMappedTrie$LeafSingleton HashMap 11
链 桥接类 载体 JDK
composablepointcut ComposablePointcut HashMap 11
union/intersectionmatcher MethodMatchers$Union/Intersection HashMap 11
singletontargetsource SingletonTargetSource BAVE 11
hotswappabletargetsource HotSwappableTargetSource BAVE 11
defaultintroductionadvisor DefaultIntroductionAdvisor BAVE 11
链 桥接类 载体 JDK
functions$formapwithdefault Functions$ForMapWithDefault HashMap 11
predicates$isequalto Predicates$IsEqualToPredicate HashMap 11
present Present HashMap 11
链 桥接类 依赖库 载体 JDK
mutableobj-bave MutableObj hutool-core BAVE ≤11
antlr4-pair-bave Pair antlr4-runtime BAVE ≤11
clojure-proxy proxy$…AbstractTableModel$ff19274a clojure HashMap 11
jacksoninject$value JacksonInject$Value jackson BAVE 11
objectidgenerator$idkey ObjectIdGenerator$IdKey jackson BAVE 11
tolerantmap TolerantMap snakeyaml HashMap 11
scala-objectref scala.runtime.ObjectRef scala-library BAVE 11
链 桥接类 依赖库 备注
ewah-hashmap EWAHCompressedBitmap JavaEWAH 浅分派
federation 等 4 条* FederationConfiguration 等 Artemis 配置类族

ObjLongPair (T1, JDK 17):

HashMap.put → HashMap.hash
  → ObjLongPair.hashCode(ObjLongPair.java:55)
    → Objects.hash → Arrays.hashCode
      → EqualsBean.hashCode → EqualsBean.beanHashCode
        → ObjectBean.toString → ToStringBean.toString → Method.invoke
          → TemplatesImpl.defineClass → payload static block

MutableObj (T2, JDK 11):

BAVE.readObject → val.toString()
  → MutableObj.toString → value.toString()
    → ObjectBean.toString → ToStringBean.toString
      → Templates.getOutputProperties → newTransformer → defineClass → RCE
# 环境要求: Python 3.10+, JDK 11 与 17, ECJ 编译器
pip install chromadb  # 可选, RAG 持久化
# 指向任意 JAR 目录, 自动产出链 + PoC
python3 audit_target.py --target /path/to/jars --name "你的产品"
python3 tui.py                    # English
python3 tui.py --lang zh          # 中文
按键 功能
↑ ↓ / j k 导航链
Enter 切换详情视图
t 切换语言(中/英)
q 退出
jgd/
├── audit_target.py          # 产品 CLI 入口
├── tui.py                   # 交互式 TUI
├── jgd/            # 核心 agent 模块 (25 个)
│   ├── verify_agent.py      # 桥发现 + ds 对抗审计
│   ├── chain_complete.py    # 链配对 + 穷尽证明
│   ├── poc_gen.py           # 武器化 PoC 生成
│   ├── known_chains.py      # 公开链四态判定
│   ├── matrix_agent.py      # 多 JDK 探针编排
│   ├── bcdisasm.py          # 纯 Python 字节码反汇编器
│   ├── bridge_fix.py        # 操作数栈符号执行
│   ├── chroma_store.py      # RAG(按语料指纹分域)
│   ├── llm.py               # 双模型(GLM × DeepSeek)
│   ├── scope.py             # 语料指纹隔离
│   ├── profiler.py          # 节点级性能画像
│   ├── conductor.py         # 验收门控终局
│   └── ...
├── examples/
│   ├── chains.json          # 全部已发现链(机器可读)
│   └── chains.md            # 人类可读链目录
├── tests/
│   └── test_smoke.py        # 可第三方复现测试
├── ARCHITECTURE.md          # 25 模块图 + 设计裁决
├── CHANGELOG.md             # 设计决策史 (R6-R52)
├── SECURITY.md              # 授权使用 + 负责任披露
├── CONTRIBUTING.md          # 五项开发原则
└── LICENSE                  # MIT
指标 数值
全管线(31 jars) \~90s 端到端
配对吞吐 1500+ 对 / 9 分钟(批处理 + 4 并行)
PoC 生成(3 链) 20.3s(并行加速 2.7×)
单 JVM 内存 ≤ 256 MB(-Xmx256m, 余量 28%)
全语料 OOM 0
主张 状态
公开链:必能检测 是 — 机械判定(有限签名集)
未公开链:声明域内穷尽 是 — 覆盖账本可复算
未公开链:全域穷尽 否 — 不可判定(Rice 定理)
PoC:永远完整产出 是 — 尾巴候选循环至 RCE 闭环
载体家族:全部经典触发路径 是 — toString/hashCode/equals/compare/compareTo

仅用于合法安全研究、教育和授权渗透测试。
所有 PoC 载荷仅写良性标记文件(/tmp/jgd_poc_fired)—— 无破坏动作。

MIT — Copyright (c) 2026 JGD Contributors

原文链接:https://github.com/lupingQAQ/JGD/blob/main/README.zh-CN.md