Skip to content

puzzlepeaches/bhp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bhp

bhp is a BloodHound user file parser!


InstallationGetting startedUsageComing Soon



Installation

bhp supports all major operating systems and can be installed for the PyPi using the following command:

pipx install bhp

If this tool is not yet availible via PyPi, you can install it directly from the repository using:

git clone https://github.com/puzzlepeaches/bhp.git
cd bhp && pip3 install .

For development, clone the repository and install it locally using poetry.

git clone https://github.com/puzzlepeaches/bhp.git && cd bhp
poetry shell && poetry install

Getting started

bhp supports the latest BloodHound user json file format. Let's say you ran a BloodHound export on an enagement last summer and now the client is back and asking for social engineering servies. If you want to cheat and get as much coverage as possible, you can parse your previous BloodHound export for users with mailboxes for phishing.

bhp gophish 20210414091456_users.json acmecorp.gophish.csv

With the output file, you can go into the Gophish web application and add the users to the campaign super easily.


Usage

The bhp help menu is shown below:

Usage: bhp [OPTIONS] COMMAND [ARGS]...

  Parse BloodHound JSON userfiles for external use.

Options:
  -h, --help  Show this message and exit.

Commands:
  gophish  Outputs a gophish import compatible csv file.
  stdout   Outputs specified type to stdout.
  txt      Outputs specified type to a text file.

The stdout and txt modules allow the user to specify a desired output type. Let's say you want to get an idea of the most common title for users in your export. You can do something like:

bhp stdout title 20210414091456_users.json | sort -u

Thanks

  • The BloodHound team for making me stare a graphs all day
  • The Gophish team for making me mod their project to land phishing emails.
  • The Sprocket team member that created the first iteration of this tool way back.

About

bhp is a BloodHound user file parser!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages