PyMultiTor

PyPI - Python Version

Python Multi Threaded Tor Proxy,
Вы когда-нибудь хотели быть в двух разных местах одновременно?
Когда я задал себе этот вопрос, я начал разрабатывать это решение в своём уме.
При проведении пентестов часто возникают проблемы, связанные с устройствами безопасности, блокирующими «атакующий» IP.
Это меня очень раздражало, поэтому я написал скрипт, который решает эту проблему.
Большое количество IP-адресов для выполнения атак гарантирует лучшие результаты — особенно при попытках
обхода Web Application Firewall, атак типа Brute-Force и многих других.

[Blackhat Asia] https://www.blackhat.com/asia-17/arsenal.html#pymultitor
[Презентация Owasp-IL] https://www.owasp.org/images/3/3d/OWASPIL-2016-02-02_PyMultiTor_TomerZait.pdf
[Статья DigitalWhisper (иврит)] http://www.digitalwhisper.co.il/files/Zines/0x2E/DW46-3-PyMultitor.pdf

Logo

Установка

Предварительные требования

Python 3.10+.
mitmproxy (https://mitmproxy.org/).
tor.
- На Ubuntu / Kali, sudo apt install -y tor
- На Centos, sudo yum install -y tor
- На Fedora, sudo dnf install -y tor
- На Windows,
  - скачайте tor expert bundle: https://www.torproject.org/download/tor/
  - добавьте tor в переменную окружения PATH: {tor-win32-*_path}\Tor
  - если вы не знаете, как это сделать, запомните путь к tor.exe и используйте аргумент --tor-cmd в pymultitor (например: pymultitor --tor-cmd "c:\Pentest\Web\tor-win32-0.2.9.9\Tor\tor.exe")
- На MacOS, brew install tor

Из pip

pip3 install pymultitor

Из Docker

docker pull realgam3/pymultitor

Из исходного кода

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

# Установка зависимостей Python.
# В зависимости от вашей конфигурации может потребоваться sudo.
pip3 install -r requirements.txt
python3 setup.py install

# Проверка корректности установки
pymultitor --help

Будем рады сообщениям об ошибках при установке!

Использование

Базовое использование

Запустите pymultitor --on-string "Your IP Address Blocked".
В вашем скрипте используйте прокси (http://127.0.0.1:8080).
Когда строка Your IP Address Blocked появится в содержимом ответа, вы получите новый выходной IP-адрес.

Использование с Docker

Запустите docker run --rm -p 8080:8080 realgam3/pymultitor --on-string "Your IP Address Blocked".
В вашем скрипте используйте прокси (http://127.0.0.1:8080).
Когда строка Your IP Address Blocked появится в содержимом ответа, вы получите новый выходной IP-адрес.

Использование API

PyMultiTor предоставляет REST API для управления идентификаторами прокси. Вы можете использовать API для смены идентификатора прокси по запросу.

Аутентификация

Для аутентификации в API требуется токен Bearer. Вы можете установить токен двумя способами:

Переменная окружения: Установите переменную окружения PYMULTITOR_TOKEN:
```
export PYMULTITOR_TOKEN="your-secret-token-here"
```
Примечание: Если PYMULTITOR_TOKEN не задан, PyMultiTor автоматически сгенерирует случайный токен.
Командная строка: при запуске PyMultiTor:
```
pymultitor
```

Эндпоинты

Сменить идентификатор

URL: /identity
Метод: POST

Пример использования:

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

Статус

URL: /status
Метод: GET