Impacket官方使用指南

柔光的暖阳◎ 2024-04-07 10:51 35阅读 0赞

### 什么是Impacket ###

Impacket是用于处理网络协议的Python类的集合。Impacket专注于提供对数据包的简单编程访问，以及协议实现本身的某些协议(例如SMB1-3和MSRPC)。数据包可以从头开始构建，也可以从原始数据中解析，而面向对象的API使处理协议的深层次结构变得简单。该库提供了一组工具，作为在此库找到可以执行的操作的示例。

有关某些工具的说明，请访问：[https://www.secureauth.com/labs/open-source-tools/impacket][https_www.secureauth.com_labs_open-source-tools_impacket]

### **Impacket中包含以下协议** ###

*  以太网，Linux“Cooked”数据包捕获
 *  IP，TCP，UDP，ICMP，IGMP，ARP
 *  支持IPv4和IPv6
 *  NMB和SMB1，SMB2和SMB3(高级实现)
 *  MSRPC版本5，通过不同的传输协议：TCP，SMB / TCP，SMB/NetBIOS和HTTP
 *  使用密码/哈希/票据/密钥进行简单的NTLM和Kerberos身份验证
 *  部分或完全实现以下MSRPC接口：EPM，DTYPES，LSAD，LSAT，NRPC，RRP，SAMR，SRVS，WKST，SCMR，BKRP，DHCPM，EVEN6，MGMT，SASEC，TSCH，DCOM，WMI
 *  部分TDS(MSSQL)和LDAP协议实现。

### 获得Impacket ###

*  已编译的当前版本和以前的版本
 *  开源分支

### 程序安装 ###

### 快速开始 ###

获取最新的稳定版本，将其解压缩并执行命令pip install . 然后在它的目录中运行。

### 安装要求 ###

*  Python解释器，已知Python 2.6/2.7和Python 3.6可以运行
    
    1.  如果您想运行这些示例，并且您的python<2.7，那么需要安装argparse包，以便它们正常执行。
    2.  对于Kerberos支持，您将需要安装pyasn1包
    3.  对于加密操作，您将需要安装pycryptodomex包
    4.  对于某些示例，您将需要安装pyOpenSSL(rdp\_check.py)和ldap3(ntlmrelayx.py)
    5.  对于ntlmrelayx.py你还需要安装ldapdomaindump，flask并ldap3
    6.  如果你在Windows下，你将需要安装 pyReadline
 *  最近发布的Impacket

### 安装 ###

为了安装源，请从解压缩Impacket包的目录中执行以下命令：pip install . 这将把类安装到默认的Python模块路径中; 请注意，您可能需要特殊的权限才能在那里进行写入。有关setup.py中可用的命令和选项的详细信息，请运行python setup.py --help-commands

### 测试 ###

如果您想要运行库测试用例，您需要主要做三件事：

1.  安装和配置Windows 2012 R2域控制器。
    
     *  确保远程注册表(RemoteRegistry)服务已启用并正在运行。
2.  使用必要的信息配置[dcetest.cfg][]文件
3.  安装tox(pip install tox)

完成后，您可以运行tox并等待结果。如果一切顺利，所有测试用例都应该通过。您还可以在impacket/tests/htlmcov/index.html上找到一个被覆盖的HTML报告

#### IMPACKET中包含以下工具 ####

##### 远程执行 #####

*  [psexec.py:][psexec.py]类似[PSEXEC][psexec.py]的功能示例，使用remcomsvc(https://github.com/kavika13/remcom)
 *  [smbexec.py：与使用remcomsvc的psexec w/o类似的方法][smbexec.py_remcomsvc_psexec w_o]。[这里][Link 1]描述[了][Link 1]该技术。我们的实现更进一步，实例化本地smbserver以接收命令的输出。这在目标计算机没有可写共享可用的情况下很有用。
 *  [atexec.py：][atexec.py]此示例通过Task Scheduler服务在目标计算机上执行命令，并返回已执行命令的输出。
 *  [wmiexec.py：][wmiexec.py]通过Windows Management Instrumentation使用的半交互式shell，它不需要在目标服务器上安装任何服务/代理，以管理员身份运行，非常隐蔽。
 *  [dcomexec.py：][dcomexec.py]类似于wmiexec.py的半交互式shell，但使用不同的DCOM端点。目前支持MMC20.Application，ShellWindows和ShellBrowserWindow对象。

*  [GetTGT.py：][GetTGT.py]指定密码，哈希或aesKey，此脚本将请求TGT并将其保存为ccache
 *  [GetST.py：][GetST.py]指定ccache中的密码，哈希，aesKey或TGT，此脚本将请求服务票证并将其保存为ccache。如果该帐户具有约束委派(具有协议转换)权限，您将能够使用-impersonate参数代表另一个用户请求该票证。
 *  [GetPac.py：][GetPac.py]此脚本将获得指定目标用户的PAC(权限属性证书)结构，该结构仅具有正常的经过身份验证的用户凭据。它通过混合使用\[MS-SFU\]的S4USelf +用户到用户Kerberos身份验证组合来实现的。
 *  [GetUserSPNs.py：][GetUserSPNs.py]此示例将尝试查找和获取与普通用户帐户关联的服务主体名称。
 *  [GetNPUsers.py：][GetNPUsers.py]此示例将尝试为那些设置了属性“不需要Kerberos预身份验证”的用户获取TGT(UF\_DONT\_REQUIRE\_PREAUTH).输出与JTR兼容
 *  [ticketer.py：][ticketer.py]此脚本将从头开始或基于模板(根据KDC的合法请求)创建金/银票据，允许您在PAC\_LOGON\_INFO结构中自定义设置的一些参数，特别是组、外接程序、持续时间等。
 *  [raiseChild.py：][raiseChild.py]此脚本通过(ab)使用Golden Tickets和ExtraSids的基础来实现子域到林权限的升级。

##### Windows Secrets #####

*  [secretsdump.py：][secretsdump.py]
 *  执行各种技术从远程机器转储Secrets，而不在那里执行任何代理。对于SAM和LSA Secrets(包括缓存的凭据)，然后将hives保存在目标系统(％SYSTEMROOT％\\ Temp目录)中，并从中读取其余数据。对于DIT文件，我们使用dl\_drsgetncchanges()方法转储NTLM哈希值、纯文本凭据(如果可用)和Kerberos密钥。它还可以通过使用smbexec/wmiexec方法执行的vssadmin来转储NTDS.dit.如果脚本不可用，脚本将启动其运行所需的服务(例如，远程注册表，即使它已被禁用)。运行完成后，将恢复到原始状态。

*  [mimikatz.py：][mimikatz.py]用于控制@gentilkiwi开发的远程mimikatz RPC服务器的迷你shell

##### 服务器工具/ MiTM攻击 #####

*  [ntlmrelayx.py：][ntlmrelayx.py]此脚本执行NTLM中继攻击，设置SMB和HTTP服务器并将凭据中继到许多不同的协议(SMB，HTTP，MSSQL，LDAP，IMAP，POP3等)。该脚本可以与预定义的攻击一起使用，这些攻击可以在中继连接时触发(例如，通过LDAP创建用户)，也可以在SOCKS模式下执行。在此模式下，对于每个中继的连接，稍后可以通过SOCKS代理多次使用它
 *  [karmaSMB.py：][karmaSMB.py]无论指定的SMB共享和路径名如何，都会响应特定文件内容的SMB服务器
 *  [smbserver.py:SMB][smbserver.py_SMB]服务器的Python实现，允许快速设置共享和用户帐户。

##### WMI #####

*  [wmiquery.py：][wmiquery.py]它允许发出WQL查询并在目标系统上获取WMI对象的描述(例如，从win32\_account中选择名称)
 *  [wmipersist.py： 此脚本创建/删除wmi事件使用者/筛选器，并在两者之间建立链接，以基于指定的wql筛选器或计时器执行Visual Basic][wmipersist.py_ _wmi_wql_Visual Basic] Basic

##### 已知的漏洞 #####

*  [goldenPac.py：][goldenPac.py] 利用MS14-068。保存Golden Ticket并在目标位置启动PSExec会话

*  [sambaPipe.py：][sambaPipe.py]该脚本将利用CVE-2017-7494，通过-so参数上传和执行用户指定的共享库。
 *  [smbrelayx.py：利用SMB中继攻击漏洞CVE-2015-0005][smbrelayx.py_SMB_CVE-2015-0005]。如果目标系统正在执行签名并且提供了计算机帐户，则模块将尝试通过NETLOGON收集SMB会话密钥。 利用SMB中继攻击漏洞CVE-2015-0005

##### SMB / MSRPC #####

*  [smbclient.py：][smbclient.py]一个通用的SMB客户端，可以允许您列出共享和文件名，重命名，上传和下载文件，以及创建和删除目录，所有这些都是使用用户名和密码或用户名和哈希组合。这是一个很好的例子，可以了解到如何在实际中使用impacket.smb
 *  [getArch.py：此脚本将与目标(或目标列表)主机连接][getArch.py]，并使用文档化的msrpc功能收集由(ab)安装的操作系统体系结构类型。
 *  [rpcdump.py：][rpcdump.py]此脚本将转储目标上注册的RPC端点和字符串绑定列表。它还将尝试将它们与已知端点列表进行匹配。
 *  [ifmap.py：此脚本将绑定到目标的管理接口，以获取接口ID列表。它将在另一个界面UUID列表上使用这个列表，尝试绑定到每个接口并报告接口是否已列出或正在侦听。][ifmap.py_ID_UUID]
 *  [opdump.py：][opdump.py]这将绑定到给定的hostname:port和msrpc接口。然后，它尝试依次调用前256个操作号中的每一个，并报告每个调用的结果。
 *  [samrdump.py：][samrdump.py]从MSRPC套件与安全帐户管理器远程接口通信的应用程序中。它列出了通过此服务导出的系统用户帐户、可用资源共享和其他敏感信息
 *  [services.py：][services.py]此脚本可用于通过\[MS-SCMR\] MSRPC接口操作Windows服务。它支持启动，停止，删除，状态，配置，列表，创建和更改。
 *  [netview.py：][netview.py]获取在远程主机上打开的会话列表，并跟踪这些会话在找到的主机上循环，并跟踪从远程服务器登录/退出的用户
 *  [reg.py：][reg.py]通过\[ms-rrp\]msrpc接口远程注册表操作工具。其想法是提供与reg.exe Windows实用程序类似的功能。=
 *  [lookupsid.py：][lookupsid.py]通过\[MS-LSAT\] MSRPC接口的Windows SID暴力破解程序示例，旨在查找远程用户和组

##### MSSQL / TDS #####

*  [mssqlinstance.py：][mssqlinstance.py]从目标主机中检索MSSQL实例名称。
 *  [mssqlclient.py：MSSQL][mssqlclient.py_MSSQL]客户端，支持SQL和Windows身份验证(哈希)。它还支持TLS。

##### 文件格式 #####

*  [esentutl.py：Extensibe][esentutl.py_Extensibe]存储引擎格式实现。它允许转储ESE数据库的目录，页面和表(例如NTDS.dit)
 *  [ntfs-read.py:NTFS][ntfs-read.py_NTFS]格式实现。此脚本提供了一个用于浏览和提取NTFS卷的功能小的反弹shell，包括隐藏/锁定的内容
 *  [registry-read.py：Windwows][registry-read.py_Windwows]注册表文件格式实现。它允许解析脱机注册表配置单元

##### 其他 #####

*  [GetADUsers.py：][GetADUsers.py]此脚本将收集有关域用户及其相应电子邮件地址的数据。它还将包括有关上次登录和上次密码设置属性的一些额外信息。
 *  [mqtt\_check.py：][mqtt_check.py]简单的MQTT示例，旨在使用不同的登录选项。可以很容易地转换成帐户/密码暴力工具。
 *  [rdp\_check.py：\[MS-RDPBCGR][rdp_check.py_MS-RDPBCGR] \]和\[MS-CREDSSP\]部分实现只是为了达到CredSSP身份验证。此示例测试帐户在目标主机上是否有效。
 *  [sniff.py：][sniff.py]简单的数据包嗅探器，使用pcapy库来监听在指定接口上传输的包。
 *  [sniffer.py：][sniffer.py]简单的数据包嗅探器，它使用原始套接字来侦听与指定协议相对应的传输中的数据包。
 *  [ping.py：][ping.py]简单的ICMP ping，它使用ICMP echo和echo-reply数据包来检查主机的状态。如果远程主机已启动，则应使用echo-reply数据包响应echo探针。
 *  [ping6.py：][ping6.py]简单的IPv6 ICMP ping，它使用ICMP echo和echo-reply数据包来检查主机的状态。

#### 源码 ####

*  您可以访问[https://github.com/SecureAuthCorp/impacket][https_github.com_SecureAuthCorp_impacket]查看其源码(开发版本)
 *  0.9.19，2019年4月1日更新 - [gzip'd tarball][gzip_d tarball]
 *  0.9.18，2018年12月5日更新 - [gzip'd tarball][gzip_d tarball 1]
 *  0.9.17，更新于2018年5月30日 - [gzip'd tarball][gzip_d tarball 2]
 *  0.9.15，2016年6月28日更新 - [gzip'd tarball][gzip_d tarball 3]
 *  0.9.14，2016年1月7日更新 - [gzip'd tarball][gzip_d tarball 4]，
 *  0.9.13，2015年5月4日更新 - [gzip'd tarball][gzip_d tarball 5]，
 *  0.9.12，2014年7月20日更新 - [gzip'd tarball][gzip_d tarball 6]，
 *  0.9.11，2014年2月3日更新 - [gzip'd tarball][gzip_d tarball 7]，
 *  0.9.10，2013年5月6日更新 - [gzip'd tarball][gzip_d tarball 8]，
 *  0.9.9.9，更新于2012年7月20日 - [gzip'd tarball][gzip_d tarball 9]， [zip文件][zip]
 *  0.9.6.0，更新于2006年5月23日 - [gzip'd tarball][gzip_d tarball 10]
 *  0.9.5.2，更新于2006年4月3日 - [gzip'd tarball][gzip_d tarball 11]， [zip文件][zip 1]
 *  0.9.5.1，更新于2003年12月16日 - [gzip'd tarball][gzip_d tarball 12]， [zip文件][zip 2]

#### 文档 ####

我们希望有更多可用的文档,因此大多数文档都作为Python的文档注释包含在源代码中。您还可以通过其[测试用例][Link 2]和[示例了解很多关于库功能的信息][Link 3].

[https_www.secureauth.com_labs_open-source-tools_impacket]: https://www.secureauth.com/labs/open-source-tools/impacket
[dcetest.cfg]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/tests/SMB_RPC/dcetests.cfg
[psexec.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/psexec.py
[smbexec.py_remcomsvc_psexec w_o]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/smbexec.py
[Link 1]: https://web.archive.org/web/20140625065218/http://blog.accuvant.com/rdavisaccuvant/owning-computers-without-shell-access/
[atexec.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/atexec.py
[wmiexec.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/wmiexec.py
[dcomexec.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/dcomexec.py
[GetTGT.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/getTGT.py
[GetST.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/getST.py
[GetPac.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/getPac.py
[GetUserSPNs.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/GetUserSPNs.py
[GetNPUsers.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/GetNPUsers.py
[ticketer.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/ticketer.py
[raiseChild.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/raiseChild.py
[secretsdump.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/secretsdump.py
[mimikatz.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/mimikatz.py
[ntlmrelayx.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/ntlmrelayx.py
[karmaSMB.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/karmaSMB.py
[smbserver.py_SMB]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/smbserver.py
[wmiquery.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/wmiquery.py
[wmipersist.py_ _wmi_wql_Visual Basic]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/wmipersist.py
[goldenPac.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/goldenPac.py
[sambaPipe.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/sambaPipe.py
[smbrelayx.py_SMB_CVE-2015-0005]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/smbrelayx.py
[smbclient.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/smbclient.py
[getArch.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/getArch.py
[rpcdump.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/rpcdump.py
[ifmap.py_ID_UUID]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/ifmap.py
[opdump.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/opdump.py
[samrdump.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/samrdump.py
[services.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/services.py
[netview.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/netview.py
[reg.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/reg.py
[lookupsid.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/lookupsid.py
[mssqlinstance.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/mssqlinstance.py
[mssqlclient.py_MSSQL]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/mssqlclient.py
[esentutl.py_Extensibe]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/esentutl.py
[ntfs-read.py_NTFS]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/ntfs-read.py
[registry-read.py_Windwows]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/registry-read.py
[GetADUsers.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/GetADUsers.py
[mqtt_check.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/mqtt_check.py
[rdp_check.py_MS-RDPBCGR]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/rdp_check.py
[sniff.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/sniff.py
[sniffer.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/sniffer.py
[ping.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/ping.py
[ping6.py]: https://github.com/SecureAuthCorp/impacket/blob/impacket_0_9_19/examples/ping6.py
[https_github.com_SecureAuthCorp_impacket]: https://github.com/SecureAuthCorp/impacket
[gzip_d tarball]: https://github.com/SecureAuthCorp/impacket/releases/download/impacket_0_9_19/impacket-0.9.19.tar.gz
[gzip_d tarball 1]: https://files.pythonhosted.org/packages/71/a5/f25ac0036c2b85e48aee740a99c3ab82196a05d8a4203fac6e8283ea5b0b/impacket-0.9.18.tar.gz
[gzip_d tarball 2]: https://files.pythonhosted.org/packages/09/26/de84602349ca97b78d1720045db662c7eb261d2daf4a3b509b7ee387de74/impacket-0.9.17.tar.gz
[gzip_d tarball 3]: https://pypi.python.org/packages/35/72/694c391c7fe29600c2c8d8d4aa97a781562c39bb66a3d20bbee9858ca698/impacket-0.9.15.tar.gz#md5=53fb6d1c375dd3ef8fff4ce2b7ff8f15
[gzip_d tarball 4]: https://pypi.python.org/packages/source/i/impacket/impacket-0.9.14.tar.gz
[gzip_d tarball 5]: https://pypi.python.org/packages/source/i/impacket/impacket-0.9.13.tar.gz
[gzip_d tarball 6]: https://pypi.python.org/packages/source/i/impacket/impacket-0.9.12.tar.gz
[gzip_d tarball 7]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/impacket-0.9.11.tar_.gz
[gzip_d tarball 8]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/impacket-0.9.10.tar_.gz
[gzip_d tarball 9]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/impacket-0.9.9.9.tar_.gz
[zip]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/impacket-0.9.9.9.zip
[gzip_d tarball 10]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/Impacket-0.9.6.0.tar_.gz
[gzip_d tarball 11]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/Impacket-0.9.5.2.tar_.gz
[zip 1]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/Impacket-0.9.5.2.zip
[gzip_d tarball 12]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/Impacket-0.9.5.1.tar_.gz
[zip 2]: https://www.secureauth.com/sites/default/files/project/attachment/2018-10/Impacket-0.9.5.1.zip
[Link 2]: https://github.com/SecureAuthCorp/impacket/tree/master/tests
[Link 3]: https://github.com/SecureAuthCorp/impacket/tree/master/examples