Audit log

L'audit log è il registro immutabile delle operazioni rilevanti eseguite nel tenant. È lo strumento con cui si dimostra il principio di accountability dell'art. 5.2 GDPR: chi ha fatto che cosa, quando, da dove e con quale esito.

Che cosa viene registrato

Autenticazione e sessioni

Utenti, ruoli e permessi

Configurazione

Dati e privacy

Credenziali e integrazioni

Fatturazione e contratto

Struttura del record

{
  "id": "evt_01JQ8M4Z5T7C2B9K",
  "timestamp": "2026-09-04T09:41:07.812Z",
  "tenant": { "id": "tnt_9f2c41a", "slug": "acme-srl" },
  "action": "role.assigned",
  "category": "identity",
  "severity": "high",
  "outcome": "success",
  "actor": {
    "type": "user",
    "id": "usr_01JQ2A7F3D",
    "email": "mario.rossi@acme.it",
    "displayName": "Mario Rossi",
    "roles": ["tenant-admin"]
  },
  "target": {
    "type": "user",
    "id": "usr_01JQ5B8G1H",
    "email": "laura.bianchi@acme.it"
  },
  "changes": [
    { "field": "roles", "from": ["operator"], "to": ["operator", "supervisor"] }
  ],
  "context": {
    "ip": "93.45.112.7",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
    "geo": { "country": "IT", "region": "Lombardia" },
    "channel": "console",
    "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
    "requestId": "req_01JQ8M4Z5T"
  },
  "integrity": {
    "sequence": 1048221,
    "previousHash": "9f2c41a7b3e8d05c6a1f4b29e07d3c8a5e6f1b0d",
    "hash": "c8a5e6f1b0d9f2c41a7b3e8d05c6a1f4b29e07d3"
  }
}

Immutabilità e integrità

• Le voci sono scritte in modalità append-only: non esistono API né funzioni di interfaccia per modificarle o eliminarle, nemmeno per gli amministratori del tenant.
• Ogni voce contiene un sequence progressivo e un hash calcolato includendo l'hash della voce precedente: si forma una catena verificabile. La rimozione o l'alterazione di una voce interrompe la catena e viene rilevata.
• Le copie di lungo periodo sono archiviate su storage immutabile con blocco temporale.
• La verifica dell'integrità può essere richiesta su un intervallo di date e produce un rapporto di verifica firmato.

Conservazione

La conservazione non può essere ridotta sotto i 12 mesi: è il minimo necessario a garantire la tracciabilità richiesta dalle procedure di sicurezza. L'aumento è immediato e si applica anche alle voci già presenti; la riduzione avvia una cancellazione irreversibile della coda più vecchia.

Chi può accedere all'audit log

Per creare un ruolo di sola lettura dedicato al DPO, vedi Ruoli e permessi.

Consultazione e filtri

Esportazione per ispezioni e verifiche

curl -X GET "https://api.blupantheon.com/console/v1/audit-logs?from=2026-06-01T00:00:00Z&to=2026-08-31T23:59:59Z&action=role.assigned&limit=200" \
  -H "Authorization: Bearer $BP_TOKEN" \
  -H "Accept: application/json"

Integrazione con un SIEM

Per una vigilanza continua puoi inoltrare gli eventi verso il tuo SIEM.

Sono supportati l'inoltro via webhook (evento audit.entry.created, consigliato per la severità alta e critica) e l'estrazione periodica via API. Per firma e verifica della consegna vedi Firma HMAC.

Correlazione con il traceId

Ogni operazione della piattaforma genera un traceId che compare:

• nella voce di audit (context.traceId);
• nell'header di risposta X-BP-Trace-Id delle chiamate API;
• nei messaggi di errore mostrati in Console;
• nei log di consegna dei webhook.

Alert su eventi sensibili

Puoi ricevere una notifica via email o webhook quando si verificano eventi rilevanti. Regole consigliate: