Statecraft Cyber Intelligence

Piattaforma di threat intelligence in portoghese costruita da zero come progetto personale di Blue Team. Aggrega dati da fonti aperte globali e li trasforma in briefing tecnici, notizie classificate, CVE arricchiti e IOC strutturati — tutto in PT-BR, aggiornato continuamente.

Sito: statecraftcyber.vercel.app

---

Cosa offre la piattaforma

• Threat Briefings — schede tecniche generate dall'IA (Groq / LLaMA 3.3 70B) ogni ora, con severità, IOC, CVE e raccomandazioni dirette per il Blue Team
• CVE — vulnerabilità delle ultime 72h con CVSS, EPSS, CISA KEV e classificazione per tipo (Esecuzione di Codice, Iniezione, Buffer Overflow ecc.)
• Notizie — 20 feed RSS da fonti internazionali e brasiliane (CISA, Krebs, Google Threat Intelligence, CERT.br, WeLiveSecurity Brasil e altre), classificate per tipo di minaccia e regione. Quando l'utente apre un articolo, l'IA Statecraft arricchisce il contenuto su richiesta, generando un articolo giornalistico completo in PT-BR. Il risultato viene memorizzato nella cache in NewsCache per servire letture successive senza una nuova chiamata all'LLM
• IOC Search — ricerca di indicatori di compromissione estratti dai briefing, con supporto per IP, dominio, hash, URL ed e-mail
• Health Endpoint — /api/health per il monitoraggio della disponibilità e dell'integrità del database
• Informazioni — contesto tecnico della piattaforma e della pipeline di dati

---

Stack

Livello	Tecnologia
Frontend / Backend	Next.js 16.2.6 (App Router), TypeScript, Tailwind CSS v4
Database	PostgreSQL (Neon) + Prisma 6
IA	Groq API (LLaMA 3.3 70B)
Sanitizzazione	isomorphic-dompurify + marked
Fonti di minaccia	NVD API, CISA KEV, OTX AlienVault, EPSS (FIRST.org)
Feed di notizie	20 fonti RSS internazionali e brasiliane
Deploy	Vercel (app) + cron-job.org (scheduler orario esterno, piano Hobby)

---

Architettura e Pipeline di Dati

Fonti esterne (NVD, CISA KEV, OTX, RSS)
        │
        ▼
  cron-job.org → Vercel — esegue ogni ora (Hobby plan)
  vercel.json definisce lo schedule per la futura migrazione al piano Pro
        │
        ├── Raccolta notizie (RSS feeds) → NewsCache (PostgreSQL)
        │
        └── Raccolta minacce (NVD, CISA, OTX)
                │
                ▼
          Groq LLaMA 3.3 70B
          Genera briefing strutturato (titolo, riassunto,
          severità, IOC, CVE, MITRE ATT&CK)
                │
                ▼
          Briefing → PostgreSQL (status: published)
                │
                ├── IOC strutturati → tabella Ioc
                └── Esposti via API REST → Frontend (Next.js)

---

Modelli Prisma

Modello	Descrizione
Briefing	Briefing completo generato dall'IA con metadati di minaccia
Ioc	Indicatori di compromissione normalizzati con indici
NewsCache	Notizie arricchite dai feed RSS
CronLog	Log di esecuzione dei cron job

---

Setup locale

Prerequisiti

• Node.js 20+
• PostgreSQL (o account Neon gratuito)
• Chiavi API: Groq, NVD (opzionale), OTX (opzionale)

Installazione

git clone https://github.com/ptkthg/statecraftcyber
cd statecraftcyber
npm install

Variabili d'ambiente

Copia il file di esempio e compila le variabili:

cp .env.example .env

Variabile	Descrizione
DATABASE_URL	URL di connessione PostgreSQL con ?sslmode=require
GROQ_API_KEY	Chiave API Groq (groq.com)
NVD_API_KEY	Chiave API NVD — opzionale, senza chiave il rate limit è più basso
OTX_API_KEY	Chiave AlienVault OTX — opzionale
CRON_SECRET	Token segreto per autenticare le chiamate cron (header Authorization: Bearer)
ADMIN_SECRET	Password di accesso al pannello /admin/status
AUTO_PUBLISH	true per pubblicare i briefing automaticamente
MAX_HOURLY_BRIEFINGS	Limite di briefing per ora (predefinito: 3)

Database

# Creare tabelle e applicare le migrazioni
npx prisma migrate dev

# Visualizzare i dati nel browser
npx prisma studio

Sviluppo

npm run dev

Accedi a http://localhost:3000.

Build per la produzione

npm run build
npm start

---

Comandi Prisma utili

# Applicare le migrazioni in produzione (senza generare file di migrazione)
npx prisma migrate deploy

# Rigenerare il Prisma Client dopo modifiche allo schema
npx prisma generate

# Resettare il database (ATTENZIONE: cancella tutti i dati)
npx prisma migrate reset

---

Fonti di dati

Fonte	Tipo	Endpoint
NVD (NIST)	CVE	services.nvd.nist.gov/rest/json/cves/2.0
CISA KEV	Vulnerabilità sfruttate	www.cisa.gov/sites/default/files/feeds/known_exploited_vulnerabilities.json
EPSS (FIRST.org)	Score di sfruttamento	api.first.org/data/v1/epss
AlienVault OTX	IOC e pulse	otx.alienvault.com/api/v1
20x RSS feeds	Notizie	CISA, Google Threat Intelligence, Cisco Talos, CERT.br, Elastic Security Labs e altri

---

Avviso

I dati di Threat Intelligence devono essere validati su fonti primarie prima di qualsiasi azione critica in produzione.

---

Sviluppato da Patrick Santos — Analista di Sicurezza, Blue Team.