Skip to main content
Questa guida ti accompagna da zero al tuo primo evento di audit a prova di manomissione. Creerai un account gratuito, otterrai una chiave API, installerai l’SDK per il tuo linguaggio e invierai un evento reale che potrai ispezionare subito nella dashboard di AuditRails. L’intero processo richiede circa cinque minuti.
1

Crea il tuo account gratuito

Vai su app.auditrails.io/register e registrati per un account gratuito. Ottieni una prova gratuita di 30 giorni senza carta di credito richiesta — accesso completo alla piattaforma fin dal primo giorno.
Il tuo account parte con il piano Starter Trails. Puoi effettuare l’upgrade in qualsiasi momento da Dashboard → Fatturazione senza perdere i dati di log esistenti.
2

Crea una chiave API

Ogni evento viene autenticato con una chiave API associata a un progetto. Per crearne una:
  1. Apri la Dashboard di AuditRails.
  2. Vai su Chiavi API nella barra laterale sinistra.
  3. Clicca Crea chiave API, assegnale un nome (es. my-app-dev) e seleziona il progetto a cui associarla.
  4. Copia subito la chiave — inizia con at_live_... ed è mostrata una sola volta.
AuditRails memorizza solo un hash SHA-256 della tua chiave, mai il valore in chiaro. Se la perdi, dovrai revocarla e crearne una nuova. Salvala subito in un secrets manager o in una variabile d’ambiente.
3

Installa l'SDK (o salta questo passaggio)

Ogni SDK è un sottile wrapper su un singolo endpoint HTTP, quindi la scheda curl qui sotto funziona in qualsiasi linguaggio già oggi ed è pienamente supportata. Niente in questa guida rapida richiede un SDK.
4

Registra il tuo primo evento

Invia un evento user.login. Sostituisci at_live_... con la chiave copiata al passaggio 2.La scheda curl è l’intera interfaccia: ogni SDK sottostante avvolge esattamente questa richiesta, quindi è il modo più veloce per confermare che la tua chiave funzioni prima di aggiungere una dipendenza.
L’SDK associa automaticamente un log_id (ULID), il tuo tenant_id e un timestamp preciso a ogni evento prima che venga sottoposto a hash e archiviato. Non è mai necessario impostarli manualmente.
5

Visualizza il tuo evento nella dashboard

Apri Dashboard → Log. Il tuo evento user.login dovrebbe comparire entro pochi secondi. Clicca su una riga qualsiasi per ispezionare:
  • Il payload completo dell’evento e i metadati
  • L’hash SHA-256 calcolato e la sua posizione nella catena
  • Il collegamento all’hash precedente che dimostra l’integrità della catena
  • La conferma di archiviazione WORM e la data di scadenza della conservazione

Prossimi passi

Concetti fondamentali

Comprendi progetti, eventi, catene di hash, livelli di archiviazione e politiche di conservazione.

Autenticazione

Scopri i formati delle chiavi API, le best practice di sicurezza e i codici di errore.

Riferimento API

Esplora ogni endpoint e campo del riferimento completo dell’API REST.

Guide alla conformità

Scopri come AuditRails soddisfa DORA, GDPR, NIS2, l’EU AI Act e gli altri quattro framework supportati.