Registro di audit del back-office — Guida completa
Installazione, configurazione e utilizzo del registro di audit del back office: cronologia, confronto prima/dopo, verifica di integrità, impostazioni, avvisi e-mail ed esportazioni.
Presentazione
Il modulo Registro di audit per il back office registra chi ha modificato cosa, e quando: creazioni, modifiche ed eliminazioni di oggetti con il confronto prima/dopo, impostazioni del negozio e dei moduli, moduli installati o disattivati, permessi, accessi riusciti e non riusciti. I segreti non vengono mai memorizzati, i dati personali dei clienti sono ridotti al minimo e una catena di hash permette di verificare che il registro non sia stato riscritto.
Versione 2.0.0, compatibile con PrestaShop 1.7.8, 8 e 9 (PHP da 7.1 a 8.5), singolo negozio o multinegozio, interfaccia in 8 lingue. Nessun override del core.
Il modulo aiuta la tracciabilità. Da solo non rende un negozio conforme a una normativa (GDPR, NIS2, PCI DSS…).
Installazione
- Apri Moduli > Gestione moduli, fai clic su Carica un modulo e trascina l’archivio ZIP.
- Compare il menu Parametri Avanzati > Registro di audit, con quattro schede: Registro, Dashboard, Integrità, Impostazioni.
- La preimpostazione Consigliato è attiva: non serve altro per iniziare.
All’installazione, il modulo viene attivato in tutti i negozi e assegna a tutti i profili il permesso «visualizza» sul modulo stesso. Su PrestaShop 1.7.8, senza questo permesso, PrestaShop non esegue gli hook del modulo per i dipendenti del profilo e le loro azioni non verrebbero registrate. Questo permesso non dà accesso al registro, che ha un proprio permesso.
Aggiornamento dalla versione 1.0.0
Carica il nuovo ZIP come per un’installazione, poi avvia l’aggiornamento. Voci e impostazioni vengono conservate. I segreti che la 1.0.0 poteva aver memorizzato (chiavi webservice, token negli URL, valori di impostazioni segrete) vengono mascherati durante l’aggiornamento. Le voci della 1.0.0 sono contrassegnate come «non sigillate»: non fanno parte della catena di hash. Un modulo disattivato resta disattivato.
Il registro
La scheda Registro presenta una cronologia per giorno. Ogni voce si legge come una frase («Thomas Petit ha modificato “T-shirt colibrì” (prodotto)»), con l’ora, l’indirizzo IP, il negozio, l’origine (back office, webservice, riga di comando…) e i campi modificati. Una barra arancione segnala le azioni sensibili.

Le scorciatoie in alto filtrano con un clic: tutte le modifiche, accessi e sessioni, impostazioni, moduli, permessi, eventi del registro, azioni sensibili. Altri filtri mostra dipendente, tipo di oggetto, azione, periodo, indirizzo IP, origine, importanza e negozio. La ricerca riguarda nomi, riferimenti, e-mail, campi e valori (tranne i valori mascherati).

Vista dettagliata
Dettagli apre la voce: chi (autore, e-mail, profilo, origine), dove e come (oggetto, negozio, IP, pagina, browser), poi il confronto campo per campo. Ogni lingua e ogni negozio ha la sua riga; nei testi lunghi, le parole rimosse sono barrate in rosso e quelle aggiunte evidenziate in verde. Un valore segreto o personale mascherato è indicato da un lucchetto. I pulsanti aprono l’oggetto e la sua cronologia completa; la sezione «Stessa richiesta» elenca le altre voci della stessa azione.

Cronologia nelle schede
Le schede prodotto (scheda Moduli), ordine e cliente mostrano le ultime voci dell’oggetto, con un link alla cronologia completa. Il blocco compare solo per i dipendenti che hanno accesso al registro.

Cosa viene registrato
- Oggetti: oltre 45 tipi (prodotti, combinazioni, prezzi specifici, magazzino, categorie, ordini e cambi di stato, pagamenti, note di credito, clienti, indirizzi, regole carrello, corrieri, tasse, paesi, lingue, pagine, dipendenti, profili, chiavi webservice, query SQL, negozi…). Puoi aggiungere classi di altri moduli.
- Impostazioni: a ogni form del back office che modifica qualcosa, la configurazione viene confrontata prima e dopo, comprese le pagine di configurazione dei moduli.
- Moduli: installazione, disinstallazione, attivazione, disattivazione, aggiornamento.
- Permessi: Team > Permessi, permessi delle chiavi webservice, cambio di profilo di un dipendente.
- Accessi: riusciti, non riusciti (l’identificativo viene conservato solo se ha la forma di un indirizzo e-mail), disconnessioni (1.7.8 e 8) e sessioni terminate (9); «accesso come cliente» con il modulo dfconnectas.
- Operazioni massive: oltre la soglia di raggruppamento (25 per impostazione predefinita), la stessa azione su molti oggetti diventa un’unica voce con il numero, gli identificatori e i campi modificati. Vengono registrate anche le operazioni dei moduli dfbulkfeature e dfspecificpricecleaner.
Cosa non viene rilevato
- le scritture SQL dirette eseguite da altri moduli (tranne i due moduli citati);
- le impostazioni modificate da riga di comando, da un’attività cron o tramite webservice;
- i client dell’API di amministrazione di PrestaShop 9.
Dashboard
Azioni degli ultimi 7 giorni, modifiche ed eliminazioni, accessi non riusciti (24 h e 7 giorni), azioni sensibili, grafico dell’attività su 30 giorni (un clic su una colonna apre la giornata), dipendenti più attivi, oggetti più modificati, stato della protezione (ultima verifica, avvisi, dimensione del registro) e ultime azioni sensibili. Alcuni avvertimenti segnalano un profilo o un negozio che sfuggirebbe al registro.

Integrità
Ogni voce contiene l’impronta SHA-256 della precedente. Verifica ora ricalcola l’intera catena a lotti e segnala una voce modificata, eliminata o inserita, con un link a ciascuna voce interessata. Anche la verifica viene registrata.

- Nessuna voce può essere modificata o eliminata singolarmente dal back office.
- L’unica eliminazione è quella per conservazione, anch’essa registrata; la catena resta verificabile.
- La cancellazione dei dati di un cliente rimuove dei valori ma lascia la catena verificabile; viene segnalata come tale.
Limite: chi ha accesso diretto al database può riscrivere l’intero registro e ricalcolare la catena. Copia l’impronta visualizzata (numero e impronta dell’ultima voce) in un luogo separato e confrontala in seguito, esporta regolarmente, oppure attiva la copia su syslog se i log del tuo server vengono raccolti altrove.
I moduli di backup, di staging e di migrazione copiano le tabelle del registro come tutte le altre: ripristinare un vecchio backup ripristina anche il vecchio registro.
Impostazioni
La scheda Impostazioni inizia con tre preimpostazioni: Leggero (oggetti essenziali, dati personali non registrati, IP troncato, 90 giorni), Consigliato (365 giorni, dati personali parzialmente mascherati) e Completo (tutti gli oggetti, 730 giorni). L’applicazione di una preimpostazione viene annotata nel registro.

Cosa viene registrato
Seleziona i tipi di oggetti e attiva gli eventi: accessi, impostazioni, moduli, permessi, valori degli oggetti creati ed eliminati. Le azioni del back office vengono sempre registrate; webservice e API di amministrazione, riga di comando, front office e attività cron sono opzioni (front office disattivato per impostazione predefinita). Carrelli, visite e statistiche non vengono mai registrati.
Dati personali e segreti
- Dati dei clienti: parzialmente mascherati (j•••@e•••.com, •• •• •• 42), non registrati, oppure completi se hai un’esigenza documentata.
- Cancellazione: quando un cliente viene eliminato, o su richiesta con il modulo psgdpr, i suoi dati personali vengono rimossi dal registro.
- Indirizzo IP del dipendente: completo, troncato (203.0.113.0) o non registrato; browser come opzione.
- Segreti: mai registrati (password e hash, chiavi, token, chiavi webservice, segreti di pagamento e OAuth, credenziali FTP). Puoi aggiungere campi e impostazioni da mascherare, e impostazioni da ignorare.
Conservazione e volume
Periodo di conservazione in giorni (minimo 30, o 0 per illimitato), eliminazione automatica una volta al giorno. La soglia di raggruppamento, il numero di campi per voce e la lunghezza dei valori proteggono il database durante le importazioni.
Accesso ed esclusioni
Il registro è visibile solo ai profili che hanno il permesso sul menu Registro di audit (Team > Permessi): Visualizza per leggere ed esportare, Modifica per le impostazioni, Elimina per applicare la conservazione. Il pulsante Crea un profilo «Revisore (sola lettura)» prepara un profilo dedicato. In multinegozio, un dipendente vede solo le voci dei propri negozi. I dipendenti esclusi non vengono registrati: questa scelta viene a sua volta registrata e non puoi escludere te stesso.
Avvisi e-mail
Attiva gli avvisi e inserisci fino a 10 destinatari. Vengono inviati per gli accessi non riusciti ripetuti (5 in 15 minuti per impostazione predefinita, stessa e-mail o stesso IP), un’eliminazione massiva (20 oggetti in 10 minuti per impostazione predefinita), le modifiche a dipendenti, profili, permessi e chiavi webservice, i moduli installati o attivati/disattivati, un’impostazione segreta modificata, e sempre per una modifica del registro stesso. Ogni avviso viene inviato nella lingua del destinatario, al massimo una volta ogni 15 minuti per lo stesso evento, e non contiene mai valori. Il pulsante Invia un avviso di prova verifica la configurazione e-mail del negozio.

Esportazioni
I pulsanti CSV e JSON del registro esportano le voci visualizzate con i filtri attuali (al massimo 100 000), con i campi modificati e le impronte. I valori mascherati restano mascherati, e le celle CSV che un foglio di calcolo potrebbe interpretare come formule vengono neutralizzate. Ogni esportazione viene registrata.
Disinstallazione
La disinstallazione viene sempre registrata. L’impostazione Alla disinstallazione decide la sorte del registro: Conserva il registro (consigliato: le tabelle restano e una reinstallazione prosegue la stessa catena) oppure Elimina il registro (esportalo prima se potrebbe servirti).
Risoluzione dei problemi
Le azioni di un dipendente non compaiono
Controlla gli avvertimenti della dashboard: dipendente escluso, profilo senza permesso «visualizza» sul modulo (PrestaShop 1.7.8) o negozio in cui il modulo è disattivato.
Una modifica di un’impostazione non compare
Vengono confrontate solo le impostazioni modificate da un form del back office. Verifica anche che l’impostazione non sia nell’elenco delle impostazioni da ignorare.
L’integrità segnala un problema
Apri la voce indicata. Un’eliminazione o una modifica fatta direttamente nel database, o il ripristino di un vecchio backup, interrompe la catena in quel punto. I valori cancellati su richiesta di un cliente non vengono considerati alterazioni.