
Controlador de motor de grafos en memoria para BloodHound CE que acelera las consultas de rutas de ataque y Cypher en grandes bosques de Active Directory y Entra, delegando las lecturas inexactas a PostgreSQL.
Un motor de grafos en memoria que funciona bajo BloodHound CE, empaquetado como un driver de DAWGS, de modo que el análisis de rutas de ataque y cualquier otra consulta de grafo se mantengan rápidos en grandes entornos de Active Directory y en hardware convencional.
Las rutas más cortas, las consultas estructurales que emite el propio código de BloodHound y una amplia superficie de Cypher -- incluyendo todas las consultas predefinidas que incluye la interfaz y los datos de OpenGraph -- se sirven desde una réplica en memoria que se mantiene sincronizada con PostgreSQL escritura a escritura. Todo aquello que el motor no puede responder exactamente como lo haría PostgreSQL se delega a PostgreSQL, por lo que, salvo unos pocos casos concretos documentados (más abajo; WHITEPAPER.md §19 los enumera), la única diferencia que deberías notar es la latencia. En un bosque de 1M de nodos, todas las consultas incluidas más un conjunto de consultas adversariales se ejecutan en 7,9s en lugar de 85,6s (BENCHMARK.md).
Cómo funciona, desde los fundamentos, está en WHITEPAPER.md.
En el host que ejecuta tu despliegue de docker compose de BloodHound CE (BloodHound v9.6.0 o superior -- consulta Versiones upstream), desde el directorio que contiene su archivo compose:
curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | sh -s -- install
El instalador muestra lo que encontró y pregunta antes de cambiar nada. Hace una copia de seguridad de la base de datos de la aplicación, del archivo compose y de .env, migra el grafo de Neo4j a PostgreSQL si es necesario, cambia el servicio bloodhound a la imagen de BloodTrail y verifica el resultado. Si tu despliegue aún ejecuta Neo4j, pausa la ingesta primero (consulta las notas de operación). Después, establece un objetivo de memoria (cómo).
Para deshacer todo, ejecuta el mismo comando de una línea con rollback desde el mismo directorio:
curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | sh -s -- rollback
BloodHound responde preguntas de múltiples saltos pidiendo a su base de datos de grafos que expanda una frontera salto a salto: a través del almacén de registros de Neo4j, o mediante un arnés de búsqueda en anchura PL/pgSQL en PostgreSQL. En bosques grandes, las consultas de "rutas más cortas" incluidas agotan el tiempo de espera, y la guía oficial de dimensionamiento para más de 50.000 usuarios es de 96 GB de RAM.
La parte del grafo que necesitan las consultas de rutas -- ids de nodo, tipos de nodo y tipos de arista -- cabe en bastante menos de un gigabyte para 5 millones de nodos y 50 millones de aristas como arreglos compressed-sparse-row, y un solo núcleo de CPU recorre cada arista en menos de un segundo (bench/csrbench). En un bosque híbrido AD/Entra de 1M de nodos, el peor prebuilt incluido pasa de 49 segundos a 63ms; 122 de los 182 escenarios de benchmark son más rápidos, el peor caso es 1,5x más lento (20ms frente a 13ms), y el coste es memoria. BENCHMARK.md contiene cada escenario, el método y lo que las cifras no muestran.
bloodtrail, seleccionado por
la tabla database_switch de BloodHound (o bhe_graph_driver cuando esa tabla no tiene fila);
el instalador establece ambos. La ingesta, el análisis, la API y la UI de BloodHound no cambian. La
imagen es el propio Dockerfile de BloodHound más un pequeño parche
(patches/bloodhound-driver.patch).BLOODTRAIL_SNAPSHOT_DIR establecido, la réplica se guarda en disco y
se reutiliza en el siguiente arranque, pero solo cuando un contador de escrituras en PostgreSQL, y el linaje
que cuenta, demuestran que el archivo está completo; de lo contrario, el arranque reconstruye desde PostgreSQL.WHITEPAPER.md cubre cada uno de estos puntos en profundidad, con referencias al código.
BloodTrail se distribuye como una imagen de BloodHound parcheada más una CLI de instalación. En el host que ejecuta el despliegue de compose, desde el directorio que contiene su archivo compose:
curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | sh -s -- install
El script de arranque descarga la última CLI publicada para tu plataforma, verifica su
suma de comprobación (sha256sum cuando está disponible, shasum -a 256 en macOS de serie), la ejecuta con los
argumentos que pasas después de --, y la elimina de nuevo. Así, cada comando -- install,
status, verify, rollback -- se ejecuta de la misma manera, con su nombre en lugar de
install. La CLI busca docker-compose.yml en el directorio actual; pasa
--compose-file (y, si el proyecto está en otro lugar, --project-dir) en caso contrario.