Código-fonte do livro "Black Hat Python" de Justin Seitz. O código foi totalmente convertido para Python 3, reformatado para atender aos padrões PEP8 e refatorado para eliminar problemas de dependência envolvendo a implementação de bibliotecas obsoletas.
O código-fonte da primeira edição de Black Hat Python: Python Programming for Hackers and Pentesters de Justin Seitz (No Starch Press, 2014), convertido de Python 2 para Python 3 e refatorado para funcionar nos interpretadores e bibliotecas atuais.
Os scripts mantêm-se próximos das listagens impressas para que possam ser lidos lado a lado com o livro. Todas as alterações feitas durante a conversão estão documentadas em docs/CONVERSION_NOTES.md.
[!NOTE] A No Starch Press publicou uma segunda edição em 2021, por Justin Seitz e Tim Arnold, escrita para Python 3 desde o início. Este repositório segue a primeira edição. Se você tem a segunda edição, use o código do editor.
Uma conversão complementar de Violent Python de TJ O'Connor está disponível em EONRaider/violent-python3.
Python 3.11 ou mais recente. Escolha uma das seguintes configurações.
O uv instala a versão correta
do Python caso você não a tenha e reproduz as versões exatas das dependências
testadas na CI a partir do 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
Cada capítulo é um grupo de dependências separado, para que você possa instalar apenas o que está lendo:
uv sync --only-group ch04 # just chapter 4
No Windows, os grupos ch08-ch10 também instalam pywin32 e wmi; em outras
plataformas, eles são ignorados 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 contêm intervalos de versões. Para as versões exatas testadas na CI, use
requirements-lock.txt da última release.
Com pip 25.1 ou mais recente, você também pode instalar o grupo de um capítulo diretamente do
pyproject.toml com pip install --group ch04.
Cada release publica uma
imagem para linux/amd64 e linux/arm64 com as dependências de todos os capítulos
multiplataforma e ferramentas de rede comuns pré-instaladas:
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
A imagem é executada como root porque a maioria dos capítulos de raw-socket precisa disso. O contêiner é o sandbox, então adicione apenas as capacidades que um capítulo necessita. Os capítulos do Windows (8-10) não podem ser executados nele.
Use o selo Open in GitHub Codespaces acima, ou abra a pasta no VS Code ou JetBrains com a extensão Dev Containers. O contêiner (.devcontainer/devcontainer.json) tem as mesmas ferramentas que a imagem Docker, além de uv, git e compiladores, e já vem com as capacidades de raw-socket concedidas.
| Capítulo | Tópico | Grupo uv | Pacotes PyPI | Notas |
|---|---|---|---|---|
| 02 | A rede: fundamentos | ch02 | paramiko | test_rsa.key é a chave de teste pública do Paramiko (da sua suíte de testes), necessária para bh_sshserver.py. |
| 03 | Raw sockets e sniffing | - | - | Apenas biblioteca padrão. Requer root / Administrador. |
| 04 | Dominando a rede com Scapy | ch04 | kamene, opencv-python | Usa kamene, um fork do Scapy para Python 3 da época da conversão. Requer root / NET_RAW. |
| 05 | Hackeando a web | - | - | Apenas biblioteca padrão. As wordlists all.txt e cain.txt estão incluídas. |
| 06 | Estendendo o Burp Proxy | - | - | Extensões do Burp Suite que rodam sob Jython 2.7 (jython-standalone-2.7.2.jar está incluído), não CPython. |
| 07 | Comando e controle via GitHub | ch07 | github3.py | Requer um repositório GitHub e um token de acesso pessoal. |
| 08 | Tarefas comuns de trojan no Windows | ch08 | pywin32 (Windows) | Apenas Windows. keylogger.py ainda não roda em nenhum Python suportado: ele importa pyHook, que nada instalável fornece (veja as notas de conversão). |
| 09 | Diversão com o Internet Explorer | ch09 | pycryptodome, pywin32 (Windows) | Apenas Windows, exceto os auxiliares de criptografia. |
| 10 | Escalação de privilégios no Windows | ch10 | pywin32 (Windows), wmi (Windows) | Apenas Windows. bhvulnservice.zip é o serviço vulnerável do livro. |
| 11 | Automatizando forense ofensiva | - | - | Requer o Immunity Debugger (immlib, Python 2.7) e o framework Volatility 2. Nenhum dos dois instala a partir do PyPI. |
O capítulo 1 do livro aborda a configuração do ambiente e não tem código. A coluna PyPI é gerada por python tools/deps_scan.py report, que lê os imports de cada capítulo. As notas de SO e privilégios vêm das notas de conversão e podem estar incompletas; correções são bem-vindas.
Um checkout completo tem cerca de 46 MB mais 51 MB de histórico. A maior parte da árvore é o JAR do Jython de 43 MB em chapter06/, então clones rasos (--depth 1) não economizam muito. Para baixar apenas os capítulos que você quer:
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
Ou pule o clone completamente e use a imagem Docker.