> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Llista de bloqueig d'usuaris: cares, documents, correus

> Com Didit aplica els bloquejos sobre les entitats d'usuari: els tipus d'identificadors, com es comprova un bloqueig i com s'afegeix o s'elimina una entrada.

Les llistes de bloqueig impedeixen que els usuaris que no han superat les teves comprovacions de compliment creïn noves sessions o executin noves transaccions. Didit admet llistes de bloqueig per **tipus d'identificador**, de manera que pots bloquejar el mateix actor maliciós en diversos punts de dades (rostre, document, correu electrònic, telèfon, vendor\_data de l'usuari).

## Tipus d'identificadors compatibles amb els usuaris

| Tipus | Clau | Coincideix quan… |
| - | - | - |
| Rostre | `FACE` | La selfie de prova de vida d'una sessió nova coincideix amb el rostre bloquejat |
| Número de document | `DOCUMENT` | Una nova presentació d'un document d'identitat coincideix amb el número de document bloquejat |
| Correu electrònic | `EMAIL` | Una sessió o transacció nova utilitza el correu electrònic bloquejat |
| Telèfon | `PHONE` | Una sessió o transacció nova utilitza el telèfon bloquejat |
| Adreça | `IP_ADDRESS` | L'adreça del remitent coincideix; admet IP úniques (`1.2.3.4`) i rangs CIDR (`10.0.0.0/8`) |
| Empremta digital del dispositiu | `DEVICE_FINGERPRINT` | L'empremta digital del dispositiu del remitent coincideix |
| Usuari | `USER` | La sessió o transacció utilitza el `vendor_data` bloquejat |

Cada tipus d'identificador s'aplica en el punt de contacte natural:

* Rostre i document: s'apliquen durant una sessió nova.
* Correu electrònic i telèfon: s'apliquen durant un pas de la sessió que els recull, o en el payload d'una transacció.
* IP i dispositiu: s'apliquen durant l'Anàlisi de dispositiu i IP en una sessió.
* vendor\_data de l'usuari: s'aplica en crear la sessió o la transacció.

## Com es produeix el bloqueig

> [!NOTE]
>
> Una sessió rebutjada no bloqueja ningú. La sessió acaba com a `Declined`, l'usuari continua `ACTIVE` i no s'escriu cap entrada a la llista, de manera que la mateixa persona pot iniciar una altra sessió. El bloqueig és un pas manual: afegeix l'entrada des de la [pàgina de llista de bloqueig](https://docs.didit.me/ca/console/blocklist-users.md) o amb la [Lists API](https://docs.didit.me/ca/management-api/lists/overview.md). Una entrada `USER` (el `vendor_data` de l'usuari) també canvia l'estat de l'usuari a `BLOCKED`.

**1. Automàtic: en coincidir amb la llista de bloqueig**

Quan una sessió entrant coincideix amb una entrada existent de la llista de bloqueig, la sessió es rebutja automàticament amb un codi de motiu com `blocked_face`, `blocked_document`, `blocked_email`, etc.

**2. Manual: des de la consola**

Un analista bloqueja un usuari des de *Users → \[user] → Actions → Add to blocklist*, triant un o més identificadors que cal capturar.

**3. Programàtic: mitjançant la Lists API**

Utilitza la [Lists API](https://docs.didit.me/ca/management-api/lists/overview.md) per afegir entrades de manera programàtica. És la mateixa API que utilitza la consola internament.

## Llistes del sistema i llistes personalitzades

Cada aplicació té **llistes de bloqueig del sistema**, una per tipus d'identificador, que Didit gestiona automàticament. No pots canviar-les de nom ni eliminar-les. Les llistes personalitzades són teves: les pots crear, anomenar i delimitar.

| Llista | Creada per | Descripció |
| - | - | - |
| System Face Blocklist | Didit | Llista de bloqueig canònica de rostres per a l'aplicació |
| System Document Blocklist | Didit | Llista de bloqueig canònica de números de document |
| System Email Blocklist | Didit | Llista de bloqueig canònica de correus electrònics |
| System Phone Blocklist | Didit | Llista de bloqueig canònica de telèfons |
| System User Blocklist | Didit | Identificadors `vendor_data` bloquejats |
| Llistes de bloqueig personalitzades | Tu | Llistes delimitades, per exemple per regió, per soci o per nivell de risc |

## Afegir un usuari a la llista de bloqueig mitjançant l'API

Utilitza la [Lists API](https://docs.didit.me/ca/management-api/lists/overview.md) per afegir una entrada de llista de bloqueig. Per bloquejar un usuari pel seu `vendor_data`, afegeix una entrada de tipus USER a la llista de bloqueig corresponent:

1. [Llista totes les llistes](https://docs.didit.me/ca/management-api/lists/list.md) filtrant per `entry_type=user` i `is_system=true` per trobar la llista de bloqueig d'usuaris del sistema.
2. [Crea una entrada](https://docs.didit.me/ca/management-api/lists/create-entry.md) en aquesta llista amb `value` com a `vendor_data` de l'usuari.

Per bloquejar un usuari pel rostre, consulta [Rostres i biometria](https://docs.didit.me/ca/entities/users/faces-and-biometrics.md#pujar-una-cara-a-la-llista-de-bloqueig). Per bloquejar per correu electrònic, telèfon, document o IP, utilitza la llista de bloqueig del sistema corresponent amb l'identificador adequat a `value`.

## Flux d'aplicació del bloqueig

```mermaid theme={null}
sequenceDiagram
    participant Client
    participant Didit
    participant Lists as Blocklist check
    participant Workflow
    Client->>Didit: POST /v3/session/ (vendor_data=user-42)
    Didit->>Lists: Does user-42 match a USER blocklist?
    Lists-->>Didit: Match found
    Didit-->>Client: Session auto-declined (reason: blocked_user)
```

Per a les llistes de bloqueig de rostres i documents, la comprovació es fa en el pas de verificació:

```mermaid theme={null}
sequenceDiagram
    participant User
    participant Didit
    participant Lists as Face Blocklist
    User->>Didit: Liveness capture
    Didit->>Lists: Embedding search
    Lists-->>Didit: Match similarity > threshold
    Didit-->>User: Session declined (reason: blocked_face)
```

## Eliminar de la llista de bloqueig

* **Consola**: *Blocklist → \[type] → row actions → Remove*.
* **API**: utilitza l'endpoint [Delete entry](https://docs.didit.me/ca/management-api/lists/delete-entry.md) amb l'UUID de la llista i l'UUID de l'entrada.

Eliminar l'entrada no torna automàticament l'usuari a `ACTIVE`. Si vols permetre noves sessions, utilitza `PATCH /v3/users/{vendor_data}/update-status/` per canviar l'estat.

## Registre d'auditoria de les llistes de bloqueig

Cada alta o baixa d'una llista de bloqueig queda registrada al [registre d'auditoria](https://docs.didit.me/ca/console/audit-logs.md):

* Qui ha afegit l'entrada (el correu electrònic de l'usuari o `'system'`, `'api'`).
* Quan.
* `comment` opcional que explica el motiu.
* La sessió o transacció vinculada, si l'entrada s'ha generat automàticament.

## Següents passos

> [card] [API de llistes](https://docs.didit.me/ca/management-api/lists/overview.md)
>
> Referència completa de l'API de llistes de bloqueig i d'autorització.

> [card] [Llista de bloqueig de la consola](https://docs.didit.me/ca/console/blocklist-users.md)
>
> Gestiona les llistes de bloqueig des de la interfície.

> [card] [Rostres i biometria](https://docs.didit.me/ca/entities/users/faces-and-biometrics.md)
>
> Com funcionen les llistes de bloqueig de rostres.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.