| name | java-xxe-audit |
| description | 当用户要求审计 Java 源码、字节码或 pipeline 证据中的 XML 外部实体注入、XML 解析器安全配置、SOAP/XML 请求体解析、JAXP/JDOM/dom4j/StAX/JAXB/Transformer/Schema/XStream XML 解析风险时使用；只做路由枚举、调用链追踪、SQL、文件、反序列化、鉴权或组件 CVE 扫描时不要使用。 |
Java XXE Audit
当前定位
java-xxe-audit 是 Java 审计体系中的 XML 解析专项判定层。它消费源码、配置、字节码、反编译结果、java-route-mapper 路由清单或 java-route-tracer 调用链证据，回答：
- 用户可控 XML 是否进入真实 XML 解析、转换、校验或
fromXML sink。
- 实际 parser/factory/resolver 是否禁用外部实体、外部 DTD、XInclude 或外部资源访问。
- WebService/SOAP/XML 入口、Content-Type、鉴权上下文和输出条件是否影响结论。
- 风险应标为确认漏洞、条件成立、待验证、不可确认还是非漏洞。
- 对确认漏洞或条件成立风险，给出授权测试环境可复核的 Burp Suite 请求和低风险 XXE payload。
本 skill 不负责全量路由枚举，不替代调用链追踪，不判断鉴权漏洞，不扫描依赖 CVE，不输出未授权攻击、真实敏感文件读取、内网探测、数据外带或拒绝服务 payload。
上下游边界
上游输入可以是：
- 用户指定的 Java 项目路径、类、方法、XML 处理器、SOAP/WebService 入口或 XML 工具类。
java-route-mapper 产出的 XML/SOAP 路由、Content-Type 和入口参数。java-route-tracer 产出的 XML 参数流向、可控性、分支条件和解析 sink 候选。.class、.jar、.war、已有反编译结果或 Spring/CXF/JAX-WS 配置。
下游通常读取：
- XXE 审计报告。
- XML 解析器映射、输入来源、防护状态、输出条件和限制说明。
- 确认漏洞或条件成立项的 Burp Suite 请求和 payload，用于授权环境复核。
- 需要继续交给
java-route-tracer、java-auth-audit 或反编译工作的证据缺口。
相邻 skill 边界：
java-route-mapper：枚举 XML/SOAP/REST 路由；本 skill 只消费路由证据。java-route-tracer：追踪 XML 输入从入口到解析器；本 skill 只在证据不足时请求追踪，不凭方法名推断可控性。java-auth-audit：判断入口鉴权、越权或未授权；本 skill 只引用鉴权上下文。java-file-read-audit：判断文件读取漏洞；XXE 可能导致文件读取，但本 skill 只证明 XML 外部实体解析链。java-deserialization-audit：判断 XStream/JAXB/JDK 等对象反序列化利用链；本 skill 只判断 XML 外部实体解析维度。java-vuln-scanner：扫描依赖组件 CVE；本 skill 不编造 CVE、CVSS、修复版本或组件结论。
触发条件
满足任一条件时触发：
- 用户明确要求审计 XXE、XML External Entity、外部实体、DTD、SOAP XML、XML parser 安全配置。
- 代码中出现
DocumentBuilderFactory、SAXParserFactory、XMLReader、SAXReader、SAXBuilder、XMLInputFactory、TransformerFactory、SchemaFactory、JAXBContext、Unmarshaller、XStream.fromXML、XPathExpression 等 XML 解析、转换或 XML 反序列化入口。
java-route-tracer 已报告用户输入到达 XML 解析器或 XML 工具类，需要判定是否构成 XXE。- 项目只有字节码，需要定位 XML 解析类并确认是否配置安全特性。
- 用户给出候选 XML 处理代码，要求判断外部实体是否可被解析。
不触发条件
以下情况不要触发本 skill：
- 只要求列出 Controller、Servlet、WebService 路由。
- 只要求追踪参数调用链，不要求判断 XML 解析风险。
- 只看到 XML 文件、Spring bean、SOAP 配置或
@WebService，但没有 XML 解析 API 或外部实体处理证据。
- 只审计 SQL、文件上传、文件读取、反序列化、鉴权、SSRF 或组件版本。
- XML 输入只作为字符串透传、日志记录或存储，没有进入解析器。
- 用户要求批量扫描线上目标、未授权攻击、真实敏感文件读取、内网探测、数据外带或拒绝服务 payload。
成功标准
合格输出必须同时满足：
- 每个结论都有入口或输入来源、XML 数据可控性、真实解析 sink、防护配置和代码位置。
- 不把 XML 字符串、SOAP 框架、配置文件、类名或未读实现写成 XXE 漏洞。
- WebService/SOAP 入口地址必须来自真实证据，例如 CXF/JAX-WS 配置、
@WebService 服务名、WSDL 或 route-mapper 输出；不得用类名、接口名或方法名臆造 endpoint path。
- 明确区分确认漏洞、条件成立、待验证、不可确认和非漏洞。
- 对
DOCTYPE、外部通用实体、外部参数实体、外部 DTD、XInclude、EntityResolver、accessExternal*、StAX properties 等防护给出证据。
- 对回显、无回显、OOB 条件只做静态可行性描述，不声称验证成功。
- 同根因多入口按
../java-shared/VULNERABILITY_GROUPING.md 聚合；不同解析器、入口、防护条件或输出条件拆分。
结论统计 数量必须与 XML 解析器映射 中各状态行数一致；SOAP 配置、依赖版本、过滤器状态等非解析 sink 信息不能计入映射。- 报告严格使用
references/OUTPUT_TEMPLATE.md 的 6 个编号章节，不新增 ## 0、## 7、## 输出自检、技能源校验或测试验收信息。
- 确认漏洞或条件成立项必须包含 Burp Suite 请求和 payload；待验证、不可确认和非漏洞项不得输出可复制请求。
- 不编造 CVE、CVSS、修复版本、真实文件内容、外带结果、HTTP 响应、漏洞利用成功或不存在的代码路径。
- 正式报告只描述代码证据和证据缺口，不暴露工具权限、网络限制、命令失败、模型规则编号或测试过程。
工作流
1. 确定审计范围
- 读取用户指定路径、候选入口、上游 route/tracer 报告和配置文件。
- 若没有入口证据，可做 XML 解析器盘点，但结论只能是“待验证/不可确认/非漏洞”，不能写外部可利用。
- 若只有工具类名、XML 文件名或
UNCONFIRMED sink，先定位实现源码、字节码或反编译结果。
2. 选择 reference
- 解析器和防护规则：读取
references/PARSERS.md。
- 源码缺失或只给字节码：读取
references/DECOMPILE_STRATEGY.md。
- 需要输出 Burp Suite 请求或 payload：读取
references/VALIDATION_GUIDE.md。
- 生成报告前：读取
references/OUTPUT_TEMPLATE.md。
3. 定位 XML 解析 sink
优先查找真实解析执行点：
- DOM/SAX：
DocumentBuilder.parse、SAXParser.parse、XMLReader.parse。
- JDOM/dom4j：
SAXBuilder.build、SAXReader.read。
- StAX：
XMLInputFactory.createXMLStreamReader、createXMLEventReader。
- Transformer/Schema：
TransformerFactory.newTransformer(Source)、SchemaFactory.newSchema(Source)。
- JAXB：
Unmarshaller.unmarshal，尤其是直接接收 InputStream、Reader、StreamSource、SAXSource、XMLStreamReader 的路径。
- XStream：
XStream.fromXML、项目封装的 XmlUtil.fromXML；只判定 XML parser 外部实体行为，不展开 gadget 或对象注入利用链。
- XPath/XSLT：解析结果进入
XPath 或 Transformer 时继续检查源 parser 是否安全。
4. 追踪 XML 输入和输出条件
- 输入来源：
request.getInputStream、getReader、@RequestBody String、MultipartFile、SOAP Body、MQ 消息、数据库 XML 字段、文件上传内容。
- 中间包装：
InputSource、StringReader、ByteArrayInputStream、StreamSource、DOMSource、SAXSource、Source。
- 输出路径：HTTP response、页面 model、异常信息、日志、业务返回对象、文件写入、外部资源加载条件。
- 若跨层证据不足，切回
java-route-tracer；不要凭 parseXml、loadXml、handleSoap 等名称推断可控性。
5. 判定防护和执行条件
- 确认安全配置必须在解析器创建后、解析调用前、同一实例或实际使用的 factory 上生效。
setValidating(false)、setNamespaceAware(true)、普通 schema 校验、try/catch 吞异常不等于 XXE 防护。- 自定义
EntityResolver、XMLResolver、LSResourceResolver 只有在实现明确拒绝外部实体时才算防护。
- 解析器创建在安全工厂中，但后续又创建新解析器实例时，要分别判断。
- 数据流缺入口、缺解析 sink、缺防护状态或缺执行条件时，输出待验证或不可确认。
6. 输出报告
- 使用
references/OUTPUT_TEMPLATE.md 生成 6 个编号章节。
- 对没有确认漏洞的审计，也要输出已检查解析点、候选风险、非漏洞依据、不可确认项和待补证据。
- 确认漏洞或条件成立项按
references/VALIDATION_GUIDE.md 输出 Burp Suite 请求和 payload；其他状态只写补证路径。
Hard Rules
- 没有真实 XML 解析/转换/反序列化 sink，不得下 XXE 结论。
- 没有用户可控 XML 输入，不得下 XXE 结论。
- 没有证据证明外部实体防护缺失或不足，不得下 XXE 结论。
UNCONFIRMED、工具类名、SOAP endpoint、XML 文件、DTD 字符串或框架依赖只表示候选，不是漏洞。- 结论状态必须使用中文枚举：确认漏洞、条件成立、待验证、不可确认、非漏洞。
- 确认漏洞和条件成立项必须给 Burp Suite 请求和 payload；待验证、不可确认、非漏洞项不得给可复制请求。
- XXE payload 只能用于授权测试环境低风险复核，使用受控 canary URL 或开发单位创建的无敏感测试文件占位符；不得包含真实敏感文件路径、内网地址、云元数据地址、数据外带、实体扩展 DoS 或批量探测。
- Burp 请求必须匹配真实入口、HTTP 方法、参数名和 Content-Type；无法确认入口时不得编造请求。
- 不编造 CVE、CVSS、修复版本、真实文件内容、HTTP 响应或外带回连结果。
- 反编译证据必须指向真实存在且已读取的源码、反编译文件或 class/jar 来源；路径不存在时只能写不可确认。
- WebService 路由、SOAP endpoint、operation path 和服务地址必须逐项引用配置证据；只知道
SZFTWebServiceImpl 这类类名时，入口只能写“未确认”。
XStream.fromXML 不得仅因“属于反序列化”写成非漏洞；未确认底层 driver、版本或安全配置时，应标待验证或不可确认，并把 gadget 风险交给反序列化专项。XStream.addPermission、securityFramework、allowTypes 等对象反序列化限制不是 XXE 防护；缺少这些配置不能作为 XXE 防护缺口证据。XStream.fromXML 只有在同时确认用户可控 XML、底层 driver/parser 支持外部实体解析且入口路径真实时，才可提升到条件成立；driver 行为或对象 XML 结构未知时最多写待验证。XML 解析器映射 的每一行只能有一个结论状态；若同一入口同时有安全 wrapper 和未确认底层 parser，按未确认片段状态记录。- 正式报告不得出现
## 输出自检、技能源校验、测试提示词、Claude 运行状态、验收清单、工具权限、网络限制、命令失败、模型规则编号、skill 规则、依据 skill 或 hard rule。
- 正式报告不得列依赖版本清单、组件版本号或“版本 CVE”建议；如需依赖风险，只写“交给组件扫描专项”。
- 报告全文禁止出现三个连续英文句点；无法完整确认时写中文“省略非关键字段”或限制说明。
Gotchas
@WebService 或 SOAP 本身不等于 XXE；很多 SOAP 栈由框架解析，业务代码未必能配置 parser。要看业务是否直接解析 XML。@WebService 类名或接口名不等于访问路径；CXF jaxws:endpoint address、Spring bean、WSDL service/port 可能与类名完全不同，未读到真实配置时不要写具体 path。DocumentBuilderFactory.newInstance() 后如果只调用 setValidating(false)，仍不能防 XXE。- 只禁用
external-general-entities 但未禁用 external-parameter-entities，不能算完整防护。
setExpandEntityReferences(false) 对 DOM 只是部分防护，不能单独证明安全。TransformerFactory、SchemaFactory、XMLInputFactory、Unmarshaller 也可能触发外部资源加载，不要只查 5 种经典 parser。XStream.fromXML 同时横跨 XML 解析和反序列化；XXE 只看 XML parser 外部实体行为，不能因 gadget 风险归属其他 skill 就排除 XML 解析风险。XStream 缺少 addPermission 或 allowTypes 是反序列化安全问题，不等同于 XXE；XXE 仍要看底层 XML driver 是否解析外部实体。- 在 XXE 映射或防护状态中写“无 addPermission/allowTypes/securityFramework”会误导为 XXE 防护缺口；这些词只可作为“交给反序列化专项”的边界说明，正式 XXE 报告中通常不要展开。
- 如果只知道 Struts 通配符约定但没有从
struts.xml、action 配置或 route-mapper 确认具体 path，不得输出 Burp 请求；入口写“未确认”。
- 如果无法构造符合 XStream 目标对象结构的完整 XML，确认漏洞/条件成立不能输出半截 payload；应降为待验证并写补证对象结构。
- 自定义 resolver 名为
SafeEntityResolver 不代表安全，必须读实现。
- XML 来自配置文件或服务端常量时，通常不是用户可控；可写加固建议，不写漏洞。
- 回显不存在不等于无风险，但只能写 Blind/OOB 条件待验证，不能声称已外带。
- 对待验证项输出 Burp 请求会误导开发单位按确认漏洞处理，属于不合格输出。
- 确认漏洞没有 payload 或 Burp 请求会缺少可复核交付物，属于不合格输出。
- 在 XXE 报告中列组件版本并建议扫描 CVE 会越界到组件扫描；只写“如需依赖风险，交给组件扫描专项”。
- 报告正文写“依据 skill 规则”或列出
XStream 1.4.3/CXF 2.6.2/JAXB 2.2.5/xpp3 等版本清单，会暴露内部过程或越界。
停止、确认或切换条件
- 找不到实现源码、反编译结果或字节码证据时：停止确认漏洞，输出不可确认。
- 需要先知道 XML 输入是否来自入口时：切换到
java-route-tracer。
- 需要判断入口是否未授权或越权时：交给
java-auth-audit。
- 用户要求组件版本漏洞或 CVE 时：交给
java-vuln-scanner。
- 用户要求真实攻击、批量扫描线上目标、真实敏感文件读取、内网探测、数据外带或拒绝服务 payload 时：拒绝该部分，只保留静态审计和授权环境低风险复核建议。
Eval
| 类型 | 用户请求或场景 | 预期行为 |
|---|
| 正例 | “审计这个接口的 XML 解析是否有 XXE。” | 触发，定位入口、解析器、防护和输出条件 |
| 正例 | “检查项目里 DocumentBuilderFactory 有没有禁用外部实体。” | 触发，读取 parser reference 并输出解析器映射 |
| 正例 | “WAR 里只有 class，帮我看 SOAP XML 处理有没有 XXE。” | 触发，读取反编译策略，先定位 XML 处理类 |
| 反例 | “列出所有 WebService operation。” | 不触发，使用 java-route-mapper |
| 反例 | “追踪这个 XML 字符串到哪个方法。” | 不触发或仅上游，使用 java-route-tracer；若要求判定 XXE 再触发 |
| 反例 | “检查 xstream 版本 CVE。” | 不触发，使用 java-vuln-scanner |
| 边界例 | DocumentBuilderFactory 解析服务端固定 XML 配置 | 记录解析点，通常非漏洞或加固建议 |
| 边界例 | SAXReader 无防护但输入来自数据库 XML 字段 | 待验证或条件成立，取决于数据库字段是否外部可控 |
| 边界例 | SOAP endpoint 存在，但业务代码未直接解析 XML | 不下 XXE 结论，记录框架解析边界 |
| 失败案例 | 把所有 parse() 命中都写成确认漏洞 | 不合格，缺输入可控性和防护分析 |
| 失败案例 | 确认漏洞或条件成立项没有 Burp Suite 请求和 payload | 不合格，缺少开发单位复核材料 |
| 失败案例 | 待验证或不可确认项输出可复制 Burp 请求 | 不合格，候选风险被包装成已确认漏洞 |
| 失败案例 | 输出真实文件读取、内网探测、数据外带、DoS payload、CVSS、CVE、修复版本或模型自检章节 | 不合格，违反输出边界 |
| 失败案例 | 把 XStream 缺少 addPermission 当成 XXE 防护缺口，或在 driver 行为未知时写条件成立 | 不合格，混淆反序列化与 XXE |
| 失败案例 | 根据 Struts 约定猜测 /admin/access_addOrg.action 并输出 Burp 请求 | 不合格，入口证据不足 |
| 失败案例 | Payload 只给 DOCTYPE 片段，未嵌入目标对象 XML 结构 | 不合格，不可直接复核 |
| 失败案例 | 报告写“依据 skill 规则”或列依赖版本清单 | 不合格，暴露内部过程或组件扫描越界 |
