pymultitor v4.0 releases: Python Multi Threaded Tor Proxy to bypass restrictions based on IP counters

pymultitor

Python Multi-Threaded Tor Proxy
Did you ever want to be at two different places at the same time?
When I asked myself this question, I actually started developing this solution in my mind.
While performing penetration tests there are often problems caused by security devices that block the “attacking” IP.
This really annoyed me, so I wrote a script to supply a solution for this problem.
With a large number of IP addresses performing the attacks, better results are guaranteed – especially when attempting attacks to bypass Web Application Firewalls, Brute-Force type attacks and many more.

HOW DOES PYMULTITOR WORK?

• PyMultitor works with EventLoop (Gevent) and multiple Tor processing (Sub Processes).
• Each Tor process is responsible for the connection between a single IP address (Proxy) and the target. Furthermore, each Tor process has two addresses – an internet address (Socks 4a Proxy) and a management address.
• Each time the programs identifies that the IP is blocked, a new identity is requested from Tor meaning a new IP address is issued to this connection. The request that was blocked is re-sent and the testing process will continue.

Changelog v4.0

• Moved to mitmproxy v10.1.6
• Add tor_config (to set custom to configuration)
• Add tor_timeout (to timeout tor process creation)
• Add tor_tries (to retry when tor process creation fails)
• Add on_status_code (to change IP on specific status code)

Installation

Prerequisites

• Python 3.6+.
• mitmproxy (https://mitmproxy.com/).
• tor.
  • On Ubuntu / Kali, sudo apt install -y tor
  • On Centos, sudo yum install -y tor
  • On Fedora, sudo dnf install -y tor
  • On Windows,
    • download tor expert bundle: https://www.torproject.org/download/tor/
    • insert tor to your path environment: {tor-win32-*_path}\Tor
    • if you don’t know how to remember tor.exe path and use –tor-cmd argument on pymultitor (for example: pymultitor –tor-cmd “c:\Pentest\Web\tor-win32-0.2.9.9\Tor\tor.exe”)
  • On MacOS, brew install tor

Installation

• From pip:
  

  pip3 install pymultitor

   

• From source:
  

  git clone https://github.com/realgam3/pymultitor.git
  cd pymultitor
  pip3 install -r requirements.txt
  python3 setup.py install

   

Usage

Run pymultitor --on-string "Your IP Address Blocked".
On your script use proxy (http://127.0.0.1:8080).
When the string Your IP Address Blocked will present in the response content, you will exit from another IP address.

Usage: pymultitor [-h] [-v] [-lh LISTEN_HOST] [-lp LISTEN_PORT] [-s] [-i] [-d]
                  [-p PROCESSES] [-c CMD] [--on-count ON_COUNT]
                  [--on-string ON_STRING] [--on-regex ON_REGEX] [--on-rst]

# When To Change IP Address
--on-count    Change IP Every x Requests (Resources Also Counted).
--on-string   Change IP When String Found On The Response Content.
--on-regex    Change IP When Regex Found On The Response Content.
--on-rst      Change IP When Connection Closed With TCP RST.

Copyright (C) 2017 realgam3

 Source: https://github.com/realgam3/