Skip to content

PaulMass/python-pentest-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐍 Python Pentest Toolkit

Este é um Toolkit de Pentest completo desenvolvido em Python; Ele integra funcionalidades essenciais para análise de segurança ofensiva, incluindo varredura de rede, análise de arquivos, recuperação de informações (OSINT básica) e captura de pacotes.

🚀 Funcionalidades

O toolkit é composto pelos seguintes módulos principais:

Módulo Funcionalidades Dependências Principais
Análise de Rede (network_scanner.py) ARP Scan (descoberta de hosts na rede local), Port Scan (varredura de portas TCP com detecção de serviço/versão via Nmap). scapy, python-nmap
Análise de Arquivos e Info (info_analysis.py) Cálculo de Hash (MD5, SHA1, SHA256, SHA512) para verificação de integridade/malware, Whois Lookup, DNS Lookup. hashlib, whois
Sniffer de Rede (sniffer.py) Captura e análise em tempo real de pacotes de rede (Ethernet, IP, TCP, UDP, ICMP), exibindo informações de origem, destino e dados brutos. scapy

🛠️ Pré-requisitos

  1. Python 3.x
  2. Nmap (necessário para o Port Scan)

Instalação de Dependências

O módulo de rede requer a biblioteca scapy, que por sua vez tem dependências de sistema.

💻 Fedora Linux

# Instalar Nmap
sudo dnf install nmap -y

# Instalar dependências de sistema para scapy (python3-scapy não é o pacote padrão)
# Fedora usa python3-libcap para libpcap
sudo dnf install python3-devel libpcap-devel -y

📱 Android (Termux)

O Termux já usa pkg.

# Instalar Nmap e as dependências necessárias
pkg install nmap python libpcap -y

# Nota: O scapy pode ter limitações no Termux devido a restrições de rede do Android.
# O ARP Scan e Sniffer podem não funcionar corretamente sem root ou configurações específicas.

🐍 Instalação das Bibliotecas Python (Comum a todos)

# Instalar as bibliotecas Python
pip3 install -r requirements.txt

🐧 Debian/Ubuntu

# Instalar Nmap e python3-scapy (dependência de sistema)
sudo apt update
sudo apt install -y nmap python3-scapy

O arquivo requirements.txt contém:

scapy
python-nmap
requests
whois
colorama

⚙️ Como Usar

O toolkit é executado através do arquivo principal main.py com subcomandos.

1. Análise de Rede (net)

ARP Scan (Descoberta de Hosts)

Atenção: Requer sudo para ser executado.

sudo python3 main.py net arp <faixa_de_ip>
# Exemplo:
sudo python3 main.py net arp 192.168.1.1/24

Port Scan (Varredura de Portas)

python3 main.py net port <alvo> [-p <portas>]
# Exemplo: Varredura das 100 primeiras portas do scanme.nmap.org
python3 main.py net port scanme.nmap.org -p 1-100

2. Análise de Arquivos e Informações (info)

Cálculo de Hash

python3 main.py info hash <caminho_do_arquivo> [-a <algoritmo>]
# Exemplo:
python3 main.py info hash /caminho/para/arquivo.zip -a sha512

Whois Lookup

python3 main.py info whois <dominio>
# Exemplo:
python3 main.py info whois google.com

DNS Lookup

python3 main.py info dns <dominio>
# Exemplo:
python3 main.py info dns github.com

3. Sniffer de Rede (sniff)

Atenção: Requer sudo para ser executado.

sudo python3 main.py sniff [-i <interface>] [-c <contador>] [-t <timeout>]
# Exemplo: Capturar 10 pacotes na interface eth0
sudo python3 main.py sniff -i eth0 -c 10
# Exemplo: Capturar por 30 segundos
sudo python3 main.py sniff -t 30

⚠️ Observações de Segurança e Uso

  • Privilégios de Root (sudo): As funcionalidades de baixo nível de rede, como ARP Scan e Sniffer de Rede, exigem privilégios de root (sudo) para acessar a interface de rede e enviar/receber pacotes brutos.
  • Uso Ético: Esta ferramenta é destinada a fins educacionais e testes de penetração autorizados. O uso indevido contra sistemas sem permissão expressa é ilegal e antiético. O desenvolvedor não se responsabiliza por qualquer uso indevido desta ferramenta.
  • Interface: A aplicação utiliza a biblioteca colorama para uma melhor experiência visual no terminal.

About

Python Pentest Toolkit with Network Scanner, File Analysis, Info Gathering, and Packet Sniffer.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages