Skip to content

Latest commit

 

History

History
140 lines (107 loc) · 5.4 KB

README.md

File metadata and controls

140 lines (107 loc) · 5.4 KB
Raw

Logo

Redirect chain analysis tool with random user agents supporting VPN and TOR as a network configuration.

Table of Contents

📝 Pre-requisites

  • clone this project with the following command
$ git clone https://github.com/martinkubecka/redSnooper.git

📦 Installing Required Packages

$ pip install -r requirements.txt

💾 Software

  • user your package manager to install Tor and OpenVPN

🔐 VPN configuration

  1. get a NordVPN account
  2. download and unzip NordVPN configuration files for OpenVPN manual setup in to the config directory
  3. create vpn_login.txt file in the config directory and put your NordVPN credentials (email and password) on the separate lines
  4. copy your vpn_login.txt to the ovpn_udp and ovpn_tcp directories
  5. run the two find commands below to add your vpn_login.txt authentication file to the OpenVPN configuration files
$ cd config/
[config]$ wget https://downloads.nordcdn.com/configs/archives/servers/ovpn.zip -O ovpn.zip 
[config]$ unzip ovpn.zip
[config]$ rm ovpn.zip
[config]$ cp vpn_login.txt ovpn_udp/
[config]$ cp vpn_login.txt ovpn_tcp/
[config]$ find ovpn_udp/ -type f -name "*nordvpn.com.udp.ovpn" -print0 | xargs -0 sed -i 's+auth-user-pass+auth-user-pass config/ovpn_tcp/vpn_login.txt+'
[config]$ find ovpn_tcp/ -type f -name "*nordvpn.com.tcp.ovpn" -print0 | xargs -0 sed -i 's+auth-user-pass+auth-user-pass config/ovpn_tcp/vpn_login.txt+'
[config]$ rm vpn_login.txt

🦊 Firefox (gecko) driver

  1. download the latest release of geckodriver from https://github.com/mozilla/geckodriver/releases
  2. extract the file
  3. make the file executable
  4. move the geckodriver to the /usr/local/bin/ directory
$ wget https://github.com/mozilla/geckodriver/releases/download/v0.*.*/geckodriver-v0.*.*-linux64.tar.gz
$ tar -xvzf geckodriver* 
$ chmod +x geckodriver
$ sudo mv geckodriver /usr/local/bin/

🖥️ Usage

usage: redSnooper.py [-h] -u URL [-n OPTION] [-c COUNTRY] [-a OPTION] [-v LEVEL] [--check]

Redirect chain analysis tool with random user agents supporting VPN and TOR as a network configuration

options:
  -h, --help                      show this help message and exit
  -u URL, --url URL               URL for analysis (use double quotes)
  -n OPTION, --network OPTION     network configuration option [VPN/TOR] (default: current network configuration)
  -c COUNTRY, --country COUNTRY   VPN country [SK/FR/US] (required if VPN is selected)
  -a OPTION, --user-agent OPTION  user agent [Desktop/Android/iOS] (default: Desktop)
  -v LEVEL, --verbosity LEVEL     redirect chain verbosity [0/1] (default: 0)
  --check                         check HTTP status code

⛓️ Redirect Chain Examples

🚥 Check HTTP Status Code Examples

🧰 Development

🏢 Virtual environment

  1. use your package manager to install python-pip if it is not present on your system
  2. install virtualenv
  3. verify installation by checking the virtualenv version
  4. inside the project directory create a virtual environment called venv
  5. activate it by using the source command
  6. you can deactivate the virtual environment from the parent folder of venv directory with the deactivate command
$ sudo apt-get install python-pip
$ pip install virtualenv
$ virtualenv --version
$ virtualenv --python=python3 venv
$ source venv/bin/activate
$ deactivate

☑️ To-Do

  • load multiple URLs from file for HTTP status code check
  • support CIDR notation for checking forbidden IP addresses
  • change loading VPN configurations from a json file to dynamically loading paths
  • support more countries with VPN servers
  • implement proper whitelist domain filtering