Registrazione degli audit
In questa pagina
DefectDojo registra una cronologia di controllo (audit trail) delle modifiche ai propri dati. Ogni oggetto monitorato registra automaticamente eventi di create, update e delete, e le tabelle di relazione (molti-a-molti) registrano eventi di add e remove.
Come funziona
Il tracciamento degli audit รจ guidato da trigger di database registrati per ciascun modello. Per ogni oggetto monitorato, possono scattare tre tipi di evento:
| Tipo di evento | Quando scatta | Azione |
|---|---|---|
InsertEvent | Viene creato un nuovo record | Create |
UpdateEvent | Un record cambia โ solo quando il valore di un campo reale cambia effettivamente | Update |
DeleteEvent | Un record viene eliminato | Delete |
Le tabelle di relazione molti-a-molti (tag, revisori, intervalli IP del firewall) tracciano
solo add (InsertEvent) e remove (DeleteEvent) โ non esiste un
“update” per una riga di relazione.
Cosa viene acquisito con ogni evento
- Who โ l’utente che ha eseguito l’azione, ricavato dal contesto della richiesta.
- When โ un timestamp.
- Source IP โ l’indirizzo remoto, rispettando le catene di proxy
X-Forwarded-For. - Before/after snapshot โ i valori completi dei campi del record.
- Context / label โ raggruppa gli eventi originati dalla stessa richiesta. L’etichetta
initial_backfillcontrassegna i record storici importati quando il tracciamento รจ stato attivato per la prima volta.
Gli eventi prodotti dai job in background vengono ricollegati al contesto della richiesta di origine, cosรฌ un’azione completata in modo asincrono viene comunque attribuita all’utente che l’ha avviata.
Core (Open Source) โ azioni monitorate
| Oggetto | Create | Update | Delete | Note |
|---|---|---|---|---|
| Utente | โ | โ | โ | password esclusa dagli snapshot |
| Tipo di prodotto | โ | โ | โ | |
| Prodotto | โ | โ | โ | |
| Engagement | โ | โ | โ | |
| Test | โ | โ | โ | |
| Riscontro | โ | โ | โ | |
| Gruppo di Riscontri | โ | โ | โ | |
| Modello di Riscontro | โ | โ | โ | |
| Accettazione del rischio | โ | โ | โ | |
| Endpoint | โ | โ | โ | |
| Posizione | โ | โ | โ | |
| URL | โ | โ | โ | |
| Webhook di Notifica | โ | โ | โ | header_name / header_value esclusi (segreti) |
Core โ eventi di relazione (add / remove)
| Relazione | Add | Remove |
|---|---|---|
| Riscontro โ Revisori | โ | โ |
| Riscontro โ Tag | โ | โ |
| Riscontro โ Tag ereditati | โ | โ |
| Prodotto โ Tag | โ | โ |
| Engagement โ Tag | โ | โ |
| Engagement โ Tag ereditati | โ | โ |
| Test โ Tag | โ | โ |
| Test โ Tag ereditati | โ | โ |
| Endpoint โ Tag | โ | โ |
| Endpoint โ Tag ereditati | โ | โ |
| Modello di Riscontro โ Tag | โ | โ |
| App Analysis (Technology) โ Tag | โ | โ |
| Objects/Product โ Tag | โ | โ |
Pro โ azioni monitorate
| Oggetto | Create | Update | Delete | Note |
|---|---|---|---|---|
| Enhanced Finding | โ | โ | โ | Companion Pro del Riscontro |
| Regola | โ | โ | โ | Motore delle regole |
| Azione della regola | โ | โ | โ | |
| Condizione dell’azione della regola | โ | โ | โ | |
| Voce di filtro della regola | โ | โ | โ | |
| Operazione del motore delle regole | โ | โ | โ | |
| Messaggio dell’operazione del motore delle regole | โ | โ | โ | |
| Attivitร pianificata | โ | โ | โ | |
| Esecuzione dell’attivitร pianificata | โ | โ | โ | |
| Policy di mitigazione | โ | โ | โ | |
| Impostazione configurabile | โ | โ | โ | Modifiche alla configurazione di sistema |
| Stato Feature Flag | โ | โ | โ | Attivazione/disattivazione flag + pin di sistema |
| Definizione Feature Flag | โ | โ | โ | Sincronizzazione di metadata / registro |
| Cloud Firewall | โ | โ | โ | campo locked escluso |
| Maschera IP Firewall | โ | โ | โ |
Pro โ RBAC / permessi
| Oggetto | Create | Update | Delete |
|---|---|---|---|
| Gruppo | โ | โ | โ |
| Ruolo | โ | โ | โ |
| Appartenenza al gruppo | โ | โ | โ |
| Ruolo globale | โ | โ | โ |
| Assegnazione gruppo al prodotto | โ | โ | โ |
| Assegnazione gruppo al tipo di prodotto | โ | โ | โ |
| Membro del prodotto | โ | โ | โ |
| Membro del tipo di prodotto | โ | โ | โ |
Pro โ eventi di relazione (add / remove)
| Relazione | Add | Remove |
|---|---|---|
| Cloud Firewall โ Intervalli IP | โ | โ |
Configurazione e conservazione (On-Premise Controls)
| Impostazione | Variabile d’ambiente | Predefinito | Effetto |
|---|---|---|---|
| Abilita la registrazione degli audit | DD_ENABLE_AUDITLOG | True | Quando รจ False, tutti i trigger di cronologia sono disabilitati e nessun evento viene registrato |
| Periodo di conservazione | DD_AUDITLOG_FLUSH_RETENTION_PERIOD | -1 (mai eliminare) | Mesi di cronologia da conservare; gli eventi piรน vecchi vengono eliminati in blocco dal job di pulizia |
| Dimensione del batch di pulizia | DD_AUDITLOG_FLUSH_BATCH_SIZE | 1000 | Righe eliminate per batch durante la pulizia |
| Numero massimo di batch di pulizia | DD_AUDITLOG_FLUSH_MAX_BATCHES | 100 | Limite al numero di batch per ogni esecuzione di pulizia |
Note e limitazioni
- I segreti non vengono mai acquisiti. Le password degli utenti e i valori degli header dei webhook di notifica sono esplicitamente esclusi dagli snapshot degli eventi.
- Gli update vengono registrati solo in caso di modifica reale. Un salvataggio che non altera alcun
valore di campo non produce alcun evento di update; i campi gestiti automaticamente come
il solo
last_updatednon ne fanno scattare uno. - Gli eventi di autenticazione non vengono acquisiti qui. Solo le modifiche ai dati. Le attivitร di login, logout e tentativo di accesso fallito sono gestite separatamente e non fanno parte di questo log di audit.