PyMultiTor

PyPI - Python Version

Python マルチスレッド Tor プロキシ。
同時に2つの異なる場所にいたいと思ったことはありませんか？
自問したとき、頭の中でこのソリューションを開発し始めました。
ペネトレーションテストを実行中に、「攻撃」IP をブロックするセキュリティデバイスによる問題がよく発生します。
これには本当にイライラさせられたので、この問題を解決するスクリプトを作成しました。
多数の IP アドレスを使って攻撃を行うことで、特に Web アプリケーションファイアウォールのバイパス、ブルートフォース攻撃などを試みる場合、より良い結果が保証されます。

[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 (ヘブライ語)] 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 のパスを覚えておき、pymultitor で --tor-cmd 引数を使用してください（例: 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

# 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

インストールに関するバグ報告は歓迎します！

使い方

基本的な使い方

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 は、プロキシ ID を管理するための REST API を提供します。API を使用すると、必要に応じてプロキシ ID を変更できます。

認証

API は Bearer トークンによる認証が必要です。トークンは以下の2つの方法で設定できます。

環境変数: PYMULTITOR_TOKEN 環境変数を設定します。
```
export PYMULTITOR_TOKEN="your-secret-token-here"
```
注意: PYMULTITOR_TOKEN が設定されていない場合、PyMultiTor はランダムなトークンを自動生成します。
コマンドライン: PyMultiTor の起動時:
```
pymultitor
```

エンドポイント

ID 変更

URL: /identity
Method: POST

使用例:

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

ステータス

URL: /status
Method: GET