Impacket

SECUREAUTH LABS. Copyright (C) 2022 SecureAuth Corporation. Todos os direitos reservados.

Impacket é uma coleção de classes Python para trabalhar com protocolos de rede. O Impacket é focado em fornecer acesso programático de baixo nível aos pacotes e, para alguns protocolos (ex.: SMB1-3 e MSRPC), à própria implementação do protocolo. Os pacotes podem ser construídos do zero, bem como analisados a partir de dados brutos, e a API orientada a objetos torna simples trabalhar com hierarquias profundas de protocolos. A biblioteca fornece um conjunto de ferramentas como exemplos do que pode ser feito no contexto desta biblioteca.

Uma descrição de algumas das ferramentas pode ser encontrada em SecureAuth Labs' Open Source Website.

Quais protocolos são apresentados?

• Ethernet, captura "Cooked" do Linux.
• IP, TCP, UDP, ICMP, IGMP, ARP.
• Suporte a IPv4 e IPv6.
• NMB e SMB1, SMB2 e SMB3 (implementações de alto nível).
• MSRPC versão 5, sobre diferentes transportes: TCP, SMB/TCP, SMB/NetBIOS e HTTP.
• Autenticações simples, NTLM e Kerberos, usando senha/hashes/tickets/chaves.
• Implementação parcial/completa das seguintes interfaces MSRPC: EPM, DTYPES, LSAD, LSAT, NRPC, RRP, SAMR, SRVS, WKST, SCMR, BKRP, DHCPM, EVEN6, MGMT, SASEC, TSCH, DCOM, WMI, OXABREF, NSPI, OXNSPI.
• Partes das implementações dos protocolos TDS (MSSQL) e LDAP.

Mantenedor

Índice

• Obtendo o Impacket
• Configuração
• Testes
• Licenciamento
• Aviso Legal
• Contate-nos

Obtendo o Impacket

Última versão

• Impacket v0.10.0

  

Lançamentos atuais e anteriores

Versão de desenvolvimento

• Impacket v0.10.1-dev (master branch)

  

Configuração

Início rápido

Para obter a versão estável mais recente com pip, execute:

python3 -m pip install impacket

ℹ️ Isso disponibilizará a biblioteca Impacket para seu código Python, mas não fornecerá os scripts de exemplo.

Instalando a biblioteca + scripts de exemplo

Para instalar a biblioteca e os scripts de exemplo, baixe e extraia o pacote e execute o seguinte comando no diretório onde o lançamento do Impacket foi descompactado:

python3 -m pip install .

ℹ️ Isso instalará a biblioteca no caminho padrão dos módulos Python, onde você poderá usar os scripts de exemplo a partir do diretório.

⚠️ Certifique-se de que os scripts de exemplo que você está usando sejam consistentes com a versão da biblioteca instalada em seu ambiente Python. Recomendamos o uso de ambientes virtuais para garantir que as instalações em todo o sistema não interfiram.

Suporte ao Docker

Construir a imagem do Impacket:

  $ docker build -t "impacket:latest" .

Usando a imagem do Impacket:

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

Testes

A biblioteca utiliza o framework pytest para organizar e marcar casos de teste, tox para automatizar o processo de execução em todas as versões Python suportadas, e coverage para obter estatísticas de cobertura.

Um guia de testes abrangente está disponível.

Licenciamento

Este software é fornecido sob uma versão ligeiramente modificada da Licença de Software Apache. Consulte o arquivo LICENSE anexo para mais informações.

Suporte a SMBv1 e NetBIOS baseado em Pysmb por Michael Teo.

Aviso Legal

O espírito desta iniciativa de Código Aberto é ajudar pesquisadores de segurança e a comunidade a acelerar atividades de pesquisa e educacionais relacionadas à implementação de protocolos e pilhas de rede.

As informações neste repositório são para fins de pesquisa e educacionais e não se destinam a ser usadas em ambientes de produção e/ou como parte de produtos comerciais.

Se você deseja usar este código ou parte dele para seus próprios fins, recomendamos aplicar o ciclo de vida de desenvolvimento de segurança adequado e práticas de codificação segura, bem como gerar e rastrear os respectivos indicadores de comprometimento de acordo com suas necessidades.

Contate-nos

Se você deseja relatar um bug, enviar um patch ou dar algumas sugestões sobre este pacote, envie-nos algumas linhas para [email protected].

Para questões relacionadas à segurança, consulte nossa política de segurança.