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 데이터) | 로그인, 연결된 서버, 가장(impersonation), 릴레이, 권한 상승 경로 |
| 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 파일을 한 명령으로 가져올 수 있습니다:
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 연결 설정, 파일 권한 및 예제 구성은 위키의 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 검사를 건너뜁니다.
위키의 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 팀에 감사드립니다: