find-sink

name	find-sink
description	Java 项目漏洞 Sink 点搜索。在代码库中系统性搜索 12 类漏洞的 Sink 点（反序列化、JNDI注入、表达式注入、命令注入、SQL注入、任意类实例化、不安全反射、JDBC攻击、文件上传、ZipSlip、任意文件读取、硬编码敏感信息），确认利用条件后输出 Sink 清单。触发词：find sink、漏洞搜索、sink 分析、sink search、Phase 3。

Sink 点搜索 (Phase 3)

适用场景

• Java Web 项目审计中，搜索代码库中的危险 Sink 函数调用
• 作为 java-audit Phase 3 被调度执行

不适用场景

• 需要追踪 Sink 调用链 → 使用 trace-sink
• 需要分析鉴权 → 使用 analyze-auth

前置条件

• Serena MCP 已连接，目标项目已激活

反幻觉铁律

1. 每个 Sink 必须通过 jet_brains_find_symbol(include_body=true) 二次确认存在性
2. 代码片段必须来自工具实际输出，不得编造
3. 不确定的发现标记为 [Hypothesis]

---

漏洞模式库

12 类漏洞的关键函数、利用条件、判定要点见： → references/sink.md（执行前必须读取此文件）

---

工作流程

Step 1: 读取漏洞模式库

读取 references/sink.md，获取 12 类漏洞的关键函数和利用条件。

Step 2: 逐类搜索

对 12 类漏洞逐一执行：

1. 使用 search_for_pattern 按模式库中的正则搜索
2. 使用 jet_brains_find_symbol(include_body=true) 获取方法体二次确认
3. 排除以下包前缀的搜索结果（框架/第三方库代码）：
   • org.springframework.*
   • org.apache.*
   • org.hibernate.*
   • org.mybatis.*
   • com.fasterxml.*
   • com.alibaba.fastjson.*（框架本身的内部调用）
   • org.eclipse.*
   • io.netty.*
   • com.google.*
   • javax.* / jakarta.*（API 定义）
   • org.slf4j.* / ch.qos.logback.* / org.apache.logging.*
4. 同时排除 test/、src/test/ 目录下的测试类
5. 排除注释中的代码（确认匹配行不在 // 或 /* */ 内）

Step 3: 确认 Sink 利用条件

对每个候选 Sink，根据 references/sink.md 中对应漏洞的 利用条件 逐项检查：

1. 读取 Sink 所在方法完整代码
2. 对照利用条件逐项判定
3. 设定 confidence：
   • high: 所有利用条件明确满足
   • medium: 部分条件满足，需追踪确认
   • low: 仅匹配 API 调用，条件不明确
4. 基本条件不满足的结果直接丢弃

Step 4: 输出结果

输出文件 1: .audit/sinks.md

完整的 Sink 分析报告，包含每个 Sink 的代码片段、利用条件分析、confidence 判定理由。

输出文件 2: .audit/sinks.json

精简的结构化清单，供后续 trace-sink 使用：

{
  "scan_time": "ISO8601 时间戳",
  "sinks": [
    {
      "id": "SINK-001",
      "vuln_type": "漏洞类型标识",
      "class_name": "完全限定类名",
      "method_name": "方法名",
      "file_path": "源文件相对路径",
      "confidence": "high | medium | low"
    }
  ],
  "summary": {
    "total_sinks": 0,
    "by_type": {}
  }
}