> ## 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.

# Lista de bloqueo de usuarios: rostros, documentos, emails

> Cómo Didit aplica bloqueos a usuarios: tipos de identificador (rostro, documento, email, teléfono, vendor_data) y bloqueo automático o manual.

Las listas de bloqueo impiden que los usuarios que no superaron tus controles de cumplimiento creen nuevas sesiones o realicen nuevas transacciones. Didit admite listas de bloqueo por **tipo de identificador**, para que puedas bloquear al mismo actor malicioso en varios puntos de datos (rostro, documento, correo electrónico, teléfono, vendor\_data del usuario).

## Tipos de identificador admitidos para usuarios

| Tipo | Clave | Coincide cuando… |
| - | - | - |
| Rostro | `FACE` | La selfie de prueba de vida de una nueva sesión coincide con el rostro incluido en la lista de bloqueo |
| Número de documento | `DOCUMENT` | Un nuevo envío de documento de identidad coincide con el número de documento incluido en la lista de bloqueo |
| Correo electrónico | `EMAIL` | Una nueva sesión o transacción usa el correo electrónico incluido en la lista de bloqueo |
| Teléfono | `PHONE` | Una nueva sesión o transacción usa el teléfono incluido en la lista de bloqueo |
| Dirección IP | `IP_ADDRESS` | La IP de quien realiza el envío coincide; admite direcciones IP individuales (`1.2.3.4`) y rangos CIDR (`10.0.0.0/8`) |
| Huella digital del dispositivo | `DEVICE_FINGERPRINT` | La huella digital del dispositivo de quien realiza el envío coincide |
| Usuario | `USER` | La sesión o transacción usa el `vendor_data` incluido en la lista de bloqueo |

Cada tipo de identificador se aplica en su punto de contacto natural:

* Rostro y documento: se aplican durante una nueva sesión.
* Correo electrónico y teléfono: se aplican durante un paso de la sesión que los recopila o en el payload de una transacción.
* IP y dispositivo: se aplican durante el Análisis de dispositivo e IP en una sesión.
* vendor\_data del usuario: se aplica durante la creación de la sesión o de la transacción.

## Cómo se produce el bloqueo

**1. Automático: al rechazarse una sesión**

Cuando se rechaza una sesión y la configuración de bloqueo automático de tu flujo de verificación (workflow) está activada, Didit añade automáticamente los identificadores relevantes (rostro, documento, correo electrónico, teléfono) a las listas de bloqueo del sistema correspondientes y cambia el estado del usuario a `BLOCKED`.

**2. Automático: al coincidir con la lista de bloqueo**

Cuando una sesión entrante coincide con una entrada existente de la lista de bloqueo, la sesión se rechaza automáticamente con un código de motivo como `blocked_face`, `blocked_document`, `blocked_email`, etc.

**3. Manual: desde la consola**

Un analista añade un usuario a la lista de bloqueo desde *Users → \[usuario] → Actions → Add to blocklist* y elige uno o varios identificadores que registrar.

**4. Programático: mediante la API de listas**

Usa la [API de listas](https://docs.didit.me/es/management-api/lists/overview.md) para añadir entradas de forma programática. Es la misma API que usa la consola internamente.

## Listas del sistema y listas personalizadas

Cada aplicación tiene **listas de bloqueo del sistema**, una por tipo de identificador, que Didit gestiona automáticamente. No puedes cambiarles el nombre ni eliminarlas. Las listas personalizadas las creas, nombras y delimitas tú.

| Lista | Creada por | Descripción |
| - | - | - |
| System Face Blocklist | Didit | Lista de bloqueo canónica de rostros de la aplicación |
| System Document Blocklist | Didit | Lista de bloqueo canónica de números de documento |
| System Email Blocklist | Didit | Lista de bloqueo canónica de correos electrónicos |
| System Phone Blocklist | Didit | Lista de bloqueo canónica de teléfonos |
| System User Blocklist | Didit | Identificadores `vendor_data` bloqueados |
| Listas de bloqueo personalizadas | Tú | Listas delimitadas, por ejemplo por región, por socio o por nivel de riesgo |

## Añadir un usuario a la lista de bloqueo mediante la API

Usa la [API de listas](https://docs.didit.me/es/management-api/lists/overview.md) para añadir una entrada a la lista de bloqueo. Para bloquear a un usuario por `vendor_data`, añade una entrada de tipo USER a la lista de bloqueo correspondiente:

1. [Enumera todas las listas](https://docs.didit.me/es/management-api/lists/list.md) filtrando por `entry_type=user` e `is_system=true` para encontrar la lista de bloqueo de usuarios del sistema.
2. [Crea una entrada](https://docs.didit.me/es/management-api/lists/create-entry.md) en esa lista con `value` establecido en el `vendor_data` del usuario.

Para bloquear a un usuario por rostro, consulta [Rostros y biometría](https://docs.didit.me/es/entities/users/faces-and-biometrics.md#subir-un-rostro-a-la-lista-de-bloqueo). Para bloquear por correo electrónico, teléfono, documento o IP, usa la lista de bloqueo del sistema correspondiente con el identificador adecuado en `value`.

## Flujo de aplicación

```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)
```

En las listas de bloqueo de rostros y documentos, la comprobación se realiza en el paso de verificación:

```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 lista de bloqueo

* **Console**: *Blocklist → \[tipo] → acciones de la fila → Remove*.
* **API**: usa el endpoint [Eliminar entrada](https://docs.didit.me/es/management-api/lists/delete-entry.md) con el UUID de la lista y el UUID de la entrada.

Eliminar la entrada no devuelve automáticamente al usuario al estado `ACTIVE`: usa `PATCH /v3/users/{vendor_data}/update-status/` para cambiar el estado si quieres permitir nuevas sesiones.

## Registro de auditoría de la lista de bloqueo

Cada alta o baja en una lista de bloqueo queda registrada en el [registro de auditoría](https://docs.didit.me/es/console/audit-logs.md):

* Quién añadió la entrada (correo electrónico del usuario o `'system'`, `'api'`).
* Cuándo.
* Un `comment` opcional que explica el motivo.
* La sesión o transacción vinculada, si la entrada se generó automáticamente.

## Próximos pasos

> [card] [API de listas](https://docs.didit.me/es/management-api/lists/overview.md)
>
> Referencia completa de la API de listas de bloqueo y de permitidos.

> [card] [Lista de bloqueo en la consola](https://docs.didit.me/es/console/blocklist-users.md)
>
> Gestiona las listas de bloqueo desde la interfaz.

> [card] [Rostros y biometría](https://docs.didit.me/es/entities/users/faces-and-biometrics.md)
>
> Cómo funcionan las listas de bloqueo de rostros.


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