+6
日增长
16,269
stars
3,989
forks
364
watchers
1,289
prs
1,068
issues
16
releases
README
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.
What protocols are featured?
----------------------------
Ethernet, Linux "Cooked" capture.
IP, TCP, UDP, ICMP, IGMP, ARP.
IPv4 and IPv6 Support.
NMB and SMB1, SMB2 and SMB3 (high-level implementations).
MSRPC version 5, over different transports: TCP, SMB/TCP, SMB/NetBIOS and HTTP.
Plain, NTLM and Kerberos authentications, using password/hashes/tickets/keys.
Portions/full implementation of the following MSRPC interfaces: EPM, DTYPES, LSAD, LSAT, NRPC, RRP, SAMR, SRVS, WKST, SCMR, BKRP, DHCPM, EVEN6, MGMT, SASEC, TSCH, DCOM, WMI, OXABREF, NSPI, OXNSPI.
Portions of TDS (MSSQL) and LDAP protocol implementations.
Maintainer
==========
Core Security
Table of Contents
=================
Getting Impacket
Setup
Testing
Licensing
Disclaimer
Contact Us
Getting Impacket
================
Latest version
Impacket v0.13.1
Current and past releases
Development version
Impacket v0.14.0-dev (master branch)
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 inTop issues
#319Errors with long commands in psexec.py25 comments · 2017-09-14#1601KDC_ERR_TGT_REVOKED when using golden ticket from tickter.py16 comments · 2023-08-25#642Using HTTPS socks doesn't seem to work16 comments · 2019-06-25#991Samba secretsdump.py not working15 comments · 2020-11-11#911Install without examples15 comments · 2020-07-30#387Function GetSecurityDescriptor of StdRegProv fails11 comments · 2018-02-05#1412NTLMRelayx self.client.entries IndexError: list index out of range 10 comments · 2022-09-27#2007RPC Access Denied 2k22 for event log query9 comments · 2025-07-23
Discussions
#2312Community manual: source-level guide to writing your own impacket PoCs (bilingual, free)0 comments · 2026-10-01#2294An odd behavior on high latency smb file transfer1 comments · 2026-09-11#2067Documentation1 comments · 2025-10-21
Latest release
Impacket 0.13.1 impacket_0_13_1 2026-05-19Project's main page at https://www.coresecurity.com/core-labs/open-source-tools/impacket
Release blogpost at https://www.coresecurity.com/blog/whats-new-impacket-0131
ChangeLog for v0.13.1:
1. Library improvements
SMB: Improved server and relay behavior with SMB server signing support, optional read-only shares, Kerberos/NTLM authentication controls, graceful SMB relay packet handling, SMBv1 relay fixes, SMB 3.1.1 negotiation fixes, and clearer errors for truncated SMB responses. (Fixes 2099, 2085, 2111, 2114, 2129)
Kerberos: Fixed S4U2Self service ticket parsing, non-ASCII