Intro • Installation • Usage • Running HaxUnit • Functions

HaxUnit.com
Join the Discord!

📘Intro

HaxUnit is a Python-based comprehensive reconnaissance and security assessment tool for web domains. It integrates various tools for subdomain enumeration, port scanning, vulnerability scanning, and more.

HaxUnit is focused on simplicity and aims to be the best and most complete solution for web security assessments.

✨ Features

• Subdomain Enumeration: Uses tools like Subfinder, Chaos-client, DNSx, and custom bruteforce methods.
• AI-Powered Subdomain Prediction: Integrates Subwiz for ML-based subdomain discovery.
• Port Scanning: Utilizes Naabu for fast port scanning across discovered subdomains.
• Vulnerability Scanning: Integrates Nuclei for detecting security issues across web applications.
• WordPress Scanning: Uses WPScan to identify vulnerabilities in WordPress installations.
• Acunetix Integration: Provides optional integration with Acunetix for web application security scanning.
• Automated Tool Management: Uses pdtm for efficient ProjectDiscovery tool installation and updates.

🔥 Docker (recommended)

For a reliable installation, it's recommended to use HaxUnit with Docker Compose.

This initial setup may take a few minutes:

1. Clone the Repository:

git clone https://github.com/Bandit-HaxUnit/haxunit && cd haxunit 

2. (optional) Rename .env.example to .env and fill in the API keys.

ACUNETIX_THRESHOLD=30
ACUNETIX_API_KEY=
NUCLEI_API_KEY=
WPSCAN_API_KEY=
PDCP_API_KEY=

3. Set executable permissions for scripts:

chmod +x rebuild-compose.sh open-bash.sh 

4. Build and Run Docker Compose:

./rebuild-compose.sh

Once the installation completes successfully, you'll be inside the Docker container, ready to execute HaxUnit:

🎉 Installation Complete! 🎉
HaxUnit is now ready to rock!
Time to find those vulnerabilities and patch them like a pro! 🕵️‍♂️🔍

🚀 To start scanning, run the following command:
haxunit -d <domain>

That's it, you're all set to start scanning domains with HaxUnit!

🐚 Open container if already running

To open a bash shell inside the HaxUnit container, run the following command:

./open-bash.sh

🛠️ Install HaxUnit Manually

Make sure you have the following software installed on your system:

• python3 (>=3.10)
• go (>=1.22)
• docker.io (>=20.10.7)

1. Clone the Repository:

   Open a terminal and run the following command to clone the repository and navigate into the project directory:

   git clone https://github.com/Bandit-HaxUnit/haxunit && cd haxunit

2. Install python3.11-venv (if needed):

   If you don't have the venv module installed, you may need to install it. Run one of the following commands depending on your Python version:

   sudo apt update
   sudo apt install python3.11-venv

   Or for Python 3.10:

   sudo apt update
   sudo apt install python3.10-venv

3. Create a Virtual Environment:

   Create a virtual environment named haxunit-venv:

   python3 -m venv haxunit-venv

4. Activate the Virtual Environment:

   Activate the virtual environment using the following command:

   source haxunit-venv/bin/activate

   Note: To deactivate the virtual environment later, you can simply run deactivate.

5. Install the Required Packages:

   With the virtual environment activated, install the necessary packages:

   python3 -m pip install -r requirements.txt

6. Run the Installation Script:

   Finally, run the main script with the --install flag:

   python3 main.py --install

If everything is installed correctly you should see the following output:

[HaxUnit] [Init] All tools are successfully installed - good luck!

The installation process now uses pdtm (ProjectDiscovery Tool Manager) for efficient tool management and includes intelligent checks to avoid reinstalling already present tools.

📖 Usage

haxunit -h

This will display help for the tool. Here are all the switches it supports.

usage: main.py [-h] [-d DOMAIN] [-m {quick,extensive}] [-v] [-b BIN] [-is ISERVER] [-it ITOKEN] [-acu] [-y] [-u] [-i] [--wpscan-api-token WPSCAN_API_TOKEN]
               [--use-notify] [--cloud-upload] [--htb] [--fuzz] [--use-gpt] [--skip-installers]

HaxUnit - Web Domain Reconnaissance Tool

optional arguments:
  -h, --help            show this help message and exit
  -d DOMAIN, --domain DOMAIN
                        the website to recon: example.com
  -m {quick,extensive}, --mode {quick,extensive}
                        set scan mode
  -v, --verbose         print more information
  -b BIN, --bin BIN     set which python bin to use
  -is ISERVER, --iserver ISERVER
                        interactsh server URL for self-hosted instance
  -it ITOKEN, --itoken ITOKEN
                        authentication token for self-hosted interactsh server
  -acu, --use-acunetix  Enable Acunetix integration
  -y, --yes             yes to all prompts
  -u, --update          update all tools
  -i, --install         install all tools
  --wpscan-api-token WPSCAN_API_TOKEN
                        The WPScan API Token to display vulnerability data
  --use-notify          Run notify on completion
  --cloud-upload        Upload results to ProjectDiscovery cloud
  --htb                 HackTheBox mode
  --fuzz                Enable ffuf fuzzing
  --use-gpt             Enable GPT suggestions
  --skip-installers     Skip tool installation checks

