Zurück zu den Updates
New releaseAug 20, 2026

AD-PathFinder v1.2.0

Angriffspfad-Mapping für Active Directory, ADCS, SCCM und MSSQL mit BloodHound CE + OpenGraph-Daten.

Teilen

ADPathFinder

build

ADPathFinder ist ein Attack-Mapping-Tool für Pentester und Red Teamer. Es analysiert SharpHound-Daten und vereint sie mit OpenGraph-Plugins, um Angriffspfade zu hochwertigen Zielen wie Domain Admins und Domain Controllern aufzudecken, ausgehend von Benutzern und Computern mit geringen Rechten. MSSQLHound und ConfigManBearPig werden nativ unterstützt und erweitern die Abdeckung über AD, ADCS, SCCM und MSSQL.

Blog: OpenGraph attack-path mapping in BloodHound CE

ADPathFinder CLI-Demo mit gruppierten Risikofunden und Angriffspfaden

Direkt zu: Schnellstart · Abdeckung · Funktionsweise · Berichte · Konfiguration · Mitwirkende

Abdeckung

BereichBeispiele
Kern-ADEskalationspfade, Delegierung, Administratorrechte, BadSuccessor, exponierte Sitzungen mit hohen Rechten
PasswörterSchwache Passwörter, leere Passwörter, Wiederverwendung, Ähnlichkeit von Benutzernamen, Verwendung von LM-Hashes, Kerberoast- und AS-REP-Exposition in Kombination mit schwachen Passwörtern
ADCSZertifikatsvorlagen- und CA-Risiken im ESC-Stil
MSSQL (MSSQLHound-OpenGraph-Daten)Logins, verknüpfte Server, Identitätsübernahme, Relay und Privilegienerweiterungspfade
SCCM (ConfigManBearPig-OpenGraph-Daten)Übernahme- und Relay-Pfade, PXE-fähige Verteilungspunkte und Abruf von Management-Point-Richtlinien
DomänenübergreifendVertrauensstellungen, gemeinsam genutzte Passwörter und Eskalationspfade zwischen Domänen

Voraussetzungen

  • Python 3.11 oder höher.
  • BloodHound CE und Neo4j standardmäßig lokal verfügbar unter neo4j://localhost:7687.
  • BloodHound CE API-Anmeldedaten für Import- und Löschvorgänge.
  • Eine BloodHound CE / SharpHound-Zip-Datei für die AD-Audit-Abdeckung.
  • Optionale OpenGraph-Plugin-Zips von MSSQLHound und ConfigManBearPig für MSSQL- und SCCM-Abdeckung.
  • Optionaler NTDS-Hash-Dump und eine hashcat-Potfile für Passwort-Audits.

Schnellstart

Aus dem Quellcode installieren
git clone https://github.com/NetSPI/AD-PathFinder.git
cd AD-PathFinder
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
BloodHound-API-Zugriff konfigurieren
adpathfinder --setup-bloodhound-api

Dies speichert die BloodHound CE API-Einstellungen, die für Import- und Löschvorgänge verwendet werden.

SharpHound-Daten importieren
adpathfinder --import SharpHound.zip

Mehrere SharpHound- und OpenGraph-Plugin-Zip-Dateien können mit einem einzigen Befehl importiert werden:

adpathfinder --import SharpHound.zip MSSQLHound.zip ConfigManBearPig.zip
Daten importieren und ein vollständiges Audit durchführen
adpathfinder -i SharpHound.zip MSSQLHound.zip ConfigManBearPig.zip --ad --pwd Contoso,ContosoIT --ntds ntds.txt -p hashcat.potfile

Verwenden Sie nur die Zip-Dateien, die Sie haben. Der Wert von --pwd ist nicht die AD-Domäne; er ist eine kommagetrennte Liste von Firmen-, Marken- oder Organisationsbegriffen, die in geknackten Passwörtern markiert werden sollen.

Ein Domänen-Audit ausführen
adpathfinder --ad
Ein Passwort-Audit durchführen
adpathfinder --ad --pwd Contoso,ContosoIT --ntds ntds.txt -p hashcat.potfile

Verwenden Sie --unsafe-report nur, wenn Berichte Klartextpasswörter enthalten sollen.

Diagnose schreiben
adpathfinder --ad --pwd Contoso,ContosoIT --ntds ntds.txt -p hashcat.potfile --diagnostics

Funktionsweise

PhaseWas passiert
IngestFührt SharpHound- und unterstützte OpenGraph-Zips zu einem Graphen zusammen. MSSQLHound- und ConfigManBearPig-Daten werden direkt unterstützt
MapFindet die kürzesten Pfade von Benutzern und Computern zu hochwertigen Zielen. Du kannst die Kantenmenge konfigurieren, um rauschende Kanten wie HasSession zu entfernen
GroupGruppiert Konten, die sich einen Pfad teilen, sodass wiederholte Pfade als ein Befund statt als viele nahezu identische gemeldet werden
PairVergleicht NTDS-Hashes und hashcat-Potfiles mit Graphdaten, um zu zeigen, welche Pfade während der Prüfung nutzbar sind
LayerMeldet eigenständige Befunde wie deaktivierte SMB-Signierung oder standardmäßige privilegierte Gruppen und erhöht die Schwere, wenn derselbe Host oder dieselbe Gruppe auch auf einem Pfad zu hochwertigen Zielen liegt
RenderSchreibt HTML-Berichte mit SVG-Pfadgraphen, Hinweisen zur Risikominderung, PowerShell-Validierungsschritten und Nachverfolgung des behobenen Zustands, plus Text-, JSON- und Diagnoseausgaben

ADPathFinder-Workflow-Diagramm

AD-HTML-Bericht

ADPathFinder-AD-Berichtsdurchlauf mit Übersicht, Risikominderung und Bestätigungsschritten

Passwort-Audit-HTML-Bericht

ADPathFinder-Passwort-Audit-Berichtsdurchlauf mit geknackten Kategorien, Richtlinienkonformität, Passwortlängen und roastbaren Konten

Konfiguration

ADPathFinder liest config.ini aus dem Arbeitsverzeichnis. Werte können auch über ADPF_*-Umgebungsvariablen gesetzt werden.

Führe dies aus, um den BloodHound-CE-API-Zugriff für Importe und Löschungen zu konfigurieren:

adpathfinder --setup-bloodhound-api

Siehe Configuration im Wiki für alle Optionen, Neo4j-Verbindungseinstellungen, Dateiberechtigungen und Beispielkonfigurationen. Siehe Excluded relationships zum Filtern der Angriffspfad-Ausgabe.

Ausgaben

Berichte werden in report_<domain>/ geschrieben, zum Beispiel report_training.local/.

Kategorien