Quellcode für das Buch "Black Hat Python" von Justin Seitz. Der Code wurde vollständig auf Python 3 konvertiert, gemäß den PEP8-Standards neu formatiert und umgestaltet, um Abhängigkeitsprobleme zu beseitigen, die durch die Verwendung veralteter Bibliotheken entstehen.
Der Quellcode aus der ersten Ausgabe von Black Hat Python: Python Programming for Hackers and Pentesters von Justin Seitz (No Starch Press, 2014), von Python 2 nach Python 3 konvertiert und überarbeitet, um auf aktuellen Interpretern und Bibliotheken zu laufen.
Die Skripte bleiben nah an den gedruckten Listings, damit sie Seite an Seite mit dem Buch gelesen werden können. Jede während der Konvertierung vorgenommene Änderung ist in docs/CONVERSION_NOTES.md dokumentiert.
[!NOTE] No Starch Press veröffentlichte 2021 eine zweite Ausgabe von Justin Seitz und Tim Arnold, die von Anfang an für Python 3 geschrieben wurde. Dieses Repository folgt der ersten Ausgabe. Wenn Sie die zweite Ausgabe besitzen, verwenden Sie stattdessen den Code des Verlags.
Eine begleitende Konvertierung von Violent Python von TJ O'Connor findet sich unter EONRaider/violent-python3.
Python 3.11 oder neuer. Wählen Sie eine der folgenden Einrichtungen.
uv installiert die richtige
Python-Version, falls Sie sie nicht haben, und reproduziert die exakten Abhängigkeitsversionen,
die in CI aus uv.lock getestet wurden.
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
uv sync # every chapter
uv run python chapter02/bhnet.py -h
Jedes Kapitel ist eine separate Dependency-Gruppe, sodass du nur das installieren kannst, was du gerade liest:
uv sync --only-group ch04 # just chapter 4
Unter Windows installieren die Gruppen ch08-ch10 zusätzlich pywin32 und wmi; auf anderen
Plattformen werden sie automatisch übersprungen.
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 enthalten Versionsbereiche. Für die exakten in CI getesteten Versionen verwende
requirements-lock.txt aus dem neuesten Release.
Mit pip 25.1 oder neuer kannst du auch die Gruppe eines Kapitels direkt aus
pyproject.toml mit pip install --group ch04 installieren.
Jedes Release veröffentlicht ein
Image für linux/amd64 und linux/arm64 mit den Abhängigkeiten jedes plattformübergreifenden Kapitels
und gängigen Netzwerk-Tools vorinstalliert:
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
Das Image läuft als root, weil die meisten Raw-Socket-Kapitel dies benötigen. Der Container
ist die Sandbox, daher sollten nur die Capabilities hinzugefügt werden, die ein Kapitel benötigt. Die Windows-Kapitel
(8-10) können darin nicht ausgeführt werden.
Verwenden Sie das oben stehende Badge Open in GitHub Codespaces, oder öffnen Sie den Ordner in VS Code oder
JetBrains mit der Dev Containers-Erweiterung. Der Container
(.devcontainer/devcontainer.json) enthält dieselben Tools
wie das Docker-Image, zusätzlich uv, git und Compiler, und kommt mit bereits
gewährten Raw-Socket-Capabilities.
| Kapitel | Thema | uv-Gruppe | PyPI-Pakete | Hinweise |
|---|---|---|---|---|
| 02 | Das Netzwerk: Grundlagen | ch02 | paramiko | test_rsa.key ist Paramikos öffentlicher Testschlüssel (aus dessen Testsuite), benötigt von bh_sshserver.py. |
| 03 | Raw Sockets und Sniffing | - | - | Nur Standardbibliothek. Benötigt root / Administrator. |
| 04 | Das Netzwerk mit Scapy übernehmen | ch04 | kamene, opencv-python | Verwendet kamene, einen Python-3-Fork von Scapy aus der Zeit der Konvertierung. Benötigt root / NET_RAW. |
| 05 | Web-Hackerei | - | - | Nur Standardbibliothek. Die Wortlisten all.txt und cain.txt sind enthalten. |
| 06 | Burp Proxy erweitern | - | - | Burp-Suite-Erweiterungen, die unter Jython 2.7 laufen (jython-standalone-2.7.2.jar ist enthalten), nicht unter CPython. |
| 07 | GitHub Command and Control | ch07 | github3.py | Benötigt ein GitHub-Repository und ein persönliches Zugriffstoken. |
| 08 | Gängige Trojanisierungsaufgaben unter Windows | ch08 | pywin32 (Windows) | Nur Windows. keylogger.py läuft noch unter keinem unterstützten Python: Es importiert pyHook, das von keinem installierbaren Paket bereitgestellt wird (siehe die Konvertierungshinweise). |
| 09 | Spaß mit Internet Explorer | ch09 | pycryptodome, pywin32 (Windows) | Nur Windows, außer den Krypto-Hilfsfunktionen. |
| 10 | Windows-Privilegieneskalation | ch10 | pywin32 (Windows), wmi (Windows) | Nur Windows. bhvulnservice.zip ist der verwundbare Dienst aus dem Buch. |
| 11 | Offensive Forensik automatisieren | - | - | Benötigt Immunity Debugger (immlib, Python 2.7) und das Volatility-2-Framework. Beides lässt sich nicht über PyPI installieren. |
Kapitel 1 des Buchs behandelt die Einrichtung der Umgebung und enthält keinen Code. Die PyPI-
Spalte wird von python tools/deps_scan.py report generiert, das die Imports in
jedem Kapitel ausliest. Die Hinweise zu Betriebssystem und Privilegien stammen aus den Konvertierungshinweisen und sind möglicherweise
unvollständig; Korrekturen sind willkommen.
Ein vollständiger Checkout umfasst etwa 46 MB plus 51 MB an Historie. Der Großteil des Baums ist das 43 MB
große Jython-JAR in chapter06/, daher sparen Shallow-Clones (--depth 1) nicht viel. Um
nur die gewünschten Kapitel herunterzuladen: