Vai al contenuto principale
ShieldID

Activity Ledger

Ogni consultazione. Ogni clic. Agli atti.

L'Activity Ledger è un registro di sola aggiunta di tutto ciò che accade intorno a una verifica: chi ha effettuato l'accesso, chi ha aperto un link, che cosa ha deciso il motore, chi ha esportato che cosa. Le voci possono essere aggiunte, mai modificate o eliminate. Né da Lei, né da noi.

Provi il ledger di esempioRiferimento API

Il ledger qui descritto è il registro di governance che oggi gestisce Trust Ledger e che sta per essere esteso agli account API di ShieldID. Tutto ciò che non è ancora registrato per le verifiche dell'identità è contrassegnato come Prossimamente in questa pagina.

Perché è importante

Una verifica senza registrazione è solo un'opinione.

Usare un servizio di identità comporta un rischio specifico: qualcuno deve rispondere di chi ha visto il documento d'identità del candidato e di che cosa ne è stato fatto. Il registro è il modo per rispondere.

Per Lei

Dimostri che cosa è accaduto, in ordine, con l'esito. Quando una decisione viene contestata a distanza di mesi, il registro è la prova, e sopravvive alle immagini dei documenti d'identità.

Per il Suo responsabile della conformità

Risponda a una richiesta sulla privacy o a un audit con un'esportazione filtrata anziché con una settimana di email. Ogni esportazione è a sua volta una voce.

Per i Suoi candidati

Ogni visualizzazione e download di un documento archiviato lascia una voce, così a «chi ha visto il mio fascicolo?» l'azienda può dare una risposta. Gli eventi per singola immagine delle foto dei documenti e una visualizzazione self-service per i candidati saranno disponibili a breve.

Cosa registra

Il vocabolario degli eventi, per intero.

Ogni voce utilizza uno di questi nomi, quindi un filtro ha sempre lo stesso significato. I nomi sono mostrati come appaiono nel ledger.

Accesso e autenticazione

Ogni via d'ingresso all'account e ogni sguardo dietro le quinte.

LOGIN_2FA_CHALLENGED
Un accesso raggiunge il passaggio a due fattori.
LOGIN_SUCCESS
Un accesso viene completato.
FORENSIC_DETAIL_ACCESSED
Qualcuno apre le prove di rete e dispositivo dietro una voce. È richiesta una motivazione scritta e la richiesta stessa viene registrata.

Richieste di verifica

Il percorso del candidato, dal link al consenso.

SIGN_LINK_OPENED
Il candidato apre il proprio link di verifica.
EULA_ACCEPTED
Il candidato accetta i termini prima di proseguire.
TASK_CREATED / TASK_SENT
Una richiesta di verifica viene creata e inviata, da una persona o da una chiave API.
TASK_VIEWED / TASK_VOIDED
Una richiesta viene recuperata o annullata tramite l'API.

Registri ed esportazioni

Tutto ciò che lascia l'account lascia una traccia.

DOCUMENT_VIEWED
Un documento archiviato viene aperto nel portale.
DOCUMENT_DOWNLOADED
Un documento viene scaricato, nel portale o tramite l'API.
DOCUMENT_EMAILED
Un documento viene inviato per email a un destinatario.
AUDIT_EXPORTED
Una traccia di audit viene recuperata tramite l'API. Anche la lettura del registro viene registrata.

Account e API

Impostazioni e credenziali, con l'attore associato.

SETTING_CHANGED
Un'impostazione dell'account viene modificata tramite l'API.
SESSION_CREATED / SESSION_REVOKED
Una sessione API viene aperta o revocata.
ACCOUNT_MAILING_ADDRESS_UPDATED / BILLING_ADDRESS_UPDATED
I dettagli dell'account cambiano.

Cronologia della richiesta (per singola richiesta, accanto al registro)

Ogni richiesta ha anche una propria cronologia. È un registro di lavoro, non il ledger di sola aggiunta, perciò la indichiamo separatamente.

BIOMETRIC_VERIFIED / BIOMETRIC_FAILED
Il motore di verifica segnala che il controllo d'identità è stato superato o non superato, indicando il controllo fallito.
RETENTION_PURGE / RETENTION_PURGE_FAILED
La pulizia per conservazione elimina i documenti archiviati di una richiesta al termine del suo periodo, oppure non riesce a farlo.
GDPR_ERASURE
Le informazioni personali vengono oscurate a seguito di una richiesta di cancellazione.

In arrivo

Prossimamente

Gli eventi che chiudono il cerchio specificamente per la verifica dell'identità. Li elenchiamo perché possa farci riferimento.

