impacket README

The project's README from github.com/fortra/impacket. As one markdown file: README.md.

Impacket_light

Impacket

Latest Version Build and test Impacket

Copyright Fortra, LLC and its affiliated companies. All rights reserved.

Impacket was originally created by SecureAuth, and now maintained by Fortra's Core Security.

Impacket is a collection of Python classes for working with network protocols. Impacket is focused on providing low-level programmatic access to the packets and for some protocols (e.g. SMB1-3 and MSRPC) the protocol implementation itself. Packets can be constructed from scratch, as well as parsed from raw data, and the object-oriented API makes it simple to work with deep hierarchies of protocols. The library provides a set of tools as examples of what can be done within the context of this library.

Maintainer

Core Security

Table of Contents

Getting Impacket

Latest version

Current and past releases

Development version

Setup

Quick start

:information_source: We recommend using pipx over pip for system-wide installations.

In order to grab the latest stable release run:

python3 -m pipx install impacket

If you want to play with the unreleased changes, download the development version from the master branch, extract the package, and execute the following command from the directory where Impacket has been unpacked:

python3 -m pipx install .

Docker Support

Build Impacket's image:

  $ docker build -t "impacket:latest" .

Using Impacket's image:

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

Testing

The library leverages the pytest framework for organizing and marking test cases, tox to automate the process of running them across supported Python versions, and coverage to obtain coverage statistics.

A comprehensive testing guide is available.

Licensing

This software is provided under a slightly modified version of the Apache Software License. See the accompanying LICENSE file for more information.

SMBv1 and NetBIOS support based on Pysmb by Michael Teo.

Disclaimer

The spirit of this Open Source initiative is to help security researchers, and the community, speed up research and educational activities related to the implementation of networking protocols and stacks.

The information in this repository is for research and educational purposes and not meant to be used in production environments and/or as part of commercial products.

If you desire to use this code or some part of it for your own uses, we recommend applying proper security development life cycle and secure coding practices, as well as generate and track the respective indicators of compromise according to your needs.

Contact Us

For general questions, bug reports, or feature requests, please use GitHub issues.

Contributions are welcome. If you would like to contribute a fix, improvement, or new feature, please open a GitHub pull request with a clear description of the proposed change.

If you believe you have discovered a security vulnerability in Impacket, or if you believe Impacket is being abused or misused, please do not report it through a public GitHub issue, discussion, or pull request. Instead, follow the instructions in our Security Policy.

impacket (fortra/impacket)

Searching Database…

16.2K ·GitHub
Что это такое?Impacket — это набор Python-классов для работы с сетевыми протоколами: он даёт низкоуровневый программный доступ к пакетам, а для некоторых протоколов, например SMB1-3 и MSRPC, содержит их полные реализации.
Это библиотека, к которой я пишу код, или набор готовых инструментов?Это в первую очередь библиотека: вы импортируете её классы и собираете или разбираете пакеты через объектно-ориентированный API. Вместе с ней поставляется набор утилит, которые служат примерами возможностей библиотеки.
Можно ли использовать её в рабочем продукте?Авторы говорят, что она предназначена для помощи исследователям безопасности и преподавателям и прямо не предназначена для продакшена или в составе коммерческих продуктов — если вы переиспользуете код, применяйте практики безопасной разработки.
Мне придётся вручную собирать сырые байты, или она умеет разбирать захваченный трафик?И то и другое: пакеты можно конструировать с нуля, а можно разбирать из сырых данных, и объектно-ориентированный API упрощает работу даже с глубокими иерархиями протоколов.
С какими интерфейсами удалённого администрирования она умеет работать?Она реализует часть или полные версии многих интерфейсов MSRPC, включая EPM, SAMR, LSAD/LSAT, NRPC, RRP, SRVS, WKST, SCMR, TSCH, DCOM и WMI — например, управление пользователями, службами и задачами планировщика на удалённых машинах.
Она полезна только против машин с Windows?Лучше всего она покрывает протоколы Microsoft — SMB, MSRPC, DCOM/WMI, NTLM и Kerberos, — но низкоуровневый пакетный слой также работает с обычным трафиком Ethernet, IP, TCP/UDP и IPv6.
Creator
fortra
Size
11.6 MB
Stars
16.2K
Age
11y
Commits · 90 Days