Impacket

SECUREAUTH LABS. Copyright (C) 2022 SecureAuth Corporation. Все права защищены.

Impacket — это набор классов Python для работы с сетевыми протоколами. Impacket ориентирован на предоставление низкоуровневого программного доступа к пакетам, а для некоторых протоколов (например, SMB1-3 и MSRPC) — и к самой реализации протокола. Пакеты можно создавать с нуля, а также парсить из необработанных данных; объектно-ориентированный API упрощает работу с глубокими иерархиями протоколов. Библиотека включает набор инструментов в качестве примеров того, что можно сделать в её контексте.

Описание некоторых инструментов можно найти на веб-сайте Open Source от SecureAuth Labs.

Какие протоколы представлены?

• Ethernet, захват "Cooked" в Linux.
• IP, TCP, UDP, ICMP, IGMP, ARP.
• Поддержка IPv4 и IPv6.
• NMB и SMB1, SMB2 и SMB3 (высокоуровневые реализации).
• MSRPC версии 5 по различным транспортам: TCP, SMB/TCP, SMB/NetBIOS и HTTP.
• Аутентификация Plain, NTLM и Kerberos с использованием паролей/хешей/билетов/ключей.
• Частичная/полная реализация следующих интерфейсов MSRPC: EPM, DTYPES, LSAD, LSAT, NRPC, RRP, SAMR, SRVS, WKST, SCMR, BKRP, DHCPM, EVEN6, MGMT, SASEC, TSCH, DCOM, WMI, OXABREF, NSPI, OXNSPI.
• Частичная реализация протоколов TDS (MSSQL) и LDAP.

Мейнтейнер

Содержание

• Получение Impacket
• Установка
• Тестирование
• Лицензирование
• Отказ от ответственности
• Связь с нами

Получение Impacket

Последняя версия

• Impacket v0.10.0

  

Текущие и прошлые релизы

Версия для разработки

• Impacket v0.10.1-dev (ветка master)

  

Установка

Быстрый старт

Чтобы получить последний стабильный релиз с помощью pip, выполните:

python3 -m pip install impacket

ℹ️ Это сделает библиотеку Impacket доступной для вашего кода на Python, но не предоставит вам примеры скриптов.

Установка библиотеки + примеры скриптов

Чтобы установить библиотеку и примеры скриптов, скачайте и распакуйте пакет, затем выполните следующую команду из каталога, куда был распакован релиз Impacket:

python3 -m pip install .

ℹ️ Это установит библиотеку в стандартный путь модулей Python, откуда вы сможете использовать примеры скриптов из каталога.

⚠️ Убедитесь, что используемые вами примеры скриптов соответствуют версии библиотеки, установленной в вашем окружении Python. Мы рекомендуем использовать виртуальные окружения, чтобы быть уверенными, что системные установки не мешают работе.

Поддержка Docker

Сборка образа Impacket:

  $ docker build -t "impacket:latest" .

Использование образа Impacket:

  $ docker run -it --rm "impacket:latest"

Тестирование

Библиотека использует фреймворк pytest для организации и маркировки тестовых случаев, tox для автоматизации процесса их запуска на поддерживаемых версиях Python и coverage для получения статистики покрытия.

Доступно подробное руководство по тестированию.

Лицензирование

Это программное обеспечение предоставляется под слегка изменённой версией лицензии Apache Software License. Дополнительную информацию см. в прилагаемом файле LICENSE.

Поддержка SMBv1 и NetBIOS основана на Pysmb от Michael Teo.

Отказ от ответственности

Дух этой инициативы с открытым исходным кодом — помочь исследователям безопасности и сообществу ускорить исследовательскую и образовательную деятельность, связанную с реализацией сетевых протоколов и стеков.

Информация в этом репозитории предназначена для исследовательских и образовательных целей и не предназначена для использования в производственных средах и/или в составе коммерческих продуктов.

Если вы хотите использовать этот код или его часть для своих нужд, мы рекомендуем применять надлежащие практики безопасного жизненного цикла разработки и безопасного кодирования, а также генерировать и отслеживать соответствующие индикаторы компрометации в соответствии с вашими потребностями.

Связь с нами

Если вы хотите сообщить об ошибке, отправить патч или дать какие-либо предложения по этому пакету, напишите нам на [email protected].

По вопросам безопасности ознакомьтесь с нашей политикой безопасности.