forensic-cli 1.4.5

DevKit Forense - CLI para análise de navegadores e rede

DevKit Forense – Ferramenta Educacional de Perícia Digital

ForenseLab é um toolkit modular de análise forense digital, desenvolvido como um Trabalho de Conclusão de Curso em Engenharia da Computação. Seu principal objetivo é servir como uma ponte educacional para estudantes, educadores e entusiastas da área de segurança da informação.

Sumário

1. Introdução
2. Estrutura do Projeto
3. Módulos Forenses
   • Network
   • Browser
   • Email
4. Tecnologias Utilizadas
5. Planejamento e Futuras Extensões
6. Instalação
7. Exemplos de Execução

---

🎯 O Problema

O ensino prático de computação forense enfrenta uma barreira significativa. Ferramentas comerciais padrão de mercado, como EnCase e FTK, são robustas, mas possuem um custo proibitivo para ambientes acadêmicos. Por outro lado, alternativas open-source consolidadas, como Autopsy e Volatility Framework, embora poderosas e gratuitas, apresentam uma curva de aprendizado íngreme que pode intimidar e frustrar iniciantes.

Essa dualidade cria uma lacuna educacional: falta uma plataforma que permita ao estudante focar na metodologia investigativa, sem se perder na complexidade operacional da ferramenta.

💡 A Proposta do ForenseLab

O ForenseLab nasce para preencher essa lacuna, atuando como um "laboratório digital" introdutório. Ele não busca competir em funcionalidades com as suítes profissionais, mas sim oferecer um ambiente controlado, simplificado e didático para a aplicação de conceitos teóricos.

Este projeto é destinado a estudantes e professores da área de Segurança da Informação e Perícia Digital, servindo como uma ponte entre a teoria e a prática.

✨ Recursos Principais

• 💻 Interface de Linha de Comando (CLI) Intuitiva: Todas as análises são executadas através de uma CLI clara e bem documentada, ideal para automação, scripts e para quem busca agilidade no terminal.
• 🧩 Arquitetura Modular e Extensível: O toolkit é organizado em módulos independentes (Navegadores, Rede, E-mails), o que permite que a comunidade adicione facilmente novas capacidades de análise sem alterar o núcleo do sistema.
• 🎓 Foco Didático: Ao abstrair complexidades desnecessárias, a ferramenta permite que o aluno se concentre em entender os artefatos digitais e desenvolver o raciocínio investigativo.

🏛️ Arquitetura do Projeto

Para garantir a manutenibilidade e a clareza do código, o ForenseLab adota uma arquitetura de duas camadas principais, organizada em um monorepositório:

1. Core

   • O que faz: É o cérebro do projeto. Contém toda a lógica de negócio, as classes de análise forense e as funções utilitárias. Centralizar a lógica no Core garante que as regras sejam consistentes e o código seja reutilizável.

2. CLI (Command-Line Interface)

   • O que faz: É a interface do usuário e o ponto de entrada para todas as funcionalidades. Construída com Typer, ela invoca a lógica do Core para executar as análises e apresentar os resultados de forma estruturada no terminal.

3. Módulos Forenses

Network

Função	Descrição
ipinfo	Consulta informações detalhadas sobre um endereço IP.
arpscan	Varre a rede para identificar dispositivos conectados via ARP.
dnscan	Realiza levantamento de informações de DNS de domínios e hosts.
snmpscan	Realiza varredura SNMP em dispositivos de rede.
smbscan	Verifica serviços SMB ativos em um host .
sweep	Verifica quais hosts estão ativos em uma faixa de IP.
traceroute	Traça o caminho percorrido por pacotes até um host alvo.
map	Gera mapa visual de hosts e conexões detectadas.
scan	Identifica portas abertas e serviços ativos em hosts.
fingerprinting	Identifica sistemas, serviços e versões na rede.

Browser

Função	Descrição
logins	Extração de credenciais armazenadas no Chrome e Edge.
favscreen	Captura e organiza screenshots de sites favoritos ou acessados.
words	Identifica palavras mais comuns em histórico de navegação e downloads.
history	Coleta histórico de navegação de diferentes browsers.
patterns	Identifica padrões suspeitos em histórico de navegação ou downloads.
downloads	Lista arquivos baixados pelos usuários.

Email

Função	Descrição
email_parser	Extrai e organiza informações de emails.
header_analysis	Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes.

4. Tecnologias Utilizadas

• Python: Linguagem principal do projeto, escolhida por sua simplicidade e pelo vasto ecossistema de bibliotecas para manipulação de dados.
• Typer: Utilizado para criar a interface de linha de comando (CLI) de forma robusta e intuitiva.
• SQLite: Várias análises, como a de históricos de navegadores, interagem diretamente com bancos de dados SQLite.

5. Planejamento e Futuras Extensões

Aplicação / Módulo	Objetivo	Possíveis Extensões
Dashboard	Painel central para visualização e execução de módulos	Filtros avançados, alertas em tempo real, integração direta com relatórios
Visualizadores	Transformar dados da CLI em gráficos, mapas e tabelas	Timeline interativa, heatmaps de rede, gráficos de comportamento de usuários
Wizard	Guiar o usuário passo a passo	Templates de análise rápida, integração automática com módulos de email e data, relatórios PDF/HTML
Novos módulos CLI	Expansão da análise forense	Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence
Ferramentas auxiliares	Suporte a módulos existentes e novos	Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real

6. Instalação

A forma mais simples de instalar a CLI é utilizando o PyPI.
Execute o seguinte comando no terminal:

pip install forensic-cli

7. Exemplos de Execução da CLI

Comandos de Rede (network)

Utilitários para escanear, mapear e analisar redes e dispositivos.

map

Mapeia dispositivos ativos na rede e salva os resultados em arquivos JSON e CSV.

