
Active Directory、ADCS、SCCM、MSSQL に対する攻撃経路マッピング(BloodHound CE + OpenGraph データ使用)
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で利用可能なBloodHound CEとNeo4j。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
This stores the BloodHound CE API settings used for import and delete operations.
adpathfinder --import SharpHound.zip
複数のSharpHoundおよびOpenGraphプラグインのzipファイルを1つのコマンドでインポートできます:
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 を 1 つのグラフにマージします。MSSQLHound と ConfigManBearPig のデータも直接サポートされています |
| Map | ユーザーとコンピューターから高価値ターゲットへの最短パスを検出します。HasSession のようなノイズの多いエッジを除外するために、エッジセットを設定できます |
| Group | 同じパスを共有するアカウントをグループ化し、繰り返し現れるパスを多数のほぼ重複した検出結果ではなく 1 つの検出結果として報告します |
| 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 を指定した場合にのみ生成される任意の unsafe レポート。平文パスワードが含まれる可能性がある |
diagnostics.json | --diagnostics を指定して生成される任意の実行統計およびデバッグデータ |
NTDS データ、potfile、生成されたレポートは機密性の高い評価データとして扱ってください。--unsafe-report フラグは平文パスワードを出力ファイルに書き込みます。レポートに平文が必要な場合にのみ使用し、生成された _unsafe ファイルはそれに応じて保管してください。
ドメイン監査およびパスワード監査の出力例については、sample_reports/ を参照してください。
チェックは、デコレータで登録され、必要なデータを宣言し、検出事項の辞書を返す小さなクラスです。プラットフォーム固有のチェックはデータソースを宣言するため、通常の AD 監査では、対応する OpenGraph データが存在しない場合に MSSQL や SCCM のチェックをスキップします。
wiki の Adding new checks、Working with OpenGraph plugins、Framework Guide を参照してください。
pip install -e ".[test]" を実行した後、pytest tests/ -m "not neo4j and not integration" を実行すると、Neo4j を必要としない高速なフレームワークテストが実行されます。Neo4j フィクスチャスイートおよびローカルでの完全なテストワークフローについては、tests/README.md を参照してください。
ADPathFinder は他のプロジェクトによって収集されたデータの上に構築されています。その作者と SpecterOps チームに感謝します: