Open Source • Educacional • Python

ForenseLab

A Ferramenta Educacional de Perícia Digital

Uma ponte entre ferramentas comerciais caras e soluções open-source complexas. Aprenda metodologia forense sem a curva de aprendizado íngreme.

pip install forensic-cli

O Problema

Ferramentas comerciais como EnCase e FTK são caras e inacessíveis para estudantes. Por outro lado, ferramentas open-source como Autopsy e Sleuth Kit têm uma curva de aprendizado muito íngreme para iniciantes, focando em operação técnica ao invés de metodologia investigativa.

A Proposta

ForenseLab é uma ponte educacional. Um laboratório digital que abstrai a complexidade técnica, permitindo que estudantes e professores foquem no raciocínio investigativo e na metodologia forense. Simples de usar, mas poderoso o suficiente para cenários reais de aprendizado.

Recursos Principais

Projetado com foco em educação, simplicidade e extensibilidade

Intuitive CLI

Interface de linha de comando clara e bem documentada, construída com Typer. Comandos simples e legíveis que facilitam o aprendizado.

Modular Architecture

Arquitetura extensível que permite adicionar novos módulos de análise sem alterar o núcleo. Cada módulo é independente e focado.

Didactic Focus

Abstrai a complexidade para que estudantes possam focar no raciocínio investigativo. Aprenda metodologia, não apenas operação de ferramentas.

Core Modules

Módulos especializados para diferentes tipos de análise forense

Network Analysis

Ferramentas para análise de rede, mapeamento de hosts e identificação de serviços

ipinfo

Informações detalhadas sobre endereços IP.

arpscan

Scan de rede via protocolo 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

Mapeamento de hosts na rede.

scan

Varredura de portas abertas.

fingerprinting

Identificação de serviços e sistemas.

CLI in Action

Interface simples e intuitiva. Veja como é fácil começar a usar

Terminal
# Scan a host for open ports
$ forensic-cli network scan --target 192.168.1.1 --ports 80,443
# Extract browser history from Chrome
$ forensic-cli browser history --browser chrome --output ./report.json
# Analyze email headers
$ forensic-cli email header-analysis --file suspicious.eml
# Get IP information
$ forensic-cli network ipinfo --ip 8.8.8.8

Todos os comandos incluem --help para documentação detalhada

Documentation

Guia completo de instalação, uso e contribuição

Instalação

ForenseLab está disponível via PyPI. Certifique-se de ter Python 3.8+ instalado.

Instalar via pip:
$ pip install forensic-cli
Ou instalar em modo de desenvolvimento:
$ git clone https://github.com/seu-usuario/ForenseLab.git
$ cd ForenseLab
$ pip install -e .

Primeiro Comando

Após a instalação, verifique se tudo está funcionando:

$ forensic-cli --version
ForenseLab v0.1.0
Obter ajuda sobre qualquer comando:
$ forensic-cli --help

Changelog

Histórico completo de versões e mudanças do ForenseLab

v1.5.0

Em Desenvolvimento
3 de novembro de 2024
Melhoria

Melhoria nas funcionalidades existentes

Melhoria

Suporte a exportação em múltiplos formatos (JSON, CSV, HTML)

Novo

Internacionalização da aplicação

v1.4.6

Atual
24 de setembro de 2024
Melhoria

Melhorias do README

Melhoria

Melhoria nas funções de port scanner e network map

Novo

Adição da visualização em nodes para o network map

Correção

Correções no workflow de deploy

v1.0.0

Lançamento Inicial
1 de setembro de 2024
Novo

Criação da pipeline de deploy do projeto no PyPi e GitHub Pages

Melhoria

Adição de barras de progresso na execução das funções

v0.1.0

Alpha
19 de agosto de 2024
Novo

Criação dos módulos de browser, network e email

Novo

Criação da CLI utilizando Typer

Novo

Integração da CLI com os módulos

Para ver o changelog completo e detalhado, visite o repositório no GitHub

Roadmap

Futuras extensões planejadas para expandir as capacidades educacionais da ferramenta

Dashboard Web

Planejado

Interface gráfica para visualização de resultados e geração de relatórios interativos

Visualizadores

Planejado

Gráficos, mapas de rede e timelines para análise visual de dados forenses

Wizard Interativo

Em Desenvolvimento

Assistente passo a passo para guiar investigações e gerar relatórios automáticos

Novos Módulos

Futuro

Análise mobile (iOS/Android), detecção de malware e recuperação de dados