Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
BloodTrail — 대규모 Active Directory 및 Entra 포리스트에서 공격 경로 및 Cypher 쿼리를 가속화하고, 부정확한 읽기를 PostgreSQL로 위임하는 BloodHound CE용 인메모리 그래프 엔진 드라이버입니다. | Kitploit
도구/GitHubGitHub/mihhailsokolov/bloodtrail
Network MappingVulnerability AnalysisInformation GatheringPenetration TestingUtilities & FrameworksIdentity & Access Management (IAM)Red Teaming
GitHubmihhailsokolov/bloodtrail

BloodTrail

대규모 Active Directory 및 Entra 포리스트에서 공격 경로 및 Cypher 쿼리를 가속화하고, 부정확한 읽기를 PostgreSQL로 위임하는 BloodHound CE용 인메모리 그래프 엔진 드라이버입니다.

저장소 보기
1413일 전아직 검토되지 않음

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →
공유

BloodTrail

BloodHound CE 아래에서 동작하는 인메모리 그래프 엔진으로, DAWGS 드라이버로 패키징되어 있어 대규모 Active Directory 환경과 일반적인 하드웨어에서도 공격 경로 분석과 그 밖의 모든 그래프 쿼리가 빠르게 유지됩니다.

최단 경로, BloodHound 자체 코드가 실행하는 구조적 쿼리, 그리고 폭넓은 Cypher 영역(UI가 제공하는 모든 사전 구축 쿼리와 OpenGraph 데이터 포함)이 PostgreSQL과 쓰기 단위로 동기화되는 인메모리 복제본에서 처리됩니다. 엔진이 PostgreSQL과 정확히 동일하게 답할 수 없는 것은 PostgreSQL로 위임되므로, 문서화된 몇 가지 좁은 예외(아래; WHITEPAPER.md §19에 나열됨)를 제외하면 여러분이 보게 될 유일한 차이는 지연 시간입니다. 100만 노드 포리스트에서 제공되는 모든 쿼리와 일련의 적대적 쿼리가 85.6초 대신 7.9초에 실행됩니다(BENCHMARK.md).

기반부터 어떻게 동작하는지는 WHITEPAPER.md에 설명되어 있습니다.

빠른 시작

BloodHound CE docker compose 배포를 실행하는 호스트에서(BloodHound v9.6.0 이상 -- 업스트림 버전 참조), compose 파일이 있는 디렉터리에서:

curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | sh -s -- install

설치 프로그램은 발견한 내용을 보여주고 변경하기 전에 확인을 요청합니다. 애플리케이션 데이터베이스, compose 파일, .env를 백업하고, 필요한 경우 그래프를 Neo4j에서 PostgreSQL로 마이그레이션하며, bloodhound 서비스를 BloodTrail 이미지로 전환하고 결과를 검증합니다. 배포 환경이 여전히 Neo4j를 실행 중이라면 먼저 수집(ingestion)을 중지하세요 (운영 노트 참조). 그런 다음 메모리 목표를 설정하세요 (방법).

모든 것을 되돌리려면 같은 디렉터리에서 동일한 원라이너를 rollback과 함께 실행하세요:

curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | sh -s -- rollback

목차

  • 빠른 시작
  • 이유
  • 작동 방식
  • 설치 -- 운영 참고 사항, 메모리 목표, 빠른 재시작
  • 구성
  • 로그 마커
  • 가속되는 것과 그렇지 않은 것 -- OpenGraph
  • 업스트림 버전
  • 개발 및 테스트 -- 저장소 구조
  • 라이선스

이유

BloodHound는 그래프 데이터베이스에 프런티어를 한 홉씩 확장하도록 요청하여 다중 홉 질문에 답합니다. Neo4j의 레코드 저장소를 통하거나, PostgreSQL의 PL/pgSQL 너비 우선 탐색 하네스를 통해서입니다. 대규모 포리스트에서는 기본 제공되는 "최단 경로" 쿼리가 시간 초과되며, 50,000명 이상의 사용자에 대한 공식 사이징 지침은 96 GB의 RAM입니다.

