TJ O'Connorの書籍「Violent Python」のソースコード。このコードは完全にPython 3に変換され、PEP8規格に準拠するよう再フォーマットされ、非推奨ライブラリの実装に起因する依存関係の問題を解消するためにリファクタリングされています。
TJ O'Connor 著 Violent Python: A Cookbook for Hackers, Forensic Analysts, Penetration Testers and Security Engineers(Syngress、2012年)のソースコードを、 Python 2 から Python 3 へ変換し、現在のインタプリタとライブラリで動作するよう リファクタリングしたものです。
スクリプトは書籍の掲載リストに近い形を保っているため、書籍と並べて読み比べることが できます。変換中に行ったすべての変更は docs/CONVERSION_NOTES.md に記録されています。
[!NOTE] Justin Seitz 著 Black Hat Python の対になる変換版は EONRaider/blackhat-python3 にあります。
Python 3.11 以降が必要です。以下のセットアップのいずれかを選択してください。
uv は、お使いの環境に
適切な Python バージョンがインストールされていない場合にインストールし、CI で
テスト済みの正確な依存関係バージョンを uv.lock から再現します。
git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
uv sync # every chapter
uv run python chapter04/geo_ip.py -h
各章は個別のdependency groupであるため、読んでいる章だけをインストールできます:
uv sync --only-group ch04 # just chapter 4
uv sync --group ch05-bluetooth # add the opt-in Bluetooth extras (Linux)
git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt # every chapter
pip install -r requirements/ch04.txt # or just one chapter
requirements*.txt にはバージョン範囲が記載されています。CI でテスト済みの正確なバージョンを使用するには、最新リリースから requirements-lock.txt(およびオプトイングループ用の requirements-lock-bluetooth.txt)を使用してください。
pip 25.1 以降では、pip install --group ch04 を使って pyproject.toml から章のグループを直接インストールすることもできます。
各リリースでは、すべての章の依存関係、nmap、tcpdump、および BlueZ ランタイムがプリインストールされた linux/amd64 および linux/arm64 用のイメージが公開されています:
docker run --rm -it ghcr.io/eonraider/violent-python3
# Chapters that sniff or forge packets need raw-socket capabilities:
docker run --rm -it --cap-add=NET_RAW --cap-add=NET_ADMIN ghcr.io/eonraider/violent-python3
# Or build it yourself:
docker build -t violent-python3 . && docker run --rm -it violent-python3
このイメージは root として実行されます。これは、ほとんどの raw ソケットの章で必要となるためです。上記のケーパビリティのみでも、コンテナはそれらのスクリプトをホストから分離するので、章が必要とするものだけを追加してください。Bluetooth(第5章)は異なります。アダプタに到達するためにホストのネットワーク名前空間が必要で、例えば --net=host --cap-add=NET_RAW --cap-add=NET_ADMIN を使用します。これはネットワーク分離を解除するため、コンテナはすべてのホストトラフィックを参照し、操作できるようになります。--privileged は避けてください。これもコンテナにすべてのホストデバイスへのアクセスを与えてしまいます。
上記の Open in GitHub Codespaces バッジを使用するか、Dev Containers 拡張機能を入れた VS Code または JetBrains でフォルダを開いてください。コンテナ(.devcontainer/devcontainer.json)には Docker イメージと同じツールに加えて uv、git、コンパイラが含まれ、raw ソケットのケーパビリティがすでに付与されています。
一部の章は外部プログラムを呼び出したり、ネイティブライブラリを必要としたりします。Docker イメージと dev コンテナにはすでに含まれています。ホスト上ではご自身でインストールしてください:
| 必要な対象 | Debian / Ubuntu / Kali | macOS (Homebrew) |
|---|---|---|
chapter02/nmap_scan.py、conficker.py | apt install nmap | brew install nmap |
| パケットキャプチャ(第4〜5章) | apt install libpcap0.8 tcpdump | 標準搭載 |
ch05-bluetooth グループ | apt install libbluetooth-dev | 非対応 |
| 章 | トピック | uv グループ | PyPI パッケージ | 備考 |
|---|---|---|---|---|
| 01 | はじめに | ch01 | standard-crypt(Windows 非対応、Python 3.13+) | crypt は 3.13 で標準ライブラリから削除されました(PEP 594)。バックポートにより passwd_crack.py が動作し続けます。元のモジュールと同様に libc の crypt(3) をラップするため、passwd_crack.py は Windows では動作しません。 |
| 02 | ペネトレーションテスト | ch02 | pexpect、python-nmap | nmap バイナリが必要です。管理下のホストに対して SSH と FTP を使用します。 |
| 03 | フォレンジック調査 | ch03 | beautifulsoup4、pillow、pypdf4、requests | discover_networks.py と dump_recyclebin.py は Windows レジストリを読み取るため、管理者権限を持つ Windows が必要です。サンプルの Firefox/Skype データベースと PDF が含まれています。 |
| 04 | ネットワークトラフィック分析 | ch04 | dpkt、geoip2、ipy、scapy | サンプルの .pcap ファイルと 2020 年の GeoLite2 City データベースが含まれています。使用前にデータベースを最新のダウンロードに置き換えてください(NOTICE を参照)。ライブスニッフィングには root / NET_RAW が必要です。 |
| 05 | ワイヤレス攻撃 | ch05、ch05-bluetooth | scapy、pybluez(Linux、オプトイン) | Wi-Fi スクリプトにはモニターモードのカードが必要です。ninja_print.py は ObexFTP の Python 2 バインディングを必要とし、Python 3 への移植版はありません。 |
| 06 | Web 偵察 | ch06 | beautifulsoup4、mechanicalsoup | Google と Twitter のスクリプトはもはや存在しない API を対象としています。変換メモを参照してください。 |
| 07 | アンチウイルス回避 | - | - | 標準ライブラリのみ。 |
PyPI 列は python tools/deps_scan.py report によって生成され、各章のインポートを読み取ります。OS と権限に関する注記は変換メモに由来するため、不完全な場合があります。修正は歓迎します。
完全なチェックアウトは約 100 MB で、そのほとんどがサンプルデータです:chapter04/ 内の 63 MB の GeoLite2 データベースと、chapter02/ 内の 30 MB の脆弱な Debian SSH 鍵のアーカイブです。これらのファイルは現在のツリーの一部であるため、シャロークローン(--depth 1)ではほとんど節約できません。必要な章だけをダウンロードするには:
git clone --filter=blob:none --sparse https://github.com/EONRaider/violent-python3.git
cd violent-python3
git sparse-checkout set chapter01 chapter03 # any chapters you want
クローンを完全に省略して、Dockerイメージを使用することもできます。
このコードは実際の攻撃を実行します:パスワードクラッキング、SSHブルートフォース、パケットインジェクション、ワイヤレスおよびBluetoothのエクスプロイトです。所有しているシステム、または書面によるテスト許可を得ているシステムに対してのみ実行してください。
バグ修正、新しいライブラリへの互換性修正、ドキュメントの改善を歓迎します。対象範囲、開発ワークフロー、リリースの切り方についてはCONTRIBUTING.mdを参照してください。セキュリティ問題の報告方法はSECURITY.mdに記載されています。
turkish-languageブランチこのコードは、Elsevier, Inc.のインプリントであるSyngressから出版されたTJ O'Connor著 Violent Python に由来します。オープンソースライセンスは付与されていません。その意味と、同梱されているサードパーティファイルの条件についてはNOTICEを参照してください。Python 3への変換はEONRaiderとコントリビューターによるものです。
学術論文でこのリポジトリを参照する場合、GitHubのCite this repositoryボタンはCITATION.cffを使用します。