PyMultiTor

PyPI - Python Version

Proxy Tor multi‑threadé en Python,
Avez‑vous déjà voulu être à deux endroits différents en même temps ?
Quand je me suis posé cette question, j'ai en fait commencé à développer cette solution dans mon esprit.
Lors de tests d'intrusion, il y a souvent des problèmes causés par des dispositifs de sécurité qui bloquent l'IP « attaquante ».
Cela m'a vraiment ennuyé, alors j'ai écrit un script pour fournir une solution à ce problème.
Avec un grand nombre d'adresses IP effectuant les attaques, de meilleurs résultats sont garantis – en particulier lors de tentatives d'attaques pour contourner les pare‑feu d'applications Web, les attaques de type force brute et bien d'autres.

[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 (Hébreu)] http://www.digitalwhisper.co.il/files/Zines/0x2E/DW46-3-PyMultitor.pdf

Logo

Installation

Prérequis

Python 3.10+.
mitmproxy (https://mitmproxy.org/).
tor.
- Sur Ubuntu / Kali, sudo apt install -y tor
- Sur Centos, sudo yum install -y tor
- Sur Fedora, sudo dnf install -y tor
- Sur Windows,
  - téléchargez le bundle expert Tor : https://www.torproject.org/download/tor/
  - insérez tor dans votre variable d'environnement PATH : {tor-win32-*_path}\Tor
  - si vous ne savez pas comment faire, retenez le chemin de tor.exe et utilisez l'argument --tor-cmd avec pymultitor (par exemple : pymultitor --tor-cmd "c:\Pentest\Web\tor-win32-0.2.9.9\Tor\tor.exe")
- Sur macOS, brew install tor

Depuis pip

pip3 install pymultitor

Depuis Docker

docker pull realgam3/pymultitor

Depuis les sources

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

# Installez les dépendances Python.
# Selon votre configuration, l'une ou les deux peuvent nécessiter sudo.
pip3 install -r requirements.txt
python3 setup.py install

# Confirmez que tout fonctionne
pymultitor --help

Les rapports de bogues sur les problèmes d'installation sont les bienvenus !

Utilisation

Utilisation de base

Exécutez pymultitor --on-string "Your IP Address Blocked".
Dans votre script, utilisez le proxy (http://127.0.0.1:8080).
Lorsque la chaîne Your IP Address Blocked sera présente dans le contenu de la réponse, vous sortirez d'une autre adresse IP.

Utilisation avec Docker

Exécutez docker run --rm -p 8080:8080 realgam3/pymultitor --on-string "Your IP Address Blocked".
Dans votre script, utilisez le proxy (http://127.0.0.1:8080).
Lorsque la chaîne Your IP Address Blocked sera présente dans le contenu de la réponse, vous sortirez d'une autre adresse IP.

Utilisation de l'API

PyMultiTor fournit une API REST pour gérer les identités de proxy. Vous pouvez utiliser l'API pour changer votre identité de proxy à la demande.

Authentification

L'API nécessite une authentification à l'aide d'un jeton Bearer. Vous pouvez définir le jeton de deux manières :

Variable d'environnement : définissez la variable d'environnement PYMULTITOR_TOKEN :
```
export PYMULTITOR_TOKEN="your-secret-token-here"
```
Remarque : si PYMULTITOR_TOKEN n'est pas défini, PyMultiTor générera automatiquement un jeton aléatoire pour vous.
Ligne de commande : démarrez PyMultiTor :
```
pymultitor
```

Points de terminaison

Changer d'identité

URL : /identity
Méthode : POST

Exemple d'utilisation :

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

Statut

URL : /status
Méthode : GET