NIS2 Agile API

Stato della piattaforma, versione API e timestamp. Non richiede autenticazione.

Risposta 200

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": 1709900400,
  "platform": "NIS2 Agile"
}

Score di conformità NIS2 aggregato per dominio Art.21, con statistiche rischi, incidenti aperti e policy approvate.

Risposta 200

{
  "overall_score": 73,
  "label": "substantially_compliant",
  "domain_scores": [
    { "category": "governance", "score": 80, "answered": 8, "total": 10 }
  ],
  "risks": { "total": 24, "critical": 2, "high": 5 },
  "incidents": { "open": 3, "significant": 1 },
  "policies": { "approved": 12, "draft": 4 }
}

Feed rischi con filtri su livello, area NIS2, stato e data. Include deadline di trattamento.

Query Parameters

Risposta 200

{
  "risks": [
    {
      "id": 15,
      "risk_code": "RSK-2026-015",
      "title": "Vulnerabilità VPN senza MFA",
      "category": "network_security",
      "risk_level": "high",
      "risk_score": 15,
      "treatment": "mitigate",
      "nis2_article": "21.2.i",
      "created_at": "2026-01-15T10:30:00+01:00"
    }
  ],
  "total": 24, "filters": { "level": "high" }
}

Feed incidenti con status Art.23 (deadlines 24h/72h/30d) e flag di scadenza. Utile per integrare in SIEM e SOC dashboard.

Query Parameters

Risposta 200 — Elemento

{
  "id": 7,
  "incident_code": "INC-2026-007",
  "title": "Accesso non autorizzato sistema ERP",
  "severity": "high",
  "is_significant": true,
  "art23_status": {
    "early_warning": { "due": "2026-02-21T14:00:00+01:00", "sent": true, "overdue": false },
    "notification": { "due": "2026-02-23T14:00:00+01:00", "sent": false, "overdue": false },
    "final_report": { "due": "2026-03-22T14:00:00+01:00", "sent": false, "overdue": false }
  }
}

Stato dei controlli di sicurezza Art.21 raggruppati per categoria (governance, network_security, access_control, ecc.).

Risposta 200 — Elemento categoria

{
  "category": "network_security",
  "total": 8,
  "implemented": 5,
  "partial": 2,
  "not_implemented": 1,
  "score": 75
}

Inventario asset critici con tipo, livello di criticità e dipendenze. Filtrabili per tipo e livello.

Query Parameters

Panoramica rischio fornitori con risk_score, data ultima valutazione e flag critici. Include stats aggregate.

Risposta 200 — Stats

{
  "suppliers": [...],
  "stats": {
    "total": 18,
    "critical": 2,
    "high": 4,
    "avg_risk_score": 42
  }
}

Policy approvate con categoria, articolo NIS2 di riferimento e versione. Opzionalmente include il testo completo.

Query Parameters

Restituisce tutte le API Keys (attive e revocate) dell'organizzazione corrente. Non espone mai il testo completo della chiave.

Body (JSON)

Risposta 201

{
  "id": 5,
  "name": "SIEM Integration",
  "key": "nis2_a3f8c2d1e4b7...",
  "key_prefix": "nis2_a3f8c2",
  "scopes": ["read:risks", "read:incidents"],
  "warning": "Salva questa chiave in modo sicuro. Non sara' piu' visibile."
}

Revoca una API Key impostando is_active = 0. La chiave non viene eliminata dal DB per mantenere l'audit trail.

Include statistiche di delivery (total, success, failed) per ogni subscription. Non espone il secret HMAC.

Body (JSON)

Risposta 201

{
  "id": 3,
  "secret": "a3f8c2d1e4b7f9a2c8d3e1f4...",
  "warning": "Salva il secret. Sara' usato per verificare la firma X-NIS2-Signature."
}

Aggiornamento parziale (PATCH semantics). Solo i campi inviati vengono aggiornati: name, events, is_active.

Invia un ping di test per verificare che l'endpoint remoto sia raggiungibile e risponda correttamente. Controlla il delivery log per il risultato.

Query Parameters