R4venzCl4w (◣_◢)ノ-=≡≡卍

A modular Framework for Pentesters and Bug Hunters written in Python3.

Table of Contents

• [R4venzCl4w (◣_◢)ノ-=≡≡卍]
  • Technologies & Tools
  • Requirements
  • Features
    • Features Implementation
  • Installation
  • Config
  • Usage
    • Options
    • Example
  • Todo
  • Contributing
  • License

🔧 Technologies & Tools

📚 Requirements

• Python 3.9+
• pip3

Features

• Quick and easy to use
• Modular Framework
• Enumerate IP(Dns, Whois, Port Scanning, Blacklist Checker, Ping, Traceroute, Geolocation) etc.
• Scans Host using Shodan's API
• Fetch the Public Proxies (HTTPS, SOCKS4)
• Run Host Enumeration on IP, Domain, IP Range, or Selected IPs fscan.
• Asn Lookup ( Ip2Asn and ASN to CIDR )
• WAF Fingerprinting with option for checking Generic or (153 WAFs)

Note: Please keep in mind that the tool is still in development and more features will be added in the future.

Features Implementation

• IP Enumeration
  • Dns Lookup
  • Reverse Dns Lookup
  • Whois
  • Port Scanning
  • Blacklist Checker ( dfirsec's Tool --> check_rep )
  • Ping
  • Trace
  • GeoLocation
  • Shodan (Scans Host on Shodan using Shodan's API: API key Required)
  • Asn Lookup ( Ip2Asn and ASN to CIDR )
• Offensive Tools
  • Fscan (shadow1ng's Tool fscan --> An intranet comprehensive scanning tool)

  Visit the fscan repository for more information. For usage read the README.md file. ( Use on your own risk ..!)

• Proxy Fetcher
  • Fetch the Public Proxies (HTTPS, SOCKS4)
• WAF Fingerprinting
  • WAF Fingerprinting with option for checking Generic or (153 WAFs)
  • Could check single domain or multiple domains from a file.

• Domain Enumeration
  • Going to be implemented in ver: 1.3.0

  Current version: 1.2.1 - Stable

Installation

Use the package manager pip to install the requirements. if not installed, install it using the following command.

sudo apt-get install python3-pip

It is advised to install the python requirements in a virtual environment, for that install the venv package.

    python3 -m pip install venv
    python3 -m venv env
    source env/bin/activate

After that run the following commands:

    sudo apt-get install traceroute     # For Debian based distros
    python3 -m pip install -r requirements.txt

Config

Shodan module uses the Shodan's API so make sure you have .configx file in your folder. If the .configx file is not there you can create it with the following Data:

% Config File for R4venzCl4w


# Global Settings
# Global Variables are defined here. These variables can be used in any of the other sections.
$ GLOBAL_VAR: <Global Variable Here>



# Environment Variables
# Shodan API Key Example --> SHODAN_API_KEY:gA**************************
- SHODAN_API_KEY:<API Key Here>

Usage

python3 main.py -i [IP Address]

Options

        -i              IP Address to Enumerate
        -d              Domain to Enumerate         # Going to be implemented in **ver: 1.3.0**
        -x              Run Host Enumeration on IP, Domain, IP Range, or Selected IPs       # (fscan).
        -r              Render the README.md file
        -fp             Fetch the Public Proxies (HTTPS, SOCKS4)
        -waf            WAF Fingerprinting with option for checking Generic or (153 WAFs)
        -h              Help Menu

Example

1) python3 main.py -i 1.1.1.1
2) python3 main.py -x 192.168.0.1-122
3) python3 main.py -x 1.1.1.1
4) python3 main.py -x 192.168.0.1,192.168.0.12
5) python3 main.py -x example.com
6) python3 main.py -r
7) python3 main.py -fp
8) python3 main.py -waf

Todo

• Add More Modules
• Add more Offensive Tools
• Optimize the Workflow
• Implement Domain Enumeration
• Saving results in json, text Format

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT