offensive/black-widow

By offensive

•Updated almost 6 years ago

Offensive penetration testing tool (Open Source)

Image

1.9K

Overview Tags

offensive/black-widow repository overview

⁠black-widow

⁠Offensive penetration testing tool (Open Source)

black-widow provides easy ways to execute many kinds of information gatherings and attacks.

Fully Open Source
Written in Python
Continuously updated and extended

⁠Features

Localhost Web GUI
Sniffing
Website crawling
Web page parsing
SQL injection
Injected database management
Brute force attacks
Cluster between other black-widows
Multiple asynchronous requests
Multiple targets management
Useful CTF features

⁠ APT installation (ubutu/debian)

sudo add-apt-repository ppa:offensive-hub/black-widow
sudo apt-get update
sudo apt-get install black-widow

⁠ APT installation (other distro)

Put the following text on /etc/apt/sources.list.d/black-widow.list file:

deb http://ppa.launchpad.net/offensive-hub/black-widow/ubuntu focal main 
deb-src http://ppa.launchpad.net/offensive-hub/black-widow/ubuntu focal main

Execute the following commands:

sudo sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 5D26C76613E84EA9
sudo apt-get update
sudo apt-get install black-widow

⁠ PyPI installation

sudo pip3 install black-widow

⁠ Docker installation

If you haven't Docker, install it⁠

GUI: docker run -d -p 8095:80 offensive/black-widow -g
- Than visit: http://localhost:8095⁠
Command line: docker run --rm offensive/black-widow <arguments>

⁠Manual installation

sudo apt-get update && sudo apt-get install tidy clang tshark
mkdir black-widow
cd black-widow
touch black-widow.py && chmod +x black-widow.py

Copy and paste the following code in file black-widow.py:

#!/usr/bin/env python3

from black_widow.black_widow import main

if __name__ == "__main__":
    main()

git clone [email protected]:offensive-hub/black-widow.git black_widow
sudo pip3 install -U -r black_widow/requirements.txt
./black-widow.py --django migrate
Now you can run black-widow with: ./black-widow.py <arguments>

⁠Run

GUI: black-widow -g
Command line: black-widow <arguments>

⁠Debug

Run django (examples):
- black-widow --django runserver
- black-widow --django help
- black-widow --django "help createsuperuser"

⁠Project layout

[root]
  |
  |-- app/              # Main application package
  |    |
  |    |-- arguments/       # User input arguments parser (100%)
  |    |
  |    |-- attack/          # Attack modality package (0%)
  |    |-- defense/         # Defense modality package (0%)
  |    |
  |    |-- gui/             # Graphical User Interface package (100%)
  |    |
  |    |-- helpers/         # Helper methods package (100%)
  |    |
  |    |-- managers/        # Managers package
  |    |    |
  |    |    |-- cluster/        # Cluster managers package (0%)
  |    |    |-- crypto/         # Encryption managers package (70%)
  |    |    |-- injection/      # Injection managers package (60%)
  |    |    |-- parser/         # Parser managers package (100%)
  |    |    |-- request/        # Request managers package (70%)
  |    |    |-- sniffer/        # Sniffer managers package (95%)
  |    |
  |    |-- services/        # Services package
  |    |    |
  |    |    |-- logger.py       # Logger service (100%)
  |    |    |-- multitask.py    # MultiTask service (100%)
  |    |    |-- serializer.py   # PickleSerializer and JsonSerializer serivces (100%)
  |    |
  |    |-- storage/         # Storage directory
  |    |
  |    |-- env.py           # Environment variables management
  |
  |-- .env              # Environment variables
  |
  |-- black-widow.py    # Main executable

⁠Thanks to

⁠Follow Us

⁠SPONSORS

⁠1st level Sponsors

⁠2nd level Sponsors

⁠3th level Sponsors

Tag summary

Recent tags

Content type