Sintaxe:

forensic-cli network map --network <RANGE_IP> [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--network	-n	Range de IPs da rede. Ex: 192.168.1.1-254	Obrigatório
--ports	-p	Portas para escanear em cada host.	21,22,80,443,445,8080
--output	-o	Diretório para salvar os resultados.	./output

scan

Realiza um scan de portas em um host específico e exibe os resultados em uma tabela.

Sintaxe:

forensic-cli network scan --target <ALVO> [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--target	-t	Alvo do scan (IP ou hostname).	Obrigatório
--ports	-p	Portas para escanear. Ex: '22,80,100-200'.	21,22,53,80,443,445,3306,8080

sweep

Verifica hosts ativos em um range de IPs via ping.

Sintaxe:

forensic-cli network sweep --network <RANGE_IP>

Opções:

Opção	Atalho	Descrição	Padrão
--network	N/A	Range de IPs da rede. Ex: 192.168.1.1-254	Obrigatório

fingerprinting

Detecta o sistema operacional, serviços e portas abertas em um host.

Sintaxe:

forensic-cli network fingerprinting --ip <IP_HOST>

Opções:

Opção	Atalho	Descrição	Padrão
--ip	N/A	Endereço IP do host. Ex: 192.168.0.10	Obrigatório

traceroute

Exibe o caminho (hops) e a latência (RTT) até um domínio ou host.

Sintaxe:

forensic-cli network traceroute --domain <DOMINIO>

Opções:

Opção	Atalho	Descrição	Padrão
--domain	N/A	Informe um domínio ou hostname. Ex: google.com	Obrigatório

arpscan

Realiza uma varredura ARP para identificar dispositivos na rede local.

Sintaxe:

forensic-cli network arpscan --network <RANGE_IP>

Opções:

Opção	Atalho	Descrição	Padrão
--network	N/A	Range de IPs da rede. Ex: 192.168.1.1-254	Obrigatório

dnscan

Realiza reconhecimento DNS em um domínio ou IP, com opção de buscar subdomínios.

Sintaxe:

forensic-cli network dnscan --target <ALVO> [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--target	N/A	Domínio ou IP alvo. Ex: exemplo.com	Obrigatório
--output-dir	N/A	Diretório para salvar os resultados (JSON e CSV).	Nenhum
--with-subdomains	N/A	Tenta descobrir subdomínios comuns.	False

ipinfo

Obtém informações detalhadas (geolocalização, ASN) sobre um IP ou hostname.

Sintaxe:

forensic-cli network ipinfo --ip <IP_HOST>

Opções:

Opção	Atalho	Descrição	Padrão
--ip	N/A	IP ou hostname do destino. Ex: 8.8.8.8	Obrigatório

smbscan

Verifica serviços SMB (Server Message Block) ativos em um host.

Sintaxe:

forensic-cli network smbscan --ip <IP_HOST>

Opções:

Opção	Atalho	Descrição	Padrão
--ip	N/A	IP ou hostname do destino. Ex: 192.168.0.10	Obrigatório

snmpscan

Executa uma varredura SNMP (Simple Network Management Protocol) para obter informações de um dispositivo.

Sintaxe:

forensic-cli network snmpscan --ip <IP_HOST>

Opções:

Opção	Atalho	Descrição	Padrão
--ip	N/A	IP ou hostname do destino. Ex: 192.168.0.10	Obrigatório

Comandos de Navegador (browser)

Ferramentas para extrair e analisar artefatos de navegadores web como Chrome, Edge e Firefox.

history

Extrai o histórico de navegação dos navegadores instalados.

Sintaxe:

forensic-cli browser history [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--chrome	N/A	Extrair histórico do Google Chrome.	False
--edge	N/A	Extrair histórico do Microsoft Edge.	False
--firefox	N/A	Extrair histórico do Mozilla Firefox.	False
--all	N/A	Extrair de todos os navegadores suportados.	False

downloads

Extrai o histórico de downloads dos navegadores.

Sintaxe:

forensic-cli browser downloads [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--output-dir	-o	Diretório para salvar os artefatos.	artefatos/downloads
--chrome	N/A	Extrair downloads do Chrome.	False
--edge	N/A	Extrair downloads do Edge.	False
--firefox	N/A	Extrair downloads do Firefox.	False
--all	N/A	Extrair de todos os navegadores.	False

favscreen

Processa arquivos de histórico (.json), captura favicons e screenshots das URLs encontradas.

Sintaxe:

forensic-cli browser favscreen [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--input-dir	-i	Diretório contendo os JSONs de histórico.	artefatos/historico
--output-dir	-o	Diretório para salvar favicons e prints.	artefatos/favscreen

logins

Extrai senhas e logins salvos no Chrome e Edge.

Sintaxe:

forensic-cli browser logins [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--output-dir	-o	Diretório para salvar os logins em JSON.	artefatos/logins
--chrome	N/A	Extrair logins do Chrome.	False
--edge	N/A	Extrair logins do Edge.	False
--all	N/A	Extrair de todos os navegadores.	False

patterns

Analisa arquivos de histórico (.json) para encontrar padrões de navegação e gera gráficos.

Sintaxe:

forensic-cli browser patterns [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--input-dir	-i	Diretório com os JSONs de histórico.	artefatos/historico
--output-dir	-o	Diretório para salvar gráficos e relatórios.	artefatos/patterns_output

words

Extrai as palavras mais pesquisadas do histórico do navegador.

Sintaxe:

forensic-cli browser words [OPÇÕES]

Opções:

Opção	Atalho	Descrição	Padrão
--output-dir	-o	Diretório para salvar o JSON com as palavras.	artefatos/words_output
--chrome	N/A	Extrair palavras do Chrome.	True