PyMultiTor

PyPI - Python Version

Proxy Tor Multi Hilo en Python,
¿Alguna vez quisiste estar en dos lugares diferentes al mismo tiempo?
Cuando me hice esta pregunta, comencé a desarrollar esta solución en mi mente.
Al realizar pruebas de penetración a menudo surgen problemas causados por dispositivos de seguridad que bloquean la IP "atacante".
Esto realmente me molestaba, así que escribí un script para proporcionar una solución a este problema.
Con un gran número de direcciones IP realizando los ataques, se garantizan mejores resultados, especialmente al intentar ataques para evadir Firewalls de Aplicaciones Web, ataques de tipo fuerza bruta y muchos más.

[Blackhat Asia] https://www.blackhat.com/asia-17/arsenal.html#pymultitor
[Presentación de OWASP-IL] https://www.owasp.org/images/3/3d/OWASPIL-2016-02-02_PyMultiTor_TomerZait.pdf
[Artículo de DigitalWhisper (Hebreo)] http://www.digitalwhisper.co.il/files/Zines/0x2E/DW46-3-PyMultitor.pdf

Logo

Instalación

Requisitos previos

Python 3.10+.
mitmproxy (https://mitmproxy.org/).
tor.
- En Ubuntu / Kali, sudo apt install -y tor
- En Centos, sudo yum install -y tor
- En Fedora, sudo dnf install -y tor
- En Windows,
  - descarga el paquete experto de tor: https://www.torproject.org/download/tor/
  - inserta tor en tu variable de entorno PATH: {tor-win32-*_path}\Tor
  - si no sabes cómo, recuerda la ruta de tor.exe y usa el argumento --tor-cmd en pymultitor (por ejemplo: pymultitor --tor-cmd "c:\Pentest\Web\tor-win32-0.2.9.9\Tor\tor.exe")
- En MacOS, brew install tor

Desde pip

pip3 install pymultitor

Desde Docker

docker pull realgam3/pymultitor

Desde el código fuente

git clone https://github.com/realgam3/pymultitor.git
cd pymultitor

# Instala las dependencias de Python.
# Dependiendo de tu configuración, uno o ambos comandos pueden requerir sudo.
pip3 install -r requirements.txt
python3 setup.py install

# Confirma que todo funciona
pymultitor --help

¡Se aceptan informes de errores sobre problemas de instalación!

Uso

Uso básico

Ejecuta pymultitor --on-string "Your IP Address Blocked".
En tu script usa el proxy (http://127.0.0.1:8080).
Cuando la cadena Your IP Address Blocked esté presente en el contenido de la respuesta, saldrás desde otra dirección IP.

Uso con Docker

Ejecuta docker run --rm -p 8080:8080 realgam3/pymultitor --on-string "Your IP Address Blocked".
En tu script usa el proxy (http://127.0.0.1:8080).
Cuando la cadena Your IP Address Blocked esté presente en el contenido de la respuesta, saldrás desde otra dirección IP.

Uso de la API

PyMultiTor proporciona una API REST para gestionar identidades de proxy. Puedes usar la API para cambiar tu identidad de proxy bajo demanda.

Autenticación

La API requiere autenticación mediante un token Bearer. Puedes configurar el token de dos maneras:

Variable de entorno: Establece la variable de entorno PYMULTITOR_TOKEN:
```
export PYMULTITOR_TOKEN="your-secret-token-here"
```
Nota: Si no se establece PYMULTITOR_TOKEN, PyMultiTor generará automáticamente un token aleatorio para ti.
Línea de comandos: inicia PyMultiTor:
```
pymultitor
```

Endpoints

Cambiar Identidad

URL: /identity
Método: POST

Ejemplo de uso:

curl http://pymultitor/identity -X POST \
  --header "Proxy-Authorization: Bearer {Token}" \
  --proxy http://localhost:8080

Estado

URL: /status
Método: GET