bftool-pkg-sulcud 1.4

A python module (with script) included to handle different kinds of bruteforce

BruteForce Tool (bftool)

Modular fuzzing tool

Description

Module and script that handle different types of iterations over python iterable objects

Requiriments

• Python >= 3.8

Usage

As Script

Use bftool as a script in the command line

Get script usage

fuzzer@linux:~$ python -m bftool --help
usage: __main__.py [-h] [-mt MAX_THREADS] [-mp MAX_PROCESSES] [-w WORDLIST]
                     [-b BRUTEFORCE] [-m {wordlist,arguments}]
                     script_path function_name

positional arguments:
  script_path           Path to the python script to the function to use
  function_name         Name of the function to use

optional arguments:
  -h, --help            show this help message and exit
  -mt MAX_THREADS, --max-threads MAX_THREADS
                        Maximum number of threads per process (if mode is set
                        to wordlist block, this will be also the worlist
                        division number)
  -mp MAX_PROCESSES, --max-processes MAX_PROCESSES
                        Maximum number of process to have active at the same
                        time
  -w WORDLIST, --wordlist WORDLIST
                        File wordlist to use based on "[ARGUMENT_INDEX,
                        ARGUMENT_NAME]:file_path"
  -b BRUTEFORCE, --bruteforce BRUTEFORCE
                        Generate a virtual wordlist based on rules
                        "[ARGUMENT_INDEX,
                        ARGUMENT_NAME]:chars=...,minlength=...,maxlength=..."
  -m {wordlist,arguments}, --mode {wordlist,arguments}
                        Mode to use during the function execution (way to
                        divide the threads)

Quick example

Writing a script with only a function in it like in a file called example.py

The implemented function just need to return the string that you want to print when success, the printing queue will handle the call to print

def check_creds(username: str, password: str):
    # Using
    login_result = login_in_X_service(username, password) # for example login to a X service
    if login_result.success: # If we could login, we want to print the valid credentials
       return f"[+] {username} - {password}" # By returning it, the printing queue will handle it

Can import the function check_creds in the bftool with:

By passing arguments by the argument name (like by passing it with kargs)

python -m bftool -w username:usernames.txt -w password:passwords.txt ./example.py check_creds

Or with:

By passing the arguments by index

python -m bftool -w 0:usernames.txt -w 1:passwords.txt ./example.py check_creds

Expected output

--- Starting child processes ---
* Process with ID 1 - Started
--- All processes were prepared ---
--- Waiting to finish ---
[+] admin - password
[+] john - password1234
* Process 1 - Done
--- END ---
Time setting up the processes: 0.001027822494506836
Time fuzzing: 15.191009759902954
Total time: 15.199022769927979

Handle more Threads/Processes

By default bftool always spawn at least one process per execution, you can increase this number with the flag -mp MAX_NUMBER_OF_PROCESSES (--max-processes MAX_NUMBER_OF_PROCESSES), just remember that this flag divide the provided wordlist in those processes
Inside each process can spawn Threads, by default is only one Thread per process, you can change this with the flag -mt MAX_NUMBER_OF_THREADS (--max-threads MAX_NUMBER_OF_THREADS)

Modes

Currently bftool only has two modes

arguments (enabled by default)

This mode iterates over the arguments wordlist directly it means that for each argument entry it will spawn a thread

Explanation

If you has the wordlist names.txt

john
alice
bob
feix

And the python function say_name(name: str)

bftool will spawn one thread for each argument. In other words, it will run in parallel the function say_name with each name

The Python equivalent will be

for name in file.readlines():
    threading.Thread(target=say_name, args=(name, )).start()

wordlist

Explanation

This mode spawn indepent thread handlers

For example, if we have the wordlist names.txt

john
alice
bob
feix
phineas
ferb
rick
morty
bob
patrick

bftool is going to processed the wordlist using independent threads.
The Python equivalent will be

def wordlist_handler(wordlist_handler: Queue):
    while True:
        try:
            name = wordlist_handler.get(timeout=5)
        except Empty:
            break
        say_name(name)

for thread in available_threads:
    threading.Thread(target=wordlist_handler, args=(wordlist_handler, )).start()

Example fuzz functions (real life applicable functions)

Comming soon

As Module

You can use it as module by creating an Argument object and a MainHandler

import time
import bftool.Types
import bftool.ArgumentConstructor
import bftool.MainHandler


# Function that do something
def test(argument1: str, argument2: str):
    time.sleep(2)  # Here should be some code that processes the arguments
    if argument1 == argument2: # You should place a filter to only return wanted results
        return argument1 + ":" + argument2

handler = bftool.MainHandler.MainHandler()
iterable_wordlists = bftool.Types.IterableWordlists({"argument1": ["Test string 1", "Test string 2"], "argument2": ["Test string 1", "Second string"]}) 
arguments = bftool.ArgumentConstructor.Arguments(function_=test,
                                                 wordlists_iterables=iterable_wordlists,
                                                 maximum_number_of_process_threads=10
                                                )
handler.main(arguments)

Notes

• If you want to run a function that has a small time cost (like 1 seconds or less), it will be better to implement a simple for loop to run it instead of this tool
• Remember that this script DO NOT sanitize the scripts you enter

Installation

Manual

1. git clone https://github.com/shoriwe/bftool.git
2. cd bftool
3. python setup.py install

pip

pip install bftool-pkg-sulcud

Bugs and suggestions

Bugs

Please report bugs in the issues section I will try to fix at least one in the same day you report it.

Suggestions

If you have any suggestion for new features, also leave them in the issue section or create the proper branch, add what do you want and request a pull request