Назад к обновлениям
New releaseAug 20, 2026

AD-PathFinder v1.2.0

Построение карты путей атак для Active Directory, ADCS, SCCM и MSSQL с использованием данных BloodHound CE + OpenGraph.

Поделиться

ADPathFinder

build

ADPathFinder — это инструмент построения карты атак для пентестеров и red team специалистов. Он анализирует данные SharpHound и объединяет их с плагинами OpenGraph, чтобы выявлять пути атак к высокоценным целям, таким как Domain Admins и Domain Controllers, начиная с низкопривилегированных пользователей и компьютеров. MSSQLHound и ConfigManBearPig поддерживаются нативно, расширяя охват на AD, ADCS, SCCM и MSSQL.

Блог: OpenGraph attack-path mapping in BloodHound CE

Демонстрация CLI ADPathFinder с группированными результатами рисков и путями атак

Перейти к: Быстрый старт · Охват · Как это работает · Отчёты · Конфигурация · Участники

Охват

ОбластьПримеры
Базовый ADПути эскалации, делегирование, права администратора, BadSuccessor, раскрытые сессии высокоценных целей
ПаролиСлабые пароли, пустые пароли, повторное использование, схожесть с именем пользователя, использование LM-хэшей, Kerberoast и AS-REP в сочетании со слабыми паролями
ADCSРиски шаблонов сертификатов и CA в стиле ESC
MSSQL (данные MSSQLHound OpenGraph)Логины, связанные серверы, имперсонация, relay и пути повышения привилегий
SCCM (данные ConfigManBearPig OpenGraph)Пути захвата и relay, точки распространения с поддержкой PXE и получение политик с management point
Между доменамиДоверительные отношения, общие пароли и пути эскалации между доменами

Требования

  • Python 3.11 или новее.
  • BloodHound CE и Neo4j, доступные локально по умолчанию по адресу neo4j://localhost:7687.
  • Учётные данные API BloodHound CE для операций импорта и удаления.
  • Zip-архив BloodHound CE / SharpHound для покрытия аудита AD.
  • Опциональные zip-архивы плагинов OpenGraph от MSSQLHound и ConfigManBearPig для покрытия MSSQL и SCCM.
  • Опциональный дамп хэшей NTDS и potfile hashcat для аудита паролей.

Быстрый старт

Установка из исходного кода
git clone https://github.com/NetSPI/AD-PathFinder.git
cd AD-PathFinder
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Настройка доступа к API BloodHound
adpathfinder --setup-bloodhound-api

Здесь хранятся настройки API BloodHound CE, используемые для операций импорта и удаления.

Импорт данных SharpHound
adpathfinder --import SharpHound.zip

Несколько zip-файлов плагинов SharpHound и OpenGraph можно импортировать одной командой:

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 в один граф. Данные MSSQLHound и ConfigManBearPig поддерживаются напрямую
MapНаходит кратчайшие пути от пользователей и компьютеров к высокоценным целям. Вы можете настроить набор рёбер, чтобы убрать шумные рёбра, такие как HasSession
GroupГруппирует учётные записи, имеющие общий путь, чтобы повторяющиеся пути отображались как одна находка, а не множество почти одинаковых
PairСравнивает хэши NTDS и potfiles hashcat с данными графа, чтобы показать, какие пути можно использовать во время оценки
LayerСообщает об отдельных находках, таких как отключённая подпись SMB или привилегированные группы по умолчанию, и повышает уровень критичности, когда тот же хост или группа также находится на пути к высокоценным целям
RenderФормирует HTML-отчёты с SVG-графами путей, примечаниями по устранению, шагами проверки в PowerShell и отслеживанием устранённых состояний, а также текстовые, JSON- и диагностические выходные данные

Схема рабочего процесса ADPathFinder

HTML-отчёт AD

Обзор отчёта AD в ADPathFinder с показом этапов обзора, устранения и подтверждения

HTML-отчёт аудита паролей

Обзор отчёта аудита паролей в ADPathFinder с показом взломанных категорий, соответствия политике, длин паролей и учётных записей, поддающихся атаке Kerberoasting/AS-REP

Конфигурация

ADPathFinder читает config.ini из рабочего каталога. Значения также можно задать с помощью переменных окружения ADPF_*.

Выполните следующую команду, чтобы настроить доступ к API BloodHound CE для импорта и удаления:

adpathfinder --setup-bloodhound-api

См. Configuration в вики для всех параметров, настроек подключения к Neo4j, разрешений на файлы и примеров конфигураций. См. Excluded relationships для фильтрации вывода путей атак.

Выходные данные

Отчёты записываются в report_<domain>/, например report_training.local/.

Категории