Skip to content
GUI based offensive penetration testing tool (Open Source)
Python HTML CSS JavaScript Other
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitbook/assets GitBook: [master] 37 pages and one asset modified Jan 7, 2020
.github Create FUNDING.yml Jan 9, 2020
app Updated GUI: fixed webbrowser.open(url) Jan 26, 2020
docker cleaned up docker/black-widow.sh Jan 13, 2020
docs GitBook: [master] 2 pages modified Jan 9, 2020
resources
.dockerignore Updated docker Jan 9, 2020
.env.docker ready for pip Jan 7, 2020
.env.example fixed storage Jan 4, 2020
.gitignore ignored packaging files Jan 7, 2020
Dockerfile Making apt package Jan 14, 2020
LICENSE Updated LICENSE Jan 11, 2020
README.md Updated README.md Jan 26, 2020
SUMMARY.md GitBook: [master] 2 pages modified Jan 9, 2020
_config.yml Set theme jekyll-theme-hacker May 14, 2019
black_widow.py black-widow input sqlinjection url validation Jan 11, 2020
requirements.txt

README.md

description
black-widow is one of the most useful, powerful and complete offensive penetration testing tool

black-widow

Python 3.x License Docker Pulls

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)

  1. 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 
    
  2. 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

  1. If you haven't Docker, install it
  2. Run docker:
    • Command line: docker run --rm offensive/black-widow [arguments]
    • GUI: docker run -d -p 8095:80 --rm offensive/black-widow -g

Manual installation

  1. sudo apt-get update && sudo apt-get install tidy clang tshark
  2. git clone git@github.com:offensive-hub/black-widow.git
  3. cd black-widow
  4. sudo pip3 install -U -r requirements.txt
  5. ./black-widow.py --django migrate
  6. sudo ./black-widow.py <arguments>

Run

  • GUI: sudo ./black-widow.py -g
  • Command line: sudo ./black-widow.py <arguments>

Debug

  • Run django (examples):
    • ./black-widow.py --django runserver
    • ./black-widow.py --django help
    • ./black-widow.py --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

Links

Contacts

Authors

Thanks to

Follow Us

FacebookInstagramTwitterYouTube

SPONSORS

1st level Sponsors

Offensive Hub

2nd level Sponsors

Offensive Hub

3th level Sponsors

Offensive Hub

You can’t perform that action at this time.