Codice sorgente per il libro "Black Hat Python" di Justin Seitz. Il codice è stato completamente convertito a Python 3, riformattato per conformarsi agli standard PEP8 e rifattorizzato per eliminare i problemi di dipendenza legati all'implementazione di librerie deprecate.
Il codice sorgente della prima edizione di Black Hat Python: Python Programming for Hackers and Pentesters di Justin Seitz (No Starch Press, 2014), convertito da Python 2 a Python 3 e rifattorizzato per funzionare sugli interpreti e le librerie attuali.
Gli script restano fedeli ai listati stampati, così da poter essere letti fianco a fianco con il libro. Ogni modifica apportata durante la conversione è documentata in docs/CONVERSION_NOTES.md.
[!NOTE] No Starch Press ha pubblicato una seconda edizione nel 2021, a cura di Justin Seitz e Tim Arnold, scritta per Python 3 fin dall'inizio. Questo repository segue la prima edizione. Se possiedi la seconda edizione, usa il codice dell'editore.
Una conversione complementare di Violent Python di TJ O'Connor è disponibile su EONRaider/violent-python3.
Python 3.11 o superiore. Scegli una delle seguenti configurazioni.
uv installa la versione
corretta di Python se non la possiedi e riproduce le esatte versioni delle dipendenze
testate in CI da uv.lock.
git clone https://github.com/EONRaider/blackhat-python3.git
cd blackhat-python3
uv sync # every chapter
uv run python chapter02/bhnet.py -h
Ogni capitolo è un gruppo di dipendenze separato, quindi puoi installare solo ciò che stai leggendo:
uv sync --only-group ch04 # just chapter 4
Su Windows, i gruppi ch08-ch10 installano anche pywin32 e wmi; sulle altre
piattaforme vengono saltati automaticamente.
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 contengono intervalli di versione. Per le versioni esatte testate in CI, usa
requirements-lock.txt dalla ultima release.
Con pip 25.1 o versioni successive, puoi anche installare il gruppo di un capitolo direttamente da
pyproject.toml con pip install --group ch04.
Ogni release pubblica un'immagine
per linux/amd64 e linux/arm64 con le dipendenze di ogni capitolo multipiattaforma
e i comuni strumenti di rete preinstallati:
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
L'immagine viene eseguita come root perché la maggior parte dei capitoli sulle raw socket lo richiede. Il container è la sandbox, quindi aggiungi solo le capability necessarie a un capitolo. I capitoli Windows (8-10) non possono essere eseguiti al suo interno.
Usa il badge Open in GitHub Codespaces qui sopra, oppure apri la cartella in VS Code o JetBrains con l'estensione Dev Containers. Il container (.devcontainer/devcontainer.json) dispone degli stessi strumenti dell'immagine Docker, più uv, git e i compilatori, e viene fornito con le capability per le raw socket già concesse.
| Capitolo | Argomento | Gruppo uv | Pacchetti PyPI | Note |
|---|---|---|---|---|
| 02 | La rete: le basi | ch02 | paramiko | test_rsa.key è la chiave di test pubblica di Paramiko (dalla sua suite di test), necessaria a bh_sshserver.py. |
| 03 | Raw socket e sniffing | - | - | Solo libreria standard. Richiede root / Administrator. |
| 04 | Impadronirsi della rete con Scapy | ch04 | kamene, opencv-python | Usa kamene, un fork per Python 3 di Scapy risalente all'epoca della conversione. Richiede root / NET_RAW. |
| 05 | Hacking del web | - | - | Solo libreria standard. Sono incluse le wordlist all.txt e cain.txt. |
| 06 | Estendere Burp Proxy | - | - | Estensioni di Burp Suite che girano sotto Jython 2.7 (jython-standalone-2.7.2.jar è incluso), non CPython. |
| 07 | Comando e controllo tramite GitHub | ch07 | github3.py | Richiede un repository GitHub e un personal access token. |
| 08 | Attività comuni di trojanizzazione su Windows | ch08 | pywin32 (Windows) | Solo Windows. keylogger.py non funziona ancora su nessuna versione supportata di Python: importa pyHook, che nessun pacchetto installabile fornisce (vedi le note sulla conversione). |
| 09 | Divertirsi con Internet Explorer | ch09 | pycryptodome, pywin32 (Windows) | Solo Windows, tranne gli helper crittografici. |
| 10 | Escalation dei privilegi su Windows | ch10 | pywin32 (Windows), wmi (Windows) | Solo Windows. bhvulnservice.zip è il servizio vulnerabile del libro. |
| 11 | Automatizzare la forensic offensiva | - | - | Richiede Immunity Debugger (immlib, Python 2.7) e il framework Volatility 2. Nessuno dei due si installa da PyPI. |
Il capitolo 1 del libro riguarda la configurazione dell'ambiente e non contiene codice. La colonna PyPI è generata da python tools/deps_scan.py report, che legge gli import di ciascun capitolo. Le note su sistema operativo e privilegi provengono dalle note sulla conversione e potrebbero essere incomplete; le correzioni sono benvenute.
Un checkout completo è di circa 46 MB più 51 MB di cronologia. La maggior parte dell'albero è il JAR Jython da 43 MB in chapter06/, quindi i cloni shallow (--depth 1) non fanno risparmiare molto. Per scaricare solo i capitoli che desideri:
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
Oppure salta del tutto la clonazione e usa l'immagine Docker.
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.