一个位于 BloodHound CE 之下的内存图引擎, 以 DAWGS 驱动的形式打包,使攻击路径 分析以及所有其他图查询在大型 Active Directory 环境和 普通硬件上都能保持快速。
最短路径、BloodHound 自身代码发出的结构性查询,以及广泛的 Cypher 查询面——包括 UI 自带的每一条预置查询和 OpenGraph 数据——都 由一份内存副本提供服务,该副本随 PostgreSQL 的每次写入保持同步。 引擎无法像 PostgreSQL 那样精确回答的任何内容都会委托给 PostgreSQL, 因此除了少数有文档记录的狭窄情况 (见下文; WHITEPAPER.md §19 列出了它们)之外,你 应该看到的唯一差别就是延迟。在一个 100 万节点的森林上,所有自带查询加上一组对抗性 查询的运行时间为 7.9 秒,而非 85.6 秒(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,请先暂停数据摄取(参见操作说明)。然后设置内存目标(方法)。
要撤销所有更改,请在同一目录下使用相同的单行命令并加上 rollback 运行:
curl -fsSL https://github.com/MihhailSokolov/BloodTrail/releases/latest/download/install.sh | sh -s -- rollback
BloodHound 通过让图数据库逐跳扩展前沿来回答多跳问题:要么通过 Neo4j 的记录存储,要么通过 PostgreSQL 上的 PL/pgSQL 广度优先执行框架。在大型林上,随附的“最短路径”查询会超时,而官方针对超过 50,000 用户的规模建议是 96 GB 内存。
路径问题所需的图部分——节点 ID、节点类型和边类型——以压缩稀疏行数组形式存储时,对于 500 万个节点和 5000 万条边,占用远低于 1 GB,并且单个 CPU 核心在不到一秒内即可扫描完所有边(bench/csrbench)。在一个 100 万节点的混合 AD/Entra 林上,最差的随附预构建查询从 49 秒降至 63 毫秒;182 个基准场景中有 122 个更快,最差情况慢 1.5 倍(20 毫秒对 13 毫秒),代价是内存。BENCHMARK.md 包含每个场景、方法以及这些数字未能展示的内容。
bloodtrail 的 DAWGS 驱动,由 BloodHound 的 database_switch 表选择(当该表没有行时由 bhe_graph_driver 选择);安装程序会同时设置两者。BloodHound 的摄取、分析、API 和 UI 均未改变。镜像基于 BloodHound 自己的 Dockerfile 加上一个小补丁(patches/bloodhound-driver.patch)。BLOODTRAIL_SNAPSHOT_DIR 后,副本会保存到磁盘并在下次启动时复用,但仅当 PostgreSQL 中的写入计数器及其计数的谱系证明文件完整时才如此;否则启动时会从 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 域以获取结果。