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

# Список блокировки пользователей: лица, документы, почта

> Как Didit применяет блокировки к пользователям: типы идентификаторов, проверка блокировки и добавление или удаление записей.

Списки блокировки не дают пользователям, которые не прошли ваши проверки комплаенса, создавать новые сессии или выполнять новые транзакции. Didit поддерживает списки блокировки по **типу идентификатора**, поэтому вы можете блокировать одного и того же недобросовестного участника по нескольким идентификаторам: лицу, документу, email, телефону и vendor\_data пользователя.

## Поддерживаемые типы идентификаторов для пользователей

| Тип | Ключ | Совпадает, когда… |
| - | - | - |
| Лицо | `FACE` | Селфи для проверки живости в новой сессии совпадает с заблокированным лицом |
| Номер документа | `DOCUMENT` | Новая подача документа, удостоверяющего личность, совпадает с заблокированным номером документа |
| Email | `EMAIL` | Новая сессия или транзакция использует заблокированный email |
| Телефон | `PHONE` | Новая сессия или транзакция использует заблокированный телефон |
| IP-адрес | `IP_ADDRESS` | IP-адрес отправителя совпадает. Поддерживаются отдельные IP-адреса (`1.2.3.4`) и диапазоны CIDR (`10.0.0.0/8`) |
| Отпечаток устройства | `DEVICE_FINGERPRINT` | Отпечаток устройства отправителя совпадает |
| Пользователь | `USER` | Сессия или транзакция использует заблокированный `vendor_data` |

Каждый тип идентификатора проверяется в подходящей точке:

* Лицо и документ: проверяются при новой сессии.
* Email и телефон: проверяются на шаге сессии, где они собираются, или в payload транзакции.
* IP-адрес и устройство: проверяются во время Анализа устройства и IP в сессии.
* vendor\_data пользователя: проверяется при создании сессии или транзакции.

## Как происходит блокировка

> [!NOTE]
>
> Отклонённая сессия никого не блокирует. Сессия завершается со статусом `Declined`, пользователь остаётся `ACTIVE`, запись в списке не создаётся, поэтому тот же человек может начать другую сессию. Блокировка выполняется вручную: добавьте запись на [странице списка блокировки](https://docs.didit.me/ru/console/blocklist-users.md) или с помощью [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md). Запись типа `USER` (`vendor_data` пользователя) также переводит статус пользователя в `BLOCKED`.

**1. Автоматически: при совпадении со списком блокировки**

Когда входящая сессия совпадает с существующей записью списка блокировки, сессия автоматически отклоняется с кодом причины, например `blocked_face`, `blocked_document`, `blocked_email` и т. д.

**2. Вручную: из консоли**

Аналитик добавляет пользователя в список блокировки через *Users → \[user] → Actions → Add to blocklist*, выбирая один или несколько идентификаторов для сохранения.

**3. Программно: через Lists API**

Используйте [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md), чтобы программно добавлять записи. Это тот же API, который консоль использует под капотом.

## Системные списки и пользовательские списки

У каждого приложения есть **системные списки блокировки**, по одному на каждый тип идентификатора. Didit управляет ими автоматически. Их нельзя переименовать или удалить. Пользовательские списки вы создаёте, называете и определяете их область действия.

| Список | Создан | Описание |
| - | - | - |
| Системный список блокировки лиц | Didit | Основной список заблокированных лиц для приложения |
| Системный список блокировки документов | Didit | Основной список заблокированных номеров документов |
| Системный список блокировки email | Didit | Основной список заблокированных email |
| Системный список блокировки телефонов | Didit | Основной список заблокированных телефонов |
| Системный список блокировки пользователей | Didit | Заблокированные идентификаторы `vendor_data` |
| Пользовательские списки блокировки | Вы | Списки с ограниченной областью действия, например по регионам, партнёрам или уровням риска |

## Добавление пользователя в список блокировки через API

Используйте [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md), чтобы добавить запись в список блокировки. Чтобы заблокировать пользователя по `vendor_data`, добавьте запись типа USER в соответствующий список:

1. [Получите все списки](https://docs.didit.me/ru/management-api/lists/list.md) с фильтром `entry_type=user` и `is_system=true`, чтобы найти системный список блокировки пользователей.
2. [Создайте запись](https://docs.didit.me/ru/management-api/lists/create-entry.md) в этом списке, указав в `value` значение `vendor_data` пользователя.

Чтобы заблокировать пользователя по лицу, см. раздел [Лица и биометрия](https://docs.didit.me/ru/entities/users/faces-and-biometrics.md#загрузка-лица-в-список-блокировки). Чтобы заблокировать по email, телефону, документу или IP-адресу, используйте соответствующий системный список и укажите нужный идентификатор в `value`.

## Процесс применения

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

Для списков блокировки лиц и документов проверка выполняется на этапе верификации:

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

## Удаление из списка блокировки

* **Консоль**: *Blocklist → \[type] → row actions → Remove*.
* **API**: используйте endpoint [Delete entry](https://docs.didit.me/ru/management-api/lists/delete-entry.md) с UUID списка и UUID записи.

Удаление записи не возвращает пользователя в статус `ACTIVE` автоматически. Чтобы разрешить новые сессии, измените статус с помощью `PATCH /v3/users/{vendor_data}/update-status/`.

## Журнал аудита списка блокировки

Каждое добавление и удаление записи в списке блокировки фиксируется в [журнале аудита](https://docs.didit.me/ru/console/audit-logs.md):

* Кто добавил запись: email пользователя или `'system'`, `'api'`.
* Когда.
* Необязательный `comment` с объяснением причины.
* Связанная сессия или транзакция, если запись создана автоматически.

## Дальнейшие шаги

> [card] [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md)
>
> Полный справочник по API списков блокировки и списков разрешённых.

> [card] [Список блокировки в консоли](https://docs.didit.me/ru/console/blocklist-users.md)
>
> Управление списками блокировки в интерфейсе.

> [card] [Лица и биометрия](https://docs.didit.me/ru/entities/users/faces-and-biometrics.md)
>
> Как работают списки блокировки лиц.


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