Исходный код Python 3 «Black Hat Python»

Исходный код для книги «Black Hat Python» Джастина Зайтца. Код полностью конвертирован в Python 3, переформатирован в соответствии со стандартами PEP8 и реорганизован для устранения проблем с зависимостями, связанных с использованием устаревших библиотек.

Хотя в исходном коде, представленном в книге, можно было бы реализовать множество оптимизаций, код был оставлен максимально неизменным, чтобы читатель мог применить такие изменения по своему усмотрению. Код в его нынешнем виде требует серьезных усилий по рефакторингу: от docstrings до подсказок типов и обработки исключений, не говоря уже об улучшениях вроде контекстных менеджеров, но эти проблемы сами по себе могут принести пользу читателю, если он намерен их реализовать. В нем также присутствует множество ошибок, возникших из-за отступов, которые были исправлены, чтобы избежать фатальных ошибок во время выполнения.

Похожая конвертация была выполнена мной для исходного кода книги «Violent Python» Ти Джея О'Коннора. Ознакомьтесь с ней здесь, если вы еще этого не сделали.

Использование

Просто выберите каталог (DIR), в который нужно клонировать проект с помощью git clone, создайте новое виртуальное окружение или venv для него (рекомендуется) и установите зависимости с помощью 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

Примечания

• Некоторые листинги, представленные в книге, отсутствовали в репозитории кода автора, доступном на сайте No Starch Press, и были добавлены в соответствующие главы. При необходимости к файлам была применена более точная схема именования, чтобы связать их с кодом, представленным в книге.
• Незначительные ошибки, вызывавшие предупреждения интерпретатора, были исправлены по всему коду без изменения его характеристик.
• Вспомогательные файлы, необходимые для работы кода, были добавлены в соответствующие главы.
• Как личное замечание, автор мог бы написать более чистый код, не ставя под угрозу скорость реализации, необходимую для задач этичного хакинга. Почему он решил этого не делать, остается неизвестным.

Рефакторинг

Критические исправления ошибок, которые пришлось внести для правильной реализации исходного кода и предотвращения фатальных ошибок:

• chapter02/bh_sshserver.py требовался RSA-ключ, содержащийся в файле test_rsa.key, который теперь включен в соответствующий каталог.
• chapter03/sniffer_ip_header_decode.py, sniffer_with_icmp.py и scanner.py — все имели серьезные проблемы в определении размеров IP-пакетов и переносимости между 32- и 64-битными архитектурами из-за проблем в реализации struct. Подробнее об этих проблемах в этой теме на Stack Overflow.
• chapter03/scanner.py использовал библиотеку netaddr, которая больше не поддерживается и имеет множество несовместимостей с Python 3. По этой причине код был переработан и теперь использует модуль ipaddress из стандартной библиотеки Python.
• chapter04/arper.py и mail_sniffer.py использовали библиотеку , которая несовместима с Python 3. По этой причине код был переработан и теперь использует библиотеку .

Переводы

Вклады на других языках можно посмотреть здесь:

• Перевод на турецкий от Bedirhan Budak

Внесение вклада

По здравому смыслу, сначала попробуйте обсудить изменение, которое вы хотите внести в этот репозиторий, через issue.

1. Убедитесь, что изменения, которые вы хотите внести, действительно ведут к pull request. Изменение одной-двух строк лучше запрашивать через issue.
2. При необходимости обновите файл README.md с деталями, относящимися к изменениям структуры проекта.
3. Убедитесь, что сообщения коммитов, включающие изменения, соответствуют стандарту. Если вы не знаете, как действовать, вот отличный справочник по этому вопросу.
4. Ваш запрос будет рассмотрен как можно скорее (обычно в течение 48 часов).