「Black Hat Python」(ジャスティン・サイツ著)のソースコード。コードは完全にPython 3に変換され、PEP8標準に準拠するように再フォーマットされ、非推奨ライブラリの実装に伴う依存関係の問題を排除するためにリファクタリングされています。
Justin Seitz 著 Black Hat Python: Python Programming for Hackers and Pentesters(No Starch Press、2014年)初版のソースコードを、Python 2 から Python 3 へ変換し、現在のインタプリタとライブラリで動作するようにリファクタリングしたものです。
スクリプトは書籍に掲載されているリストに近い形を保っているため、書籍と並べて読み比べることができます。変換中に行ったすべての変更は docs/CONVERSION_NOTES.md に記録されています。
[!NOTE] No Starch Press は 2021 年に、Justin Seitz と Tim Arnold による 第2版を出版しており、こちらは最初から Python 3 向けに書かれています。本リポジトリは 第1版に準拠しています。第2版をお持ちの場合は、出版社のコードをご利用ください。
TJ O'Connor 著 Violent Python の対になる変換版は EONRaider/violent-python3 にあります。
Python 3.11 以降が必要です。以下のセットアップのいずれかを選択してください。
uv は、お使いの環境に適切な
Python バージョンがインストールされていない場合にインストールし、uv.lock から CI でテスト済みの正確な依存関係バージョンを再現します。
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
uv sync # every chapter
uv run python chapter02/bhnet.py -h
各章は個別のdependency groupであるため、読んでいる章だけをインストールできます:
uv sync --only-group ch04 # just chapter 4
Windows では、ch08-ch10 グループは pywin32 と wmi もインストールします。その他のプラットフォームでは自動的にスキップされます。
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-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 を使用してください。
pip 25.1 以降では、pip install --group ch04 を使って pyproject.toml から直接チャプターのグループをインストールすることもできます。
各リリースでは、クロスプラットフォーム対応のすべてのチャプターの依存関係と一般的なネットワークツールがプリインストールされた、linux/amd64 および linux/arm64 向けのイメージが公開されています:
docker run --rm -it ghcr.io/eonraider/blackhat-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/blackhat-python3
# Or build it yourself:
docker build -t blackhat-python3 . && docker run --rm -it blackhat-python3
イメージは root として実行されます。これは、ほとんどの raw ソケットの章で必要となるためです。コンテナはサンドボックスであるため、章が必要とする機能のみを追加してください。Windows の章(8〜10)はこのコンテナ内では実行できません。
上記の Open in GitHub Codespaces バッジを使用するか、Dev Containers 拡張機能を備えた VS Code または JetBrains でフォルダを開いてください。コンテナ(.devcontainer/devcontainer.json)には Docker イメージと同じツールに加えて uv、git、コンパイラが含まれており、raw ソケットの機能がすでに付与されています。
| 章 | トピック | uv グループ | PyPI パッケージ | 備考 |
|---|---|---|---|---|
| 02 | ネットワーク:基礎 | ch02 | paramiko | test_rsa.key は Paramiko の公開テストキー(テストスイート由来)で、bh_sshserver.py に必要です。 |
| 03 | raw ソケットとスニッフィング | - | - | 標準ライブラリのみ。root / Administrator が必要です。 |
| 04 | Scapy でネットワークを掌握する | ch04 | kamene、opencv-python | 変換当時の Scapy の Python 3 フォークである kamene を使用します。root / NET_RAW が必要です。 |
| 05 | Web ハッキング | - | - | 標準ライブラリのみ。ワードリスト all.txt と cain.txt が含まれています。 |
| 06 | Burp Proxy の拡張 | - | - | CPython ではなく Jython 2.7 上で動作する Burp Suite 拡張機能です(jython-standalone-2.7.2.jar が含まれています)。 |
| 07 | GitHub によるコマンドアンドコントロール | ch07 | github3.py | GitHub リポジトリと個人アクセストークンが必要です。 |
| 08 | Windows における一般的なトロイの木馬化タスク | ch08 | pywin32(Windows) | Windows 専用。keylogger.py は現時点でサポートされているどの Python でも動作しません。これは pyHook をインポートしていますが、インストール可能なものがこれを提供していないためです(変換メモを参照)。 |
| 09 | Internet Explorer で遊ぶ | ch09 | pycryptodome、pywin32(Windows) | 暗号ヘルパーを除き、Windows 専用です。 |
| 10 | Windows の特権昇格 | ch10 | pywin32(Windows)、wmi(Windows) | Windows 専用。bhvulnservice.zip は書籍の脆弱なサービスです。 |
| 11 | 攻撃的フォレンジックの自動化 | - | - | Immunity Debugger(immlib、Python 2.7)と Volatility 2 フレームワークが必要です。どちらも PyPI からはインストールできません。 |
書籍の第 1 章は環境のセットアップを扱っており、コードはありません。PyPI 列は、各章のインポートを読み取る python tools/deps_scan.py report によって生成されます。OS と特権に関する注記は変換メモに基づいており、不完全な可能性があります。修正は歓迎します。
完全なチェックアウトは約 46 MB に加えて 51 MB の履歴です。ツリーの大部分は chapter06/ にある 43 MB の Jython JAR であるため、シャロークローン(--depth 1)ではあまり節約になりません。必要な章だけをダウンロードするには:
git clone --filter=blob:none --sparse https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
git sparse-checkout set chapter02 chapter03 # any chapters you want
クローンを完全にスキップして、Docker イメージを使用することもできます。
このコードには、トロイの木馬、キーロガー、認証情報収集ツール、権限昇格ツールが含まれています。自身が所有するシステム、または書面によるテスト許可を得たシステムに対してのみ実行してください。chapter10/bhvulnservice.zip、chapter11/cmeasure.bin、および第8章のキーロガーなど、一部のファイルはアンチウイルスソフトウェアによって検出される可能性があります。これは想定内のことです。詳細は SECURITY.md を参照してください。
バグ修正、新しいライブラリへの互換性修正、ドキュメントの改善を歓迎します。対象範囲、開発ワークフロー、リリースの切り方については CONTRIBUTING.md を参照してください。セキュリティ問題の報告方法は SECURITY.md に記載されています。
turkish-language ブランチこのコードは、No Starch Press から出版された Justin Seitz 著 Black Hat Python に由来します。オープンソースライセンスは付与されていません。その意味と、同梱されているサードパーティファイルの条件については NOTICE を参照してください。Python 3 への変換は EONRaider とコントリビューターによるもので、Enraged による修正も含まれています。
学術論文でこのリポジトリを参照する場合、GitHub の Cite this repository ボタンは CITATION.cff を使用します。