AEGIS: Orquestrador de Pentest com IA Local
Resumo
AEGIS é uma plataforma de automação de penetration testing que orquestra ferramentas de recon/scan (nmap, gobuster, whatweb) e utiliza IA local como tutor de Red Team. Desenvolvida baseado no curso Hackers do Bem — Especialização Red Team.
Funcionalidades Principais
1. Orquestração de Ferramentas
- Nmap: Varredura de portas, detecção de serviços e versões
- Gobuster: Brute force de diretórios e subdomínios
- WhatWeb: Fingerprinting de aplicações web
- Interface CLI: Comandos simples e intuitivos
2. IA Local como Tutor
- Motor IA: Ollama + qwen2.5-coder:7b (sem internet necessária)
- Capacidade: Análise de achados, sugestão de próximos passos, explicações técnicas
- Exemplo:
aegis ask "qual é a próxima fase de teste para IDOR?"
3. Registro de Sessões
- Banco SQLite: Histórico automático de scans e achados
- Rastreabilidade: Data, hora, alvo, evidências, notas
- Auditoria: Compliance com escopo autorizado
4. API REST (FastAPI)
- Integração futura: App Android com Kotlin + Jetpack Compose
- Documentação automática: Swagger em /docs
- Porta padrão: 8000
Stack Tecnológico
| Camada | Tecnologia |
|---|---|
| IA Local | Ollama + qwen2.5-coder:7b |
| Backend CLI | Python 3.10+ |
| API REST | FastAPI + Uvicorn |
| Banco de Dados | SQLite |
| Ferramentas de Scan | nmap, gobuster, whatweb |
| Android (futuro) | Kotlin + Jetpack Compose |
Como Usar
Comandos Principais
1. Gerenciar Escopo (Alvos Autorizados)
python3 aegis.py scope add alvo-autorizado.com
python3 aegis.py scope list 2. Executar Scan
python3 aegis.py scan alvo-autorizado.com 3. Consultar IA Local (Tutor)
python3 aegis.py ask "explica o achado de MySQL exposto"
python3 aegis.py ask "quais são as próximas fases de teste?" 4. Listar Histórico de Sessões
python3 aegis.py sessions 5. Iniciar API REST
cd api && uvicorn main:app --host 0.0.0.0 --port 8000 --reload Fluxo de Teste Típico
- Adicionar alvo ao escopo:
aegis scope add alvo.com - Executar scan:
aegis scan alvo.com - Analisar resultado com IA:
aegis ask "identifiquei X porta aberta, próximos passos?" - Registrar achado em SQLite (automático)
- Gerar relatório (futuro)
Roadmap Futuro
- 📱 App Android com Kotlin + Jetpack Compose
- 📊 Dashboard web de resultados em tempo real
- 🔗 Integração Shodan API para inteligência externa
- 💣 Geração automática de PoC com Metasploit
- 📄 Relatórios profissionais em PDF/HTML com CVSS scores
- 🔄 Integração CI/CD para testes de segurança contínuos
- ☁️ Backup/export automático de sessões
Contexto Legal e Ético
✅ AEGIS foi desenvolvido exclusivamente para testes autorizados.
📋 Rastreabilidade: Todo escopo de teste é registrado com hash do contrato de autorização antes de qualquer ação.
⚖️ Lei 12.737/2012 (Brasil): Uso não autorizado de ferramentas de ataque é crime — máximo 3 anos de cadeia.
Status de Desenvolvimento
Fase: Desenvolvimento Ativo
Lançamento esperado: Q1 2026
Visibilidade: Open Source (GitHub público quando pronto)