#Zenbuster #Multithreaded #URL #EnumerationBruteForcing #Tool

ZenBuster is a multi-threaded, multi-platform URL enumeration tool written in Python by Zach Griffin (@0xTas).

I wrote this tool as a way to deepen my familiarity with Python, and to help increase my understanding of Cybersecurity tooling in general. ZenBuster may not be the fastest or most comprehensive tool of its kind. It is however, simple to use, decently flexible, and in practice only marginally slower than other “tried-and-true” tools like Gobuster. Personally, I have been using it to help me solve CTF challenges on platforms like TryHackMe, and have found my implementation to be satisfactorily reliable.

This software is intended for use in CTF challenges, or by security professionals to gather information on their targets:

  • It is capable of brute-force enumerating subdomains and also URI resources (directories/files).
  • Both methods of enumeration require use of an appropriate wordlist or dictionary file.
  • Features Include:
    • Hostname format supports standard, IPv4, and IPv6.
    • Support for logging results to a file with -o [filename].
    • Specifying custom ports for nonstandard webservers with -p .
    • Optional file extensions in directory mode with -x .
    • Quiet mode for less distracting output with -q.
    • Color can be disabled for less distracting output with -nc / -nl.
    • Add to the list of http status codes to ignore (default 5xx, 404) with -ic.
    • Tested on Python versions 3.9 and 3.10, with theoretical support for versions >= 3.6

Firstly, ensure that Python version >= 3.6 is installed, then clone the repository with:

git clone https://github.com/0xTas/zenbuster.git

Next, cd zenbuster.

Dependencies

ZenBuster relies on 3 external libraries to function, and it is recommended to install these with:

pip install -r requirements.txt

The modules that will be installed and their purposes are as follows:

  1. Python requests
    • The backbone of each enumeration request. Without this, the script will not function.
  2. termcolor
    • Enables colored terminal output. Non-critical, the script can still run without color if this is not present.
  3. colorama (Windows only)
    • Primes the Windows terminal to accept ANSI color codes (from Termcolor). Non-critical.

These dependencies may be installed manually, with pip using requirements.txt, or via interaction with the script upon first run.

Once dependencies have been installed, you can run the program in the following ways:

On Linux (+Mac?)

./zenbuster.py [options] or python3 zenbuster.py [options]

On Windows

python zenbuster.py [options]

[ptions

Short Flag Long Flag Purpose
-h –help Displays the help screen and exits
-d –dirs Enables Directory Enumeration Mode
-s -ssl Forces usage of HTTPS in requests
-v –verbose Prints verbose info to terminal/log
-q –quiet Minimal terminal output until final results
-nc –no-color Disables colored terminal output
-nl –no-lolcat Disables lolcat-printed banner (Linux only)
-ic <codes> –ignore-codes List of status codes to exclude from results.
-u <hostname> –host Host to target for the scan
-w <wordlist> –wordlist Path to wordlist/dictionary file
-x <exts> –ext Comma-separated list of file extensions (Dirs only)
-p <port#> –port Custom port option for nonstandard webservers
-o [filename] –out-file Log results to a file (accepts custom name/path)

Example Usage

./zenbuster.py -d -w /usr/share/wordlists/dirb/common.txt -u target.thm -v

python3 zenbuster.py -w ../subdomains.txt --host target.thm --ssl -O myResults.log

zenbuster -w subdomains.txt -u target.thm --quiet -ic 400, 403 (With .bashrc alias)

Share:

administrator

ahmedaljanahy Creative Designer @al.janahy Founder of @inkhost I hope to stay passionate in what I doing

Leave a Reply

Your email address will not be published. Required fields are marked *