ID_IMAGE_VIEWED / ID_IMAGE_DOWNLOADED
Ogni volta che un'immagine del documento d'identità o un selfie viene aperto o scaricato, e da chi.
DECISION_RECORDED
L'accettazione o il rifiuto che il Suo team registra per una verifica, con la motivazione.
API_KEY_CREATED / API_KEY_REVOKED
Eventi del ciclo di vita delle chiavi come voci del registro. Oggi sono archiviati con la chiave, non come voci.
VERIFICATION_VERIFIED / VERIFICATION_FAILED
Esiti delle verifiche come voci del registro di sola aggiunta per gli account API di ShieldID. Oggi vengono scritti nella cronologia della richiesta.
IMAGE_PURGED
Una ricevuta per ogni eliminazione automatica delle immagini dei documenti d'identità.
Applicant view
Una pagina self-service in cui la persona verificata vede chi ha avuto accesso alla propria verifica.
CSV export
Un'esportazione filtrata per i revisori, in un foglio di calcolo. Oggi esiste l'esportazione JSON.

Anatomia di una voce

Quattordici campi, ogni volta. Poi le prove, su richiesta.

Una voce indica chi, che cosa, su che cosa, con quale risultato, in parole semplici e in forma leggibile da macchina. Le prove di rete e dispositivo si trovano accanto, dietro una richiesta registrata.

La voce

Tipo di attore
Persona, firmatario, sistema, amministratore o chiave API. Le azioni di una chiave API riportano l'id della chiave stessa, così uno script e una persona non vengono mai confusi.
Etichetta dell'attore
Il nome o l'email com'erano in quel momento, non una ricerca in tempo reale che cambia quando le persone se ne vanno.
Azione
Il nome dell'evento, tratto dal vocabolario fisso sopra riportato.
Categoria e gravità
Autenticazione, documento, firma, attività, account, sicurezza o sistema; da info a critico.
Destinazione
L'oggetto su cui è stata eseguita l'azione: una verifica, un documento, una persona, un'impostazione.
Riepilogo
Una frase in linguaggio umano, scritta al momento dell'azione.
Esito
Riuscita, fallita o negata. Un'azione rifiutata viene registrata con la stessa evidenza di una riuscita.
Metadati
Dettagli strutturati: etichetta della chiave API, ambiente (sandbox o produzione), id della richiesta e altro.
Data e ora
Ora del server, in sequenza, mai modificabile.

Le prove, dietro una richiesta registrata

Indirizzo IP e ambito
Pubblico, NAT carrier-grade, privato, loopback o sconosciuto, così che chi effettua la revisione sappia quanta fiducia accordargli.
Operatore di rete
DNS inverso, intestatario, ASN e indicazione se l'indirizzo appartiene a un provider di hosting.
Posizione
Paese, regione, città e codice postale, con il raggio di accuratezza e l'indicazione se i dati fossero obsoleti.
Dispositivo
Un breve elenco di segnali come fuso orario, dimensioni dello schermo, piattaforma e lingue, ridotto a un'impronta SHA-256 stabile. Nessun dump grezzo del browser.
Indirizzo dichiarato
Ciò che il browser stesso ha dichiarato, contrassegnato come non verificato.

Le evidenze vengono arricchite dopo l'invio della risposta, mai sul percorso critico del richiedente, e sono contrassegnate come non arricchite finché non arrivano.

Evidenza di manomissione

Non lo chiamiamo blockchain, perché non lo è. È una tabella che il database si rifiuta di far modificare a chiunque.

Parole semplici su ciò che protegge il registro, così il Suo revisore può confrontare le nostre affermazioni con il nostro comportamento.

  • Solo aggiunta, garantita dal database

    Un trigger sulla tabella di governance genera un errore a ogni aggiornamento o eliminazione. Il codice applicativo, gli amministratori e noi stessi vi siamo soggetti.

  • Una sola eccezione, circoscritta e registrata

    Quando un account viene eliminato, le sue voci vengono scollegate dall'account anziché cancellate, e solo se ogni altra colonna è identica byte per byte. Nulla viene troncato.

  • Le scritture passano da una funzione protetta

    Le voci sono scritte da una funzione del database con privilegi definiti, dopo un incidente reale in cui la sicurezza a livello di riga ha scartato le scritture senza alcun avviso. La correzione è il motivo per cui la funzione esiste.

  • Leggere le prove è un evento

    I dettagli di rete e dispositivo non possono essere letti senza una motivazione scritta di almeno dodici caratteri, registrata a nome di chi legge come FORENSIC_DETAIL_ACCESSED.

  • L'eliminazione delle immagini non intacca il registro

    Le immagini dei documenti d'identità vengono eliminate dopo un breve intervallo. Le voci del registro sono una documentazione separata, priva di collegamento con le immagini: eliminare un'immagine non rimuove mai la voce che descrive che cosa le è accaduto.