Examples

Run a quick scan on example.com:

haxunit -d example.com

Run a quick scan on example.com saying yes to adding domains by default:

haxunit -d example.com -y

Run an extensive scan on example.com using Acunetix and uploading results to ProjectDiscovery cloud:

haxunit -d example.com -m extensive --use-acunetix --cloud-upload 

Skip installation checks for faster startup (when you know tools are installed):

haxunit -d example.com --skip-installers

Viewing Results

Results from the scan will be saved in the following directory structure:

scans/
└── example.com/
    └── timestamp/

Replace example.com with your target domain and timestamp with the date and time when the scan was conducted. This structure organizes scan results chronologically under the respective domain folder within the scans directory.

🤖 Automate using Apache Airflow

This repository includes a sample Apache Airflow DAG that automates the HaxUnit scanning process.

Setup instructions

1. Clone the Repository:
   Clone this repository into the dags directory of your Apache Airflow installation.

 git clone https://github.com/Bandit-HaxUnit/haxunit && cd haxunit

2. Rename .env.example to .env and fill in the API keys.

ACUNETIX_THRESHOLD=30
ACUNETIX_API_KEY=
NUCLEI_API_KEY=
WPSCAN_API_KEY=
PDCP_API_KEY=

3. Configure Notifications:
   To receive notifications upon completion, rename notify-config.yaml.example to notify-config.yaml.
   

Example configuration for Slack notifications:

slack:
  - id: "slack"
    slack_channel: "automated-pentest"
    slack_username: "HackerBot"
    slack_format: "{{data}}"
    slack_webhook_url: "https://hooks.slack.com/services/XXXXX"

4. Setup the DAG:
   Rename dags.py.example to dags.py and configure it according to your needs.
   
   Don't forget to use --use-notify to enable notifications.

5. Build and Run HaxUnit:
   After configuring the notification settings, build and run HaxUnit with the following command:

chmod +x rebuild-compose.sh && ./rebuild-compose.sh

That's It!

By following these steps, you can now automate your pentests using Apache Airflow. Enjoy the streamlined process!

🛡️ Acunetix

HaxUnit utilizes Acunetix's REST API to automate group creation and initiate scans.

To generate an API key, visit Profile Page.

Insert the API key in the .env file.

ACUNETIX_API_KEY=

Rebuild docker compose to apply the changes:

./rebuild-compose.sh

To run HaxUnit with Acunetix, use the following command:

haxunit -d example.com --use-acunetix

Installing Acunetix

To install Acunetix, execute the following command:

bash <(wget -qO- https://raw.githubusercontent.com/Bandit-HaxUnit/acu/main/install.sh)

This will download and install the Acunetix container.
Once the installation is complete, you can start using Acunetix with HaxUnit.

Acunetix can be accessed at https://localhost:3443.

Use the following default credentials to log in:

Username: awvs@awvs.lan
Password: Awvs@awvs.lan

🔍 Functions

Function	Type	Description
dnsx_subdomains	Subdomain discovery	Use dnsx to find subdomains and brute force subdomains
subfinder	Subdomain discovery	Use subfinder to find subdomains
chaos	Subdomain discovery	Query ProjectDiscovery's Chaos database for passive subdomain enumeration
subwiz	Subdomain discovery	AI-powered subdomain prediction using machine learning
katana	Crawling	Gather all URL's on the list of subdomains and parse the domain using unfurl
alterx	Subdomain permutation	Generate and test subdomain permutations
dnsx_ips	Fetch IP addresses	Use dnsx to fetch A records
naabu	Port scan discovery	Run naabu on the list of subdomains using list of common ports to discover HTTP services
httpx	Subdomain validation	Check all found subdomains if they are active
wpscan	Vulnerability scanner	WordPress Security Scanner
acunetix	Vulnerability scanner	Automatically creates a group for the site and starts scans of the subdomains to find vulnerabilities
nuclei	Vulnerability scanner	Uses all found active subdomains to search for vulnerabilities

📂 Workflow

🙏 Credits

Special thanks to the team at ProjectDiscovery for their incredible range of tools.

Thanks to HadrianSecurity for the Subwiz AI subdomain prediction tool.

HaxUnit.com
Join the Discord!