PyMultiTor

PyPI - Python Version

Proxy Tor Multi-Thread Python,
Hai mai desiderato essere in due posti diversi contemporaneamente?
Quando mi sono posto questa domanda, ho iniziato a sviluppare questa soluzione nella mia mente.
Durante i test di penetrazione, ci sono spesso problemi causati da dispositivi di sicurezza che bloccano l'IP "attaccante".
Ciò mi infastidiva molto, così ho scritto uno script per fornire una soluzione a questo problema.
Con un gran numero di indirizzi IP che eseguono gli attacchi, sono garantiti risultati migliori - specialmente quando si tentano attacchi per bypassare Web Application Firewall, attacchi di tipo brute-force e molti altri.

[Blackhat Asia] https://www.blackhat.com/asia-17/arsenal.html#pymultitor
[Owasp-IL Presentation] https://www.owasp.org/images/3/3d/OWASPIL-2016-02-02_PyMultiTor_TomerZait.pdf
[DigitalWhisper Article (Hebrew)] http://www.digitalwhisper.co.il/files/Zines/0x2E/DW46-3-PyMultitor.pdf

Logo

Installazione

Prerequisiti

Python 3.10+.
mitmproxy (https://mitmproxy.org/).
tor.
- Su Ubuntu / Kali, sudo apt install -y tor
- Su Centos, sudo yum install -y tor
- Su Fedora, sudo dnf install -y tor
- Su Windows,
  - scarica il tor expert bundle: https://www.torproject.org/download/tor/
  - aggiungi tor al tuo PATH di ambiente: {tor-win32-*_path}\Tor
  - se non sai come fare, ricorda il percorso di tor.exe e usa l'argomento --tor-cmd su pymultitor (ad esempio: pymultitor --tor-cmd "c:\Pentest\Web\tor-win32-0.2.9.9\Tor\tor.exe")
- Su MacOS, brew install tor

Da pip

pip3 install pymultitor

Da Docker

docker pull realgam3/pymultitor

Da sorgente

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

# Installa le dipendenze python.
# A seconda della configurazione, uno o entrambi potrebbero richiedere sudo.
pip3 install -r requirements.txt
python3 setup.py install

# Conferma che tutto funzioni
pymultitor --help

Segnalazioni di bug relativi all'installazione sono benvenute!

Utilizzo

Utilizzo base

Esegui pymultitor --on-string "Your IP Address Blocked".
Nel tuo script usa il proxy (http://127.0.0.1:8080).
Quando la stringa Your IP Address Blocked sarà presente nel contenuto della risposta, uscirai da un altro indirizzo IP.

Utilizzo Docker

Esegui docker run --rm -p 8080:8080 realgam3/pymultitor --on-string "Your IP Address Blocked".
Nel tuo script usa il proxy (http://127.0.0.1:8080).
Quando la stringa Your IP Address Blocked sarà presente nel contenuto della risposta, uscirai da un altro indirizzo IP.

Utilizzo API

PyMultiTor fornisce un'API REST per gestire le identità del proxy. Puoi utilizzare l'API per cambiare la tua identità proxy su richiesta.

Autenticazione

L'API richiede autenticazione tramite un token Bearer. Puoi impostare il token in due modi:

Variabile d'ambiente: Imposta la variabile d'ambiente PYMULTITOR_TOKEN:
```
export PYMULTITOR_TOKEN="your-secret-token-here"
```
Nota: Se PYMULTITOR_TOKEN non è impostata, PyMultiTor genererà automaticamente un token casuale per te.
Riga di comando: avviando PyMultiTor:
```
pymultitor
```

Endpoint

Cambia identità

URL: /identity
Metodo: POST

Esempio di utilizzo:

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

Stato

URL: /status
Metodo: GET