Ricerca e filtri

Lo interroghi come un database, perché lo è.

Ogni filtro viene convalidato lato server e limitato al Suo account. Gli elenchi dei filtri mostrano solo valori effettivamente presenti, così non cercherà mai il nulla.

Attore
Una persona, oppure una chiave API tramite il suo id. Isoli tutto ciò che ha fatto una singola integrazione.
Destinazione
Una verifica, un documento o una persona. Tutto ciò che è accaduto al fascicolo di questo candidato.
Azione
Qualsiasi nome di evento del vocabolario.
Categoria, gravità, esito
Solo eventi di sicurezza, solo errori, solo azioni negate.
Intervallo di date
Da e a, al secondo.
Testo libero
Tra riepiloghi, etichette degli attori, etichette dei bersagli e azioni. Volutamente mai tra i metadati grezzi.

Oggi l'esportazione è in JSON: la traccia completa di una verifica tramite l'API, limitata a cinquecento righe, con ogni recupero registrato come AUDIT_EXPORTED. L'esportazione CSV per i clienti sarà disponibile a breve.

Provi

Un registro di esempio, fittizio e ricercabile.

Filtri, espanda una riga, apra le prove. I nomi e gli eventi qui sotto sono inventati per la demo; l'insieme dei campi e il comportamento sono reali.

Activity Ledger

Dati di esempio

Visualizzate: 18 voci.

  • 2026-09-16 · 13:41:22

    LOGIN_2FA_CHALLENGED

    Wren Halloway · Accesso al portale

    Success

  • 2026-09-16 · 13:41:58

    LOGIN_SUCCESS

    Wren Halloway · Accesso al portale

    Success

  • 2026-09-16 · 14:02:10

    SESSION_CREATED

    Widget di onboarding (produzione) · Sessione API 4a81

    Success

  • 2026-09-16 · 14:02:11

    TASK_CREATED

    Widget di onboarding (produzione) · Verifica per Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 14:19:47

    SIGN_LINK_OPENED

    Ottoline Marchetti-Fife · Link di verifica 7c19

    Success

  • 2026-09-16 · 14:20:12

    EULA_ACCEPTED

    Ottoline Marchetti-Fife · Consenso alla verifica

    Success

  • 2026-09-16 · 14:22:35

    BIOMETRIC_VERIFIED

    Motore di verifica · Verifica per Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 14:22:39

    TASK_VIEWED

    Widget di onboarding (produzione) · Verifica per Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 15:07:03

    DOCUMENT_VIEWED

    Desmond Quillfeather · Risultato per Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 15:08:44

    DOCUMENT_DOWNLOADED

    Desmond Quillfeather · Risultato per Ottoline Marchetti-Fife

    Success

  • 2026-09-15 · 11:52:18

    SIGN_LINK_OPENED

    Barnaby Thistlewood · Link di verifica 3e77

    Success

  • 2026-09-15 · 11:55:02

    BIOMETRIC_FAILED

    Motore di verifica · Verifica per Barnaby Thistlewood

    Failure

  • 2026-09-15 · 16:30:55

    FORENSIC_DETAIL_ACCESSED

    Perpetua Nakashima · Evento evt-0012

    Success

  • 2026-09-15 · 09:14:31

    SESSION_CREATED

    Ines Valcourt-Brie · Chiave API: Billing sync (sandbox)

    Success

  • 2026-09-14 · 17:45:09

    SESSION_REVOKED

    Ines Valcourt-Brie · Chiave API: Legacy import (production)

    Success

  • 2026-09-14 · 10:22:47

    SETTING_CHANGED

    Clementine Ashgrove · Periodo di conservazione

    Success

  • 2026-09-14 · 10:31:12

    AUDIT_EXPORTED

    Clementine Ashgrove · Esportazione del registro attività, dal 1° agosto al 14 settembre

    Success

  • 2026-09-14 · 03:00:04

    RETENTION_PURGE

    Eliminazione per scadenza della conservazione · 41 verifiche oltre il periodo di conservazione

    Success

Domande

Risposte chiare sul registro.

La veda con i Suoi dati

Esegua una verifica in sandbox. Poi legga ciò che ha scritto.

Il modo più rapido per capire il registro è creare una voce al suo interno. Le sessioni sandbox non vengono mai fatturate.

Inizi gratis nella sandboxPrenoti una demo