Código-fonte do Python 3 "Black Hat Python"

Código-fonte do livro "Black Hat Python" de Justin Seitz. O código foi totalmente convertido para Python 3, reformatado para cumprir os padrões PEP8 e refatorado para eliminar problemas de dependência envolvendo a implementação de bibliotecas obsoletas.

Embora muitas otimizações pudessem ter sido implementadas no código-fonte apresentado ao longo do livro, o código foi deixado o mais inalterado possível para que tais modificações possam ser aplicadas pelo leitor conforme julgar adequado. O código como está precisa de sérios esforços de refatoração, desde docstrings até dicas de tipo e tratamento de exceções, sem mencionar melhorias como gerenciadores de contexto, mas esses problemas por si só podem beneficiar o leitor se ele tiver a intenção de implementá-los. Também apresenta muitos bugs originados de indentação que foram corrigidos se erros fatais fossem evitados durante a execução.

Uma conversão semelhante a esta foi disponibilizada por mim no código-fonte do livro "Violent Python", de TJ O'Connor. Dê uma olhada aqui se ainda não o fez.

Uso

Simplesmente escolha um diretório (DIR) no qual clonar o projeto usando git clone, crie um novo ambiente virtual ou venv para ele (recomendado) e instale os requisitos usando pip install.

user@host:~/DIR$ git clone https://github.com/EONRaider/blackhat-python3
user@host:~/DIR$ python3 -m venv venv
user@host:~/DIR$ source venv/bin/activate
(venv) user@host:~/DIR$ pip install -r requirements.txt

Notas

• Algumas listagens apresentadas no livro estavam ausentes do repositório de código do autor, disponível no site "no starch press", e foram adicionadas aos seus respectivos capítulos. Uma convenção de nomenclatura mais precisa foi aplicada aos arquivos conforme necessário para relacioná-los ao código apresentado no livro.
• Pequenos bugs que geravam avisos pelo interpretador foram corrigidos em todo o código sem alterar suas características.
• Arquivos auxiliares necessários para fazer o código funcionar foram adicionados aos seus respectivos capítulos.
• Como uma nota pessoal, teria sido possível para o autor escrever um código mais limpo sem comprometer a rapidez de implementação necessária para engajamentos de hacking ético. Por que ele optou por não fazê-lo permanece uma razão desconhecida.

Refatoração

Correções críticas de bugs que tiveram que ser feitas para implementar adequadamente o código-fonte e evitar erros fatais:

• chapter02/bh_sshserver.py exigia a chave RSA contida no arquivo test_rsa.key, agora incluída no diretório correspondente.
• chapter03/sniffer_ip_header_decode.py & sniffer_with_icmp.py & scanner.py todos tinham sérios problemas na definição de tamanhos de pacotes IP e portabilidade entre arquiteturas 32/64 bits devido a problemas na implementação de struct. Mais sobre esses problemas neste tópico no Stack Overflow.
• chapter03/scanner.py usava a biblioteca netaddr, que não é mais mantida e apresenta muitas incompatibilidades com Python 3. Por esse motivo, o código foi refatorado e agora usa o módulo ipaddress da stdlib do Python.
• chapter04/arper.py & mail_sniffer.py usavam a biblioteca , que não é compatível com Python 3. Por esse motivo, o código foi refatorado e agora usa a biblioteca .

Traduções

Contribuições em outros idiomas podem ser conferidas aqui:

• Traduzido para Turco por Bedirhan Budak

Contribuindo

Como questão de bom senso, primeiro tente discutir a mudança que deseja fazer neste repositório através de uma issue.

1. Garanta que as modificações que deseja introduzir realmente levem a um pull request. A mudança de uma ou duas linhas deve ser solicitada através de uma issue.
2. Se necessário, atualize o arquivo README.md com detalhes relativos a mudanças na estrutura do projeto.
3. Certifique-se de que as mensagens de commit que incluem as modificações sigam um padrão. Se não souber como proceder, aqui está uma ótima referência sobre como fazer.
4. Seu pedido será revisado o mais rápido possível (geralmente dentro de 48 horas).