Skip to main content

Offensive penetration testing tool

Project description


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

If you haven't Docker, install it

  • GUI: docker run -d -p 8095:80 offensive/black-widow -g
  • Command line: docker run --rm offensive/black-widow <arguments>

Manual installation

  1. sudo apt-get update && sudo apt-get install tidy clang tshark
  2. mkdir black-widow
  3. cd black-widow
  4. touch black-widow.py && chmod +x black-widow.py
  5. 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()
    
  6. git clone git@github.com:offensive-hub/black-widow.git black_widow
  7. sudo pip3 install -U -r black_widow/requirements.txt
  8. ./black-widow.py --django migrate black_widow
  9. 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

Links

Contacts

Authors

Thanks to

Follow Us

FacebookInstagramTwitter

SPONSORS

1st level Sponsors

Offensive Hub

2nd level Sponsors

Offensive Hub

3th level Sponsors

Offensive Hub

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

black-widow-1.9.0.tar.gz (65.4 kB view details)

Uploaded Source

Built Distribution

black_widow-1.9.0-py3-none-any.whl (4.3 MB view details)

Uploaded Python 3

File details

Details for the file black-widow-1.9.0.tar.gz.

File metadata

  • Download URL: black-widow-1.9.0.tar.gz
  • Upload date:
  • Size: 65.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.8.10

File hashes

Hashes for black-widow-1.9.0.tar.gz
Algorithm Hash digest
SHA256 05a2f70f796c7dfabcef15e231d9d76ea1fda2a091f1490581ae499fc05e8155
MD5 cbfff9a3aed3c064b86bcf6846512e2d
BLAKE2b-256 be8885993eb29cdfa27f6b80a7f8bb4461167322992c140e87c3676f7cc9e86f

See more details on using hashes here.

File details

Details for the file black_widow-1.9.0-py3-none-any.whl.

File metadata

  • Download URL: black_widow-1.9.0-py3-none-any.whl
  • Upload date:
  • Size: 4.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.8.10

File hashes

Hashes for black_widow-1.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 14178d580180c90e3335d2ab91278564cf0b028f7d2af707367fbe80a6e638ca
MD5 6de6754c68026598832da49b6e20f643
BLAKE2b-256 7d66f74edbe8cb63b459e2be9d8ed94bbfbf92112622c89db32acad032b8d9da

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page