#ldap #async #bloodhound #tokio #pentest #zip-archive

bin+lib rusthound-ce

Active Directory data collector for Bloodhound Community Edition written in rust

3 stable releases

2.1.2 Dec 1, 2024
2.1.1 Oct 24, 2024
2.1.0 Oct 22, 2024

#1325 in Network programming

Download history 297/week @ 2024-10-21 8/week @ 2024-10-28 1/week @ 2024-11-18 72/week @ 2024-11-25 83/week @ 2024-12-02 18/week @ 2024-12-09

174 downloads per month

MIT license

515KB
10K SLoC

rusthound-ce logo


RustHound-CE is a cross-platform and cross-compiled BloodHound collector tool written in Rust, making it compatible with Linux, Windows, and macOS. It therefore generates all the JSON files that can be analyzed by BloodHound Community Edition. This version is only compatible with BloodHound Community Edition. The version compatible with BloodHound Legacy can be found on NeverHack's github.

RustHound was created during my years as a pentester at Armature Technologies, renamed later Opencyber then NeverHack. I would like to thanks NeverHack for giving me time to research and develop the original RustHound project, which is still available on their github. We've decided to continue working together to contribute to both versions. This one will remain compatible with the community edition, and the NeverHack version with the Legacy version of BloodHound.

Quick usage

Compilation

This project can be compiled directly from make command like:

# Compile it for your current system
make release
# Compile it for Windows
make windows

Or using docker like below:

docker build --rm -t rusthound-ce .

# Then
docker run --rm -v $PWD:/usr/src/rusthound-ce rusthound-ce help
docker run --rm -v $PWD:/usr/src/rusthound-ce rusthound-ce release
docker run --rm -v $PWD:/usr/src/rusthound-ce rusthound-ce windows
docker run --rm -v $PWD:/usr/src/rusthound-ce rusthound-ce linux

Installation

Crates.io Version Crates.io Total Downloads

# Install and/or update RustHound-CE from cargo command
cargo install rusthound-ce

Usage

Here's an example of a command to collect domain objects and obtain the zip archive containing the json files to be imported into BloodHound CE:

rusthound-ce -d DOMAIN.LOCAL -u USERNAME@DOMAIN.LOCAL -z

More information and examples with how to compile RustHound-CE or how to use RustHound-CE can be found directly on the help page.

Special thanks to

Dependencies

~30–65MB
~1M SLoC