PyMultiTor

PyPI - Python Version

Proxy Tor Multi Threaded em Python,
Você já quis estar em dois lugares diferentes ao mesmo tempo?
Quando me fiz essa pergunta, comecei a desenvolver esta solução em minha mente.
Ao realizar testes de penetração, frequentemente há problemas causados por dispositivos de segurança que bloqueiam o IP "atacante".
Isso realmente me irritou, então escrevi um script para fornecer uma solução para esse problema.
Com um grande número de endereços IP realizando os ataques, melhores resultados são garantidos - especialmente ao tentar ataques para contornar Firewalls de Aplicação Web, ataques do tipo força bruta e muitos outros.

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

Logo

Instalação

Pré-requisitos

Python 3.10+.
mitmproxy (https://mitmproxy.org/).
tor.
- No Ubuntu / Kali, sudo apt install -y tor
- No CentOS, sudo yum install -y tor
- No Fedora, sudo dnf install -y tor
- No Windows,
  - baixe o tor expert bundle: https://www.torproject.org/download/tor/
  - insira o tor no seu path de ambiente: {tor-win32-*_path}\Tor
  - se você não souber como, lembre-se do caminho do tor.exe e use o argumento --tor-cmd no pymultitor (por exemplo: pymultitor --tor-cmd "c:\Pentest\Web\tor-win32-0.2.9.9\Tor\tor.exe")
- No MacOS, brew install tor

Via pip

pip3 install pymultitor

Via Docker

docker pull realgam3/pymultitor

A partir do código fonte

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

# Install python dependencies.
# Depending on your setup, one or both of these may require sudo.
pip3 install -r requirements.txt
python3 setup.py install

# Confirm that everything works
pymultitor --help

Relatórios de bugs sobre problemas de instalação são bem-vindos!

Uso

Uso Básico

Execute pymultitor --on-string "Your IP Address Blocked".
No seu script, use o proxy (http://127.0.0.1:8080).
Quando a string Your IP Address Blocked estiver presente no conteúdo da resposta, você sairá de outro endereço IP.

Uso com Docker

Execute docker run --rm -p 8080:8080 realgam3/pymultitor --on-string "Your IP Address Blocked".
No seu script, use o proxy (http://127.0.0.1:8080).
Quando a string Your IP Address Blocked estiver presente no conteúdo da resposta, você sairá de outro endereço IP.

Uso da API

O PyMultiTor fornece uma API REST para gerenciar identidades de proxy. Você pode usar a API para alterar sua identidade de proxy sob demanda.

Autenticação

A API requer autenticação usando um token Bearer. Você pode definir o token de duas maneiras:

Variável de Ambiente: Defina a variável de ambiente PYMULTITOR_TOKEN:
```
export PYMULTITOR_TOKEN="your-secret-token-here"
```
Nota: Se PYMULTITOR_TOKEN não estiver definido, o PyMultiTor gerará automaticamente um token aleatório para você.
Linha de Comando: ao iniciar o PyMultiTor:
```
pymultitor
```

Endpoints

Alterar Identidade

URL: /identity
Método: POST

Exemplo de Uso:

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

Status

URL: /status
Método: GET