使用 BloodHound CE + OpenGraph 数据对 Active Directory、ADCS、SCCM 和 MSSQL 进行攻击路径映射。
ADPathFinder 是一款面向渗透测试人员和红队成员的攻击映射工具。它分析 SharpHound 数据,并将其与 OpenGraph 插件统一整合,以从低权限用户和计算机出发,揭示通往高价值目标(如 Domain Admins 和 Domain Controllers)的攻击路径。原生支持 MSSQLHound 和 ConfigManBearPig,将覆盖范围扩展至 AD、ADCS、SCCM 和 MSSQL。
跳转至: 快速开始 · 覆盖范围 · 工作原理 · 报告 · 配置 · 贡献者
| 领域 | 示例 |
|---|---|
| 核心 AD | 提权路径、委派、管理员权限、BadSuccessor、暴露的高价值会话 |
| 密码 | 弱密码、空密码、密码重用、用户名相似性、LM 哈希使用、Kerberoast 和 AS-REP 暴露与弱密码配对 |
| ADCS | ESC 类证书模板和 CA 风险 |
| MSSQL(MSSQLHound OpenGraph 数据) | 登录、链接服务器、模拟、中继和权限提升路径 |
| SCCM(ConfigManBearPig OpenGraph 数据) | 接管和中继路径、启用 PXE 的分发点以及管理点策略检索 |
| 跨域 | 信任关系、共享密码以及域之间的提权路径 |
neo4j://localhost:7687 可用。git clone https://github.com/NetSPI/AD-PathFinder.git
cd AD-PathFinder
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
adpathfinder --setup-bloodhound-api
这里存储用于导入和删除操作的 BloodHound CE API 设置。
adpathfinder --import SharpHound.zip
多个 SharpHound 和 OpenGraph 插件 zip 文件可以通过一条命令导入:
adpathfinder --import SharpHound.zip MSSQLHound.zip ConfigManBearPig.zip
adpathfinder -i SharpHound.zip MSSQLHound.zip ConfigManBearPig.zip --ad --pwd Contoso,ContosoIT --ntds ntds.txt -p hashcat.potfile
仅使用你已有的 zip 文件。--pwd 的值不是 AD 域;它是一个以逗号分隔的公司、品牌或组织术语列表,用于在已破解的密码中标记这些术语。
adpathfinder --ad
adpathfinder --ad --pwd Contoso,ContosoIT --ntds ntds.txt -p hashcat.potfile
仅在报告需要包含明文密码时才使用 --unsafe-report。
adpathfinder --ad --pwd Contoso,ContosoIT --ntds ntds.txt -p hashcat.potfile --diagnostics
| 阶段 | 发生什么 |
|---|---|
| Ingest | 将 SharpHound 和受支持的 OpenGraph zip 合并为一个图。直接支持 MSSQLHound 和 ConfigManBearPig 数据 |
| Map | 查找从用户和计算机到高价值目标的最短路径。你可以配置边集以移除 HasSession 等噪声边 |
| Group | 将共享同一路径的账户分组,使重复路径作为一个发现项报告,而不是许多近乎重复的项 |
| Pair | 将 NTDS 哈希和 hashcat potfile 与图数据进行比较,以显示评估期间哪些路径可用 |
| Layer | 报告独立发现项,例如 SMB 签名已禁用或默认特权组,并在同一主机或组也位于通往高价值目标的路径上时提高严重性 |
| Render | 写出包含 SVG 路径图、缓解说明、PowerShell 验证步骤和修复状态跟踪的 HTML 报告,以及文本、JSON 和诊断输出 |
ADPathFinder 从工作目录读取 config.ini。也可以通过 ADPF_* 环境变量设置值。
运行以下命令以配置用于导入和删除的 BloodHound CE API 访问:
adpathfinder --setup-bloodhound-api
有关所有选项、Neo4j 连接设置、文件权限和示例配置,请参阅 wiki 上的 Configuration。有关过滤攻击路径输出,请参阅 Excluded relationships。
报告写入 report_<domain>/,例如 report_training.local/。
| 输出 | 用途 |
|---|---|
<domain>_AD_report.html | 面向客户的 HTML 报告,包含分组发现项、路径图、缓解说明、验证步骤和修复状态跟踪 |
<domain>_domain_audit.txt / <domain>_domain_audit.json | 文本和 JSON 域审计输出,用于审查、自动化和后续分析 |
<domain>_password_audit.html / <domain>_password_audit.txt / <domain>_password_audit.json | 在提供 NTDS 哈希和 hashcat potfile 时生成的密码审计输出 |
<domain>_*_unsafe.* | 仅在指定 --unsafe-report 时生成的可选不安全报告;这些报告可能包含明文密码 |
diagnostics.json | 使用 --diagnostics 生成的可选运行统计和调试数据 |
请将 NTDS 数据、potfile 和生成的报告视为敏感评估数据。--unsafe-report 标志会将明文密码写入输出文件;仅在确实需要报告中包含明文时使用它,并相应地存储生成的 _unsafe 文件。
有关域审计和密码审计输出的示例,请参阅 sample_reports/。
检查项是小型类,通过装饰器注册,声明其数据需求,并返回发现项字典。平台检查项会声明其数据源,因此当缺少匹配的 OpenGraph 数据时,常规 AD 审计会跳过 MSSQL 或 SCCM 检查。
请参阅 Adding new checks、Working with OpenGraph plugins 以及 wiki 上的 Framework Guide。
pip install -e ".[test]" 然后 pytest tests/ -m "not neo4j and not integration" 可在不使用 Neo4j 的情况下运行快速框架测试。有关 Neo4j fixture 测试套件和完整的本地测试工作流,请参阅 tests/README.md。
ADPathFinder 基于其他项目收集的数据构建;感谢这些项目的作者以及 SpecterOps 团队: