Audit Log per SaaS B2B: Come Tracciare Chi Ha Modificato Cosa Senza Rallentare l'App

TL;DR · In sintesi (30 sec)
Founder, Product Lead e Team Tecnici7 min

Quando un utente cancella dati o cambia i permessi di un team, supporto e clienti vogliono sapere esattamente chi ha fatto cosa e quando. Una tabella append-only su Postgres risolve il problema senza appesantire l'app.

Tabella append-only di audit log SaaS con autore, azione, risorsa e data

Cos'è un Audit Log (E Perché I Clienti Aziendali Lo Chiedono)

Ogni volta che un membro del team elimina un progetto, cambia un ruolo o esporta una lista contatti in un software B2B, serve una risposta chiara a quattro domande: chi ha agito, quale azione ha fatto, su quale elemento e quando.

Senza uno storico ordinato, risolvere errori umani o superare i questionari di sicurezza dei clienti diventa una caccia al tesoro nei log grezzi del server. Fatto bene, l'audit log lavora in silenzio senza rallentare nessun click.

| Metodo | Sicurezza Storico | Impatto Velocità | Utile per Supporto e Sicurezza? | | :--- | :--- | :--- | :--- | | Log testuali del server | Bassa (scadono presto) | Basso | Difficile filtrare per singolo cliente | | Solo colonna updated_by | Scarsa (sovrascrive la storia) | Nullo | Mostra solo l'ultima modifica | | Tabella Append-Only in DB | Alta (solo inserimenti) | Trascurabile | Storico completo ed esportabile |

I 2 Errori Che Rendono Lenti o Inutili Gli Audit Log

Quasi tutti i problemi di logging nascono da due scelte pratiche sbagliate:

  • Bloccare l'interfaccia aspettando servizi esterni: Se chiami un endpoint di logging esterno in modo sincrono prima di confermare l'azione, l'app rallenta a ogni click.
  • Registrare anche ogni visualizzazione inutile: Loggare ogni lettura di pagina riempie il database di rumore e nasconde gli eventi davvero importanti (role.updated, api_key.created, data.exported).

Schema Pulito Append-Only su Postgres / Supabase

Registra solo gli eventi critici, vieta modifiche/cancellazioni tramite Row Level Security (RLS) e indicizza (tenant_id, created_at DESC):

SQL
-- Storico immutabile isolato per workspace/azienda cliente
CREATE TABLE IF NOT EXISTS public.audit_events (
  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
  tenant_id text NOT NULL,
  actor_id text NOT NULL,
  action text NOT NULL,
  resource_type text NOT NULL,
  resource_id text NOT NULL,
  metadata jsonb NOT NULL DEFAULT '{}'::jsonb,
  created_at timestamptz NOT NULL DEFAULT now()
);

CREATE INDEX IF NOT EXISTS idx_audit_events_tenant_time
  ON public.audit_events (tenant_id, created_at DESC);

ALTER TABLE public.audit_events ENABLE ROW LEVEL SECURITY;

-- Gli admin possono SOLO leggere gli eventi del proprio workspace (mai UPDATE/DELETE)
CREATE POLICY "Admins read own audit logs"
  ON public.audit_events FOR SELECT
  TO authenticated
  USING (tenant_id = (auth.jwt() ->> 'tenant_id'));

Vuoi controllare anche la sicurezza degli header HTTP del tuo sito o vedere come strutturiamo workflow tracciabili? Prova l'Inspector Security Headers o leggi il Case Study sull'Architettura di gabrielcucos.dev.

Checklist Pratica per Partire Bene

  • Parti dagli eventi ad alto impatto: cambi permessi, esportazioni CSV, modifiche fatturazione e webhook.
  • Rendi la tabella append-only: consenti solo INSERT e SELECT, mai UPDATE o DELETE sugli eventi passati.
  • Pianifica l'archiviazione: sposta i log più vecchi di 12–24 mesi su storage economico invece di tenerli tutti sul DB principale.

Vuoi mettere in sicurezza dati, permessi RLS o flussi automatici sul tuo prodotto? Richiedi una Diagnosi Gratuita entro 48h.

Prossimo Passo Pratico

Vuoi applicare questo sistema nel tuo business?

Che tu gestisca un'azienda o un team marketing/tech, condividi il sito e il tuo collo di bottiglia: entro 48 ore ricevi un piano d'azione chiaro.

COME È STRUTTURATA QUESTA GUIDA

Scritta a livelli progressivi: sintesi immediata in alto per chi non è sviluppatore, seguita da esempi pratici, tabelle comparative e dettagli tecnici sotto per chi vuole implementare.