경로 질문에 필요한 그래프의 일부, 즉 노드 ID, 노드 종류, 엣지 종류는 5백만 개의 노드와 5천만 개의 엣지에 대해 압축 희소 행(compressed-sparse-row) 배열로 1기가바이트 훨씬 아래에 들어가며, 단일 CPU 코어가 1초 이내에 모든 엣지를 훑습니다(bench/csrbench). 1백만 노드 규모의 하이브리드 AD/Entra 포리스트에서, 가장 느린 기본 제공 프리빌트는 49초에서 63ms로 줄어듭니다. 182개의 벤치마크 시나리오 중 122개가 더 빨라지고, 최악의 경우는 1.5배 느려지며(13ms 대비 20ms), 그 대가는 메모리입니다. BENCHMARK.md에는 모든 시나리오, 방법, 그리고 수치가 보여주지 않는 것이 담겨 있습니다.

작동 방식

  • 포크가 아닌 드라이버. BloodTrail은 bloodtrail이라는 이름의 DAWGS 드라이버로, BloodHound의 database_switch 테이블(해당 테이블에 행이 없을 때는 bhe_graph_driver)에 의해 선택되며, 설치 프로그램이 둘 다 설정합니다. BloodHound의 수집, 분석, API, UI는 변경되지 않습니다. 이미지는 BloodHound 자체의 Dockerfile에 작은 패치(patches/bloodhound-driver.patch)를 더한 것입니다.
  • 인메모리 복제본. 드라이버는 그래프를 컴팩트 배열(조밀한 노드 ID, 정방향 및 역방향 인접성, 노드 종류별 비트맵 하나)과 모든 노드의 속성 묶음, 그리고 PostgreSQL에 없는 몇 가지 인덱스로 유지합니다. 엣지 속성은 PostgreSQL에 남아 있으며, 결과가 실제로 반환하는 엣지에 대해서만 가져옵니다.
  • 서비스 또는 위임. BloodHound의 읽기 트랜잭션을 통해 이루어지는 읽기는 세 가지 서비스 경로 중 하나로 제공됩니다. 최단 경로 엔진, BloodHound의 구조적 빌더 쿼리에 대한 인식기, 그리고 Cypher 인터프리터입니다. 엔진이 PostgreSQL의 정확한 답을 보장할 수 없으면, 읽기는 변경 없이 PostgreSQL로 전달됩니다.
  • 쓰기 관통(write-through). 쓰기는 먼저 PostgreSQL로 갑니다. 호출이 반환되기 전에 드라이버는 쓰기가 건드린 행을 다시 읽어 불변 델타로 복제본에 계층화하므로, 바로 다음 쿼리가 이미 그 쓰기를 봅니다. 그런 방식으로 추적할 수 없는 소수의 쓰기는 엔진을 폴백 모드로 전환하여(모든 쿼리가 PostgreSQL로 감) 복제본이 백그라운드에서 다시 로드되는 동안 처리합니다.
  • 빠른 재시작. BLOODTRAIL_SNAPSHOT_DIR이 설정되면 복제본이 디스크에 저장되어 다음 부팅 시 재사용되지만, PostgreSQL의 쓰기 카운터와 그것이 세는 계보(lineage)가 파일이 완전함을 증명할 때만 그렇습니다. 그렇지 않으면 부팅 시 PostgreSQL에서 다시 빌드합니다.

WHITEPAPER.md는 코드에 대한 참조와 함께 이들 각각을 심층적으로 다룹니다.

설치

BloodTrail은 패치된 BloodHound 이미지와 설치 프로그램 CLI로 제공됩니다. compose 배포를 실행하는 호스트에서, 해당 compose 파일이 있는 디렉터리로부터:

curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | sh -s -- install

부트스트랩 스크립트는 사용 중인 플랫폼에 맞는 최신 릴리스 CLI를 다운로드하고, 체크섬을 검증한 뒤(sha256sum이 있으면 그것을, 기본 macOS에서는 shasum -a 256을 사용), -- 뒤에 전달한 인자와 함께 실행하고, 다시 삭제합니다. 따라서 모든 명령 -- install, status, verify, rollback -- 은 install 자리에 해당 명령 이름을 넣어 동일한 방식으로 실행됩니다. CLI는 현재 디렉터리에서 docker-compose.yml을 찾습니다. 그렇지 않은 경우에는 --compose-file을 전달하세요(프로젝트가 다른 곳에 있다면 --project-dir도 함께 전달하세요).

이 스크립트는 checksums.txt에 해당 아카이브에 대한 올바른 형식의 SHA-256 항목이 정확히 하나만 있고 그 항목이 일치하지 않으면 다운로드를 실행하지 않습니다. 이 스크립트는 TMPDIR(기본값 /tmp) 아래의 임시 디렉터리에서 CLI를 실행합니다. /tmp가 noexec로 마운트된 호스트에서는 프로그램 실행이 허용되는 디렉터리로 TMPDIR을 설정하세요. 각 다운로드에는 시간 제한이 있습니다. 연결에 15초, 아카이브 전체에 10분, checksums.txt에 1분입니다. 연결이 멈추면 멈춘 채로 있지 않고 무엇을 시도해야 하는지 알려주는 메시지와 함께 종료됩니다.

  • 확인. install과 rollback은 무엇을 변경할지 보여주고 먼저 물어보며, 터미널에서 답변을 읽습니다. 무인으로 실행하려면 --yes를 추가하세요.

  • 릴리스 고정. latest 대신 감사한 정확한 릴리스를 실행하려면 BLOODTRAIL_VERSION을 설정하세요:

    curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | BLOODTRAIL_VERSION=v0.1.2 sh -s -- install
    

    이것은 스크립트가 다운로드하는 CLI를 고정합니다. 부트스트랩 스크립트 자체는 releases/download/<tag>/install.sh를 가져오지 않는 한 여전히 최신 릴리스에서 가져옵니다. v0.1.2 이상을 사용하세요. v0.1.1은 설치할 수 있지만 여기서 설명하는 설치 프로그램 동작보다 이전 버전이며, v0.1.0 바이너리는 설치를 전혀 완료할 수 없습니다(해당 이미지 패키지가 더 이상 게시되지 않음).

  • 이미지. 설치 프로그램은 compose 구성에서 지정한 BloodHound 버전 태그(<upstream>-bt<version>)에서 BloodTrail 이미지를 도출합니다. 이미지가 latest로 태그된 배포(업스트림 예제 compose 파일의 기본값)는 .env에 BLOODHOUND_TAG를 설정해야 합니다(또는 --image를 전달). 릴리스된 CLI는 절대 움직이는 <upstream> 별칭을 자체 이미지로 대체하지 않습니다. <upstream>-bt<version>이 게시되지 않은 경우 아무것도 변경하기 전에 중지하고 해당 별칭을 명시하며, 이후 --image로 명시적으로 선택합니다.

  • 소스에서 빌드. go build ./cmd/bloodtrail도 작동하지만 한 가지 동작 차이가 있습니다. 소스에서 빌드한 바이너리는 버전을 dev로 보고하므로 버전이 고정된 이미지 대신 움직이는 <upstream> 별칭을 대상으로 합니다.

  • install이 하는 일. 배포를 인벤토리화하고, 애플리케이션 데이터베이스, compose 파일 및 .env를 .bloodtrail/backups/에 백업하며, 필요한 경우 Neo4j에서 PostgreSQL로 그래프를 마이그레이션하고(BloodHound 자체 마이그레이터 사용), compose 오버라이드 파일(docker-compose.bloodtrail.yml)을 통해 bloodhound 서비스를 BloodTrail 이미지로 전환한 후 결과를 검증합니다.

  • 검증 (install 후 또는 verify로 단독 실행)은 BloodHound가 읽는 드라이버 설정(database_switch 행, 없으면 bhe_graph_driver)이 bloodtrail을 지정하는지, 컨테이너의 현재 실행이 BloodTrail driver active를 기록했는지, API가 응답하는지 확인합니다. 설정은 app-db 서비스에서 읽으므로 해당 서비스에 접근할 수 있어야 합니다.

  • 스모크 테스트. --admin-password를 전달하면(또는 BLOODTRAIL_ADMIN_PASSWORD 설정) 해당 검증에 수집 및 검색 스모크 테스트가 추가됩니다. 테스트 및 스테이징 배포 전용입니다: 가상의 TESTLAB.LOCAL 도메인을 그래프에 영구적으로 수집하고 전체 분석을 트리거하는데, 프로덕션 규모의 그래프에서는 --verify-timeout보다 오래 실행될 수 있으며 이후 픽스처 객체를 남깁니다. 해당 도메인이 이미 존재하는 배포(반복 실행)에서는 검색으로 이번 실행의 업로드가 그래프에 도달했음을 보여줄 수 없으므로 스모크 테스트는 INCONCLUSIVE로 보고됩니다. 이는 경고이며 통과도 실패도 아닙니다(종료 상태 0). 결과를 얻으려면 먼저 TESTLAB.LOCAL 도메인을 삭제하세요.

운영 참고 사항

도구 다운로드