# Audit log

L'audit log a prova di manomissione: cosa viene registrato, come cercarlo ed esportarlo e come verificare un'esportazione sigillata.

L'audit log è la registrazione permanente della piattaforma di ogni azione significativa. Ogni voce registra *cosa è successo*, *chi lo ha attivato*, *chi o cosa è stato interessato* e *quando*, insieme all'indirizzo IP di origine, alla posizione approssimativa e allo user agent. Le voci vengono soltanto aggiunte, mai modificate o eliminate manualmente, e ogni voce sigillata è concatenata e firmata crittograficamente, così che un log esportato possa essere dimostrato integro da una terza parte.

Il log si trova in **Audit Trail → Log** nella console di amministrazione.

## Cosa viene registrato

Il log copre l'intera gamma delle attività della piattaforma. In linea generale, le voci rientrano in queste aree:

- **Autenticazione**: accessi riusciti e falliti, scambi di token Single Sign-On, accessi federati (social/enterprise), autenticazione silenziosa, step-up e riautenticazione, logout e logout back-channel.
- **Autenticazione a più fattori**: registrazione dei fattori, verifiche riuscite e non riuscite, uso dei codici di recupero, rimozione dei fattori e reimpostazioni MFA avviate dall'amministratore.
- **Ciclo di vita dell'utente**: creazione dell'account, invito, modifiche al profilo, modifiche di email/telefono/nome utente/password, abilitazione/disabilitazione/sblocco dell'account ed eliminazione. Vedere [Ciclo di vita dell'utente](https://dts-identity.com/it/docs/directories/user-lifecycle.md).
- **Autorizzazione**: accesso alle applicazioni concesso e revocato, modifiche alle appartenenze a ruoli e gruppi, concessioni di amministratore di organizzazione e revisioni degli accessi.
- **Amministrazione e configurazione**: modifiche ad applicazioni, directory, connessioni, zone di rete, workflow di approvazione, workflow di certificazione, API e chiavi API, organizzazioni e impostazioni di sistema.
- **Incidenti di sicurezza**: tentativi con password compromesse, rilevamento di attacchi brute force, accesso da una regione vietata, accesso da un nuovo dispositivo e superamenti dei limiti di frequenza.
- **Eventi dei dispositivi**: registrazione e rimozione, comandi inviati o accodati a un dispositivo e passaggi online/offline del connector.
- **Eventi di sessione**: sessioni terminate dal sistema, con registrazione della durata totale della sessione conclusa.
- **Provisioning**: operazioni di provisioning SCIM in uscita e relativi esiti.
- **Approvazioni**: creazione ed eventi del ciclo di vita dei workflow di approvazione, nonché campagne di certificazione degli accessi e decisioni di revisione.
- **Impersonificazione**: quando un amministratore inizia e termina di agire per conto di un altro utente o di un'altra organizzazione.

Per l'elenco completo e dettagliato con le gravità, vedere [Tipi di evento di audit](https://dts-identity.com/it/docs/reference/audit-event-types.md).

## Il modello degli attori: chi ha fatto cosa a chi

Ogni voce distingue il **soggetto** (chi o cosa *riguarda* l'evento) dall'**attore** (chi lo ha *attivato*). È ciò che consente di rispondere alla domanda "cosa è successo all'utente X?" cercando sul soggetto, vedendo comunque chi ha agito.

- Per le azioni **self-service** (un utente che modifica la propria password o effettua l'accesso), soggetto e attore sono la stessa persona.
- Per le azioni **amministratore su utente** (un amministratore che assegna un ruolo a qualcuno o disabilita un account), il soggetto è l'utente interessato e l'amministratore che agisce viene registrato accanto.
- Per le **modifiche di sistema o di oggetti** (creazione di un'applicazione, modifica di un criterio), l'amministratore che agisce è l'utente della voce e l'oggetto modificato è indicato nella voce.
- Per le azioni **automatizzate** tramite API, l'attore viene registrato come client (macchina) anziché come persona, insieme al canale da cui proviene (console di amministrazione, API, provisioning, connector o sistema).

La vista di dettaglio di ogni voce mostra l'oggetto interessato, i campi modificati ove applicabile, IP/posizione/user agent e il contesto completo dell'evento.

## Ricerca e filtri

Il log si apre con le voci più recenti e carica quelle più vecchie durante lo scorrimento. La barra degli strumenti sopra l'elenco è la stessa degli elenchi di utenti e dispositivi:

- **Regole di filtro**: aggiunga una regola per campo e le combini: **Tipo di evento** (uno o più tipi del catalogo), **Categoria** e **Gravità** (interi gruppi di tipi in una volta), **Timestamp** (un intervallo da/a con orario, nel Suo fuso orario; lasci vuoto un lato per un intervallo aperto), **Paese** e **Città** (dalla geolocalizzazione della voce), **Indirizzo IP**, **Email dell'utente**, **Nome utente**, **Applicazione** e **Directory** (selezione dall'elenco), **Organizzazione** e **Descrizione**. Le regole di testo offrono *contiene*, *è uguale a*, *inizia con* e le relative negazioni; le regole di elenco offrono *è uno di* / *non è nessuno di*.
- **Ricerca a testo libero**: confronta con la descrizione, l'indirizzo IP, il nome/nome utente/email dell'utente soggetto o il nome dell'applicazione. Prema Invio per applicare.
- **Colonne**: mostri o nasconda le colonne e le trascini nell'ordine desiderato. Oltre a timestamp, evento, applicazione e utente predefiniti, sono disponibili indirizzo IP, posizione, gravità, categoria, directory e organizzazione.
- **Visualizzazioni**: le visualizzazioni standard a sinistra sono filtri già pronti: *Attacchi* (brute force, blocchi, password compromesse, regione vietata, posizione insolita), *Accessi non riusciti*, *Sicurezza e rilevamento delle anomalie*, *Configurazione e amministrazione del sistema* ed *Errori*. Salvi la propria combinazione di regole e colonne come visualizzazione con nome, oppure copi l'URL: ogni filtro si trova nella barra degli indirizzi.
- **Esporta CSV**: scarica l'elenco filtrato nell'ordine delle colonne visibile (menu di condivisione), dal più recente e limitato a 50.000 voci; la finestra di dialogo lo segnala quando la visualizzazione ne contiene di più, quindi restringa il filtro per coprire tutto.

L'elenco funziona anche **in tempo reale**: attivi la **Modalità live** e le nuove voci arrivano automaticamente man mano che si verificano, mentre il grafico delle attività si aggiorna, senza bisogno di ricaricare la pagina. È utile mentre si riproduce un problema o si segue lo sviluppo di un incidente. Il grafico e il feed live seguono il filtro attivo.

Apra qualsiasi voce per visualizzarne il pannello di dettaglio completo, incluso il contesto grezzo dell'evento.

Alcuni esempi pratici di combinazione dei filtri:

- **Tutti gli accessi falliti da un IP in una finestra temporale**: scelga la visualizzazione *Accessi non riusciti*, aggiunga una regola **Timestamp** con la finestra e una regola **Indirizzo IP**.
- **Tutto da un paese**: aggiunga una regola **Paese** (ad esempio dopo che la mappa degli attacchi della dashboard di protezione mostra un'origine inattesa); aggiunga **Timestamp** per restringere al giorno in questione.
- **Tutti gli eventi MFA di un utente**: aggiunga una regola **Tipo di evento** con gli eventi a più fattori e una regola **Email dell'utente**.
- **Tutte le modifiche di configurazione di un amministratore**: scelga la visualizzazione *Configurazione e amministrazione del sistema* e cerchi il nome dell'amministratore.
- **Tutto ciò che è accaduto a un dispositivo**: apra la scheda **Cronologia** del dispositivo. Elenca le voci relative a quel dispositivo (comandi, esecuzioni di aggiornamento, approvazione, utenti associati, violazioni dei criteri), con ricerca e filtri per tipo e data propri; l'elenco dei tipi mostra solo i tipi presenti per il dispositivo. Comprende le voci scritte dall'introduzione della scheda ed è mostrata agli amministratori autorizzati a leggere l'intero audit log.

> **Nota:** i segreti monouso che viaggiano nei link (token di reimpostazione della password, codici di verifica email) vengono automaticamente oscurati nelle voci di log, così da non essere mai conservati nell'audit trail.

## Sigillatura a prova di manomissione

Oltre a consentire solo aggiunte, l'audit log viene **sigillato** in modo che le manomissioni possano essere rilevate a posteriori:

1. **Catena di hash.** A ogni voce sigillata vengono assegnati un numero di sequenza e un hash calcolato sul contenuto della voce *e* sull'hash della voce precedente (un HMAC con un segreto specifico dell'installazione come chiave). Poiché ogni hash incorpora il precedente, la modifica, la rimozione o il riordino di qualsiasi voce interrompe la catena da quel punto in poi.
2. **Firma crittografica.** Ogni voce sigillata viene inoltre firmata con una chiave Ed25519. La corrispondente **chiave pubblica di verifica** è pubblicata, così chiunque la possieda può verificare una firma senza accesso alla piattaforma.

La sigillatura avviene in background e non blocca né scarta mai una scrittura nel log.

Non è necessario esportare per individuare un problema: una volta sigillata una voce, la sua vista di dettaglio mostra i metadati di sigillatura (numero di sequenza, hash, hash precedente) insieme a un **indicatore di validità dell'hash**. Un segno di spunta verde indica che l'hash ricalcolato della voce corrisponde ancora; un controllo non riuscito viene segnalato direttamente nella console, così che un anello della catena interrotto sia visibile sul posto e non solo al momento dell'esportazione.

> **Cosa dimostra e cosa no.** La sigillatura consente a Lei, o a un revisore esterno, di prendere un lotto **esportato** di voci di log e dimostrare in seguito che non è stato alterato, riordinato o troncato dopo l'esportazione e che è stato firmato da questa piattaforma. È pensata per *esportare i log altrove e dimostrarne l'integrità in un secondo momento*. Non costituisce una garanzia di non ripudio nei confronti dell'operatore della piattaforma.

### Verificare un log esportato

Per verificare in modo indipendente un'esportazione del log:

1. **Esporti le voci.** Recuperi le voci di log (tramite l'API dei log della piattaforma, che include i metadati di sigillatura, ovvero numero di sequenza, hash precedente, hash e firma, accanto al contenuto di ciascuna voce).
2. **Ottenga la chiave pubblica di verifica.** La piattaforma pubblica la chiave pubblica Ed25519 utilizzata per firmare le voci; la recuperi una volta e la conservi.
3. **Verifichi.** La verifica scorre le voci esportate in ordine di sequenza ed esegue tre controlli a livelli:
   - una **pre-scansione strutturale** che conferma che i numeri di sequenza siano contigui e che l'hash precedente registrato in ogni voce corrisponda alla voce precedente (non richiede alcun segreto);
   - un **ricalcolo dell'hash** che ricava nuovamente l'hash di catena di ogni voce dal suo contenuto e lo confronta con il valore memorizzato;
   - un **controllo della firma** che verifica la firma Ed25519 di ogni voce rispetto alla chiave pubblica pubblicata.

   Se le voci sono state alterate, riordinate o ne è stata tagliata la parte finale, uno di questi controlli fallisce e indica il punto esatto.

La console di amministrazione mostra la chiave pubblica pubblicata e l'estremità attuale della catena, così da poter confrontare un'esportazione con il log in tempo reale.

## Cronologia delle modifiche per oggetto

Separatamente dall'audit log centrale, alcuni record conservano una **propria cronologia delle modifiche con versioni**: un prima/dopo a livello di campo di come si è evoluto quel singolo oggetto. Nella pagina di dettaglio di un utente, apra **Visualizza cronologia** per vedere ogni versione con i campi aggiunti, rimossi o modificati (dal vecchio al nuovo valore) e quando.

La utilizzi quando la domanda è *"come è arrivato questo record al suo stato attuale?"*: si legge come una chiara sequenza temporale delle differenze per quell'oggetto. Utilizzi l'audit log centrale quando la domanda è *"chi ha fatto cosa, su tutto, in questa finestra temporale?"*. I due si completano: l'audit log è la registrazione trasversale; la cronologia delle modifiche è la storia del singolo oggetto.

## Conservazione

Il periodo di conservazione delle voci dipende dal livello di abbonamento:

| Livello | Conservazione dell'audit log |
|---|---|
| Trial | 7 giorni |
| Essential | 30 giorni |
| Advanced | 90 giorni |
| Pro | fino a 365 giorni |

Le voci più vecchie vengono rimosse automaticamente una volta superato il periodo di conservazione. Se occorre conservare i record più a lungo di quanto previsto dal proprio livello, li esporti periodicamente: i lotti sigillati esportati restano verificabili a tempo indeterminato. La matrice completa è disponibile in [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md).

## Esportazione

Le voci possono essere esportate tramite l'API dei log della piattaforma per l'archiviazione, l'importazione in un sistema a valle o una verifica indipendente. L'esportazione include il contenuto di ogni voce **e** i relativi metadati di sigillatura, ed è ciò che rende possibile un successivo controllo di integrità.

L'esportazione è **su richiesta**: le voci vengono prelevate quando servono. Non esiste una destinazione di streaming live: la piattaforma non invia un flusso continuo a un raccoglitore di log esterno. Se conserva i record in un sistema esterno, pianifichi un'esportazione periodica ed **esporti sempre prima che le voci escano dal periodo di conservazione del Suo livello** (vedere Conservazione sopra): una volta rimosse, non sono più presenti nel log attivo, anche se ogni lotto sigillato già esportato resta verificabile.

## Argomenti correlati

- [Tipi di evento di audit](https://dts-identity.com/it/docs/reference/audit-event-types.md): il catalogo completo degli eventi registrati.
- [Problemi](https://dts-identity.com/it/docs/monitoring/issues.md): anomalie di sistema ricorrenti, tracciate separatamente.
- [Ciclo di vita dell'utente](https://dts-identity.com/it/docs/directories/user-lifecycle.md): le modifiche di stato degli utenti che compaiono nel log.
