DarkGrid – Painel de Inteligência de Ameaças Global

Painel de inteligência de ameaças OSINT: um globo 3D e feed ao vivo mostrando infraestrutura maliciosa de fontes públicas como AbuseIPDB e OpenPhish.

https://github.com/user-attachments/assets/e4f6a4fa-6ff4-4ad1-8e5c-5b50ce6ad722

Visão Geral

DarkGrid visualiza infraestrutura suspeita da internet globalmente:

• Globo de ameaças 3D com “pings” pulsantes por país com base no volume de indicadores.
• Feed de ameaças com os IPs/URLs mais recentes dos coletores OSINT.
• Barra Localizar para saltar para indicadores ou localizações geográficas.
• Painel de inteligência para cartões de contexto (clusters de ameaças, dossiês regionais, notícias, etc.).

O foco é consciência situacional da infraestrutura, não de indivíduos.

Estrutura do projeto

• backend/ – API OSINT FastAPI + SQLite
  • Coletores: AbuseIPDB (IPs), OpenPhish (URLs)
  • Agendador executa coletores na inicialização e a cada 15 minutos
  • /api/indicators/latest – indicadores mais recentes para o feed
  • /api/map – agrupamentos por país para o globo
• frontend/ – aplicação Next.js 16 (UI do DarkGrid)
  • src/app/page.tsx – layout principal do painel
  • src/components/ThreatGlobeViewer.tsx – globo 3D
  • src/hooks/useThreatDataPolling.ts – consulta à API de ameaças
• docker-compose.yml – stack local (backend + frontend)

Início rápido (Docker)

1. Crie .env neste diretório (mesma pasta que docker-compose.yml):

   root@kitploit:~

   copy .env.example .env
   

   Edite .env e defina:

   • ABUSEIPDB_API_KEY – obtenha uma chave gratuita em https://www.abuseipdb.com/.

2. Inicie a stack:

   root@kitploit:~

   docker-compose up -d
   

   Ou execute em primeiro plano para ver os logs:

   root@kitploit:~

   docker-compose up
   

3. Abra a UI e a API:

   • Dashboard: http://localhost:3000
   • Backend API: http://localhost:8000
   • Health: http://localhost:8000/health

Dados e ingestão

• Banco de dados: SQLite, criado automaticamente na primeira inicialização do backend.

  • No Docker, os dados estão no volume backend_data em /app/data/threat_intel.db.
  • No desenvolvimento local (sem Docker), os dados estão em backend/data/threat_intel.db.

• Coletores (executados na inicialização e a cada 15 minutos):

  • AbuseIPDB (requer ABUSEIPDB_API_KEY):

    • Produz indicadores type=ip, source=abuseipdb com geo.country.
    • Alimenta tanto o feed de ameaças quanto os pings do globo (agrupamentos por país).

  • OpenPhish (nenhuma chave necessária):

    • Produz indicadores type=url, source=openphish (sem geo).
    • Aparece apenas no feed de ameaças (sem pings no globo).

• Solução de problemas: globo / feed vazios:

  • Se o globo não tiver e o feed estiver vazio:

Desenvolvimento local (sem Docker)

Requisitos:

• Python 3.11+
• Node.js 20+

Backend

cd backend
python -m venv .venv
.venv\Scripts\activate  # on Windows
pip install -r requirements.txt
python main.py  # serves on http://localhost:8000

Certifique-se de que seu .env raiz tenha ABUSEIPDB_API_KEY para ingestão.

Frontend

cd frontend
npm install

Crie frontend/.env.local (apenas para desenvolvimento local):

NEXT_PUBLIC_THREAT_API_URL=http://localhost:8000

Depois execute:

npm run dev

Abra http://localhost:3000.

Status

Este projeto é um trabalho em andamento e representa um MVP bruto do painel de inteligência de ameaças DarkGrid. Espere mudanças significativas à medida que o backend, coletores e UI são refinados.

Estágios futuros planejados incluem:

• Pings de globo mais ricos: agrupamentos mais granulares, dimensionamento/animacão refinados e melhor comportamento de clique.
• Fontes OSINT adicionais: mais feeds de reputação de IP/URL/domínio e malware além de AbuseIPDB e OpenPhish.
• Inteligência de indicador mais profunda: detalhes expandidos para cada indicador e cluster de país.