Daniel G. Rissi

AEGIS: Orquestrador de Pentest com IA Local

Desenvolvimento Ativo — Red Team • Automação com IA

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.

🎯 Objetivo: Acelerar fase de reconhecimento e exploração, mantendo controle humano e ética em testes autorizados.

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

  1. Adicionar alvo ao escopo: aegis scope add alvo.com
  2. Executar scan: aegis scan alvo.com
  3. Analisar resultado com IA: aegis ask "identifiquei X porta aberta, próximos passos?"
  4. Registrar achado em SQLite (automático)
  5. 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)