Vai al contenuto principale
Blocklist impediscono agli utenti che non hanno superato i tuoi controlli di compliance di creare nuove sessioni o eseguire nuove transazioni. Didit supporta le blocklist per tipo di identificatore, così puoi bloccare lo stesso soggetto a rischio su più dati (volto, documento, email, telefono, vendor_data dell’utente).

​
Tipi di identificatore supportati per gli Utenti

Ogni tipo di identificatore viene applicato nel punto naturale di contatto:
  • Volto e documento: applicati durante una nuova sessione.
  • Email e telefono: applicati durante un passaggio della sessione che li raccoglie, oppure nel payload di una transazione.
  • IP e dispositivo: applicati durante l’Analisi dispositivo e IP in una sessione.
  • vendor_data dell’utente: applicato durante la creazione di una sessione o di una transazione.

​
Come avviene l’inserimento in blocklist

Una sessione rifiutata non inserisce nessuno in blocklist. La sessione termina con stato Declined, l’Utente resta ACTIVE e non viene scritta alcuna voce in lista, quindi la stessa persona può avviare un’altra sessione. L’inserimento in blocklist è un passaggio manuale: aggiungi la voce dalla pagina Blocklist oppure con la Lists API. Una voce di tipo USER (il vendor_data dell’utente) imposta anche lo stato dell’Utente su BLOCKED.
1

Automatico: in caso di corrispondenza con la blocklist

Quando una sessione in arrivo corrisponde a una voce esistente nella blocklist, la sessione viene rifiutata automaticamente con un codice motivo come blocked_face, blocked_document, blocked_email e simili.
2

Manuale: dalla console

Un analista inserisce un utente nella blocklist da Utenti → [utente] → Azioni → Aggiungi alla blocklist, scegliendo uno o più identificatori da acquisire.
3

Programmatico: tramite la Lists API

Usa la Lists API per aggiungere voci in modo programmatico. È la stessa API che la console utilizza internamente.

​
Liste di sistema e liste personalizzate

Ogni applicazione dispone di blocklist di sistema, una per tipo di identificatore, che Didit gestisce automaticamente. Non puoi rinominarle né eliminarle. Le liste personalizzate sono tue: le crei, le nomini e ne definisci l’ambito.

​
Aggiungere un utente alla blocklist tramite API

Usa la Lists API per aggiungere una voce in blocklist. Per bloccare un utente tramite vendor_data, aggiungi una voce di tipo USER alla blocklist corrispondente:
  1. Elenca tutte le liste filtrando per entry_type=user e is_system=true, per trovare la System User Blocklist.
  2. Crea una voce in quella lista, con value impostato sul vendor_data dell’utente.
Per bloccare un utente tramite il volto, consulta Volti e biometria. Per bloccare tramite email, telefono, documento o IP, usa la blocklist di sistema corrispondente con l’identificatore appropriato in value.

​
Flusso di applicazione delle regole

Per le blocklist di volti e documenti, il controllo avviene nel passaggio di verifica:

​
Rimuovere dalla blocklist

  • Console: Blocklist → [tipo] → azioni sulla riga → Rimuovi.
  • API: usa l’endpoint Elimina voce con l’UUID della lista e l’UUID della voce.
Rimuovere la voce non riporta automaticamente l’utente allo stato ACTIVE. Se vuoi consentire nuove sessioni, usa PATCH /v3/users/{vendor_data}/update-status/ per modificare lo stato.

​
Registro di audit della blocklist

Ogni aggiunta o rimozione in una blocklist viene registrata nel registro di audit:
  • Chi ha aggiunto la voce (email dell’utente oppure 'system', 'api').
  • Quando.
  • Il comment facoltativo che spiega il motivo.
  • La sessione o transazione collegata, se la voce è stata generata automaticamente.

​
Prossimi passi

Lists API

Riferimento completo dell’API per blocklist e allowlist.

Blocklist in console

Gestisci le blocklist dall’interfaccia.

Volti e biometria

Come funzionano le blocklist dei volti.
Ultima modifica il 7 novembre 2026