Биометрия пользователей: поиск по лицу, список блокировки

Биометрия лиц является основой каждой сущности User. Didit получает изображение лица во время проверки живости, создаёт векторный эмбеддинг и сохраняет его для четырёх связанных функций: поиска по лицу 1:N, проверки на дубликаты, применения списка блокировки и повторной биометрической аутентификации.

Сохранённые лица также служат эталоном для Биометрической аутентификации: создайте сессию биометрической аутентификации с vendor_data пользователя и не передавайте portrait_image. Didit автоматически использует сохранённое лицо в следующем порядке: сначала лицо из одобренной проверки живости, затем фото с чипа ePassport, затем портрет из документа, удостоверяющего личность, и только после этого лицо, добавленное в профиль вручную.

Как лица привязываются к пользователю

Получение во время проверки живости

Когда пользователь проходит сессию с включённой проверкой живости, Didit получает селфи, выполняет пассивную проверку живости, выделяет самое крупное лицо и создаёт векторный эмбеддинг для поиска.

Сохранение в профиле пользователя

Лицо связывается с сессией и родительской сущностью User. URL портрета отображается в профиле пользователя как portrait_image.

Индексация для поиска

Эмбеддинг добавляется в поисковый индекс. Последующие сессии могут выполнять поиск 1:N по этому индексу.

Поиск по лицу (1:N)

Поиск по лицу позволяет найти пользователя, загрузив изображение и сравнив его со всеми лицами, зарегистрированными в вашем приложении. Сценарии использования:

Проверка на дубликаты при онбординге: не допускать создания двух аккаунтов одним человеком.
Обратный поиск: определение пользователя по кадру с камеры видеонаблюдения или по изображению в ходе расследования мошенничества.
Распознавание повторного клиента: не проводить KYC для вернувшегося клиента.

Поиск по лицу запускается автоматически в новых сессиях, если в вашем сценарии включена проверка на дубликаты. Он также доступен как отдельный API:

POST /v3/face-search/: отдельный поиск по лицу

Проверка на дубликаты

Каждое новое лицо можно сравнить с уже зарегистрированными лицами, чтобы выявить дубликаты. Didit присваивает каждому лицу значение approved_duplicate_status:

Статус	Значение
`NOT_DUPLICATED`	Совпадений выше порога сходства не найдено
`DUPLICATED`	Лицо совпадает с одним или несколькими лицами из уже одобренной сессии

Сценарии можно настроить так, чтобы:

Отклонить сессии с признаком дубликата автоматически.
Отправить на проверку: передать сессию аналитику для ручной проверки.
Только предупреждать: разрешить сессию, но добавить тег риска.

Настроить это можно в консоли: Workflows → [your workflow] → Face Match / Liveness → Duplicate detection.

Список блокировки лиц

Отклонение сессии не добавляет лицо ни в один список блокировки. Чтобы отклонять будущие сессии с тем же лицом, добавьте его в список блокировки самостоятельно: со страницы Blocklist или через Lists API. Новая сессия, селфи в которой совпадает с этой записью, будет автоматически отклонена.

Загрузка импортированного лица в профиль User

Если вы переходите с другого провайдера KYC, сначала можно создать User, а затем привязать к его профилю доверенное изображение лица. User по-прежнему идентифицируется по вашему vendor_data, но endpoint загрузки лица использует внутренний идентификатор User в Didit (didit_internal_id), чтобы цель была однозначной.

Создайте или получите User

Вызовите POST /v3/users/create/ с вашим стабильным vendor_data или вызовите GET /v3/users/{vendor_data}/, если User уже существует.

Извлеките didit_internal_id

Ответ по User содержит didit_internal_id. В своей системе продолжайте использовать vendor_data, а didit_internal_id применяйте только в endpoint’ах привязки к профилю.

Загрузите лицо

Вызовите

POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/

с изображением лица в кодировке base64.

# 1. Create or retrieve the User keyed by your vendor_data
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "user-42",
    "display_name": "Jane Doe",
    "metadata": { "previous_provider": "legacy-kyc-vendor" }
  }'

# Response includes:
# { "didit_internal_id": "11111111-2222-3333-4444-555555555555", ... }

# 2. Upload the imported face to the User profile
curl -X POST https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/11111111-2222-3333-4444-555555555555/faces/upload/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<base64-encoded-jpg-or-png>",
    "comment": "Imported from previous KYC provider"
  }'

Импортированные лица профиля регистрируются в том же индексе лиц, который используется для проверки на дубликаты и поиска по лицу. Они не добавляются в список блокировки автоматически. Чтобы заблокировать известного недобросовестного участника, загрузите его лицо в список типа «лицо».

Загружайте только те лица, обработка которых разрешена в соответствии с вашим уведомлением о конфиденциальности и соглашением о миграции. Указывайте идентификаторы исходного провайдера в metadata или comment только тогда, когда их безопасно показывать вашим специалистам по комплаенсу.

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

Триггер	Действие
Сессия `DECLINED`	Ничего не добавляется в список блокировки; User остаётся `ACTIVE`
Аналитик вручную добавляет лицо в список блокировки из консоли	Лицо добавляется, статус пользователя обновляется в соответствии с политикой
Программное добавление через Lists API	Загрузите изображение лица в список блокировки типа «лицо»

Загрузка лица в список блокировки

Чтобы заблокировать пользователя по лицу программно, загрузите изображение лица в список блокировки типа «лицо» через специальный endpoint Upload face to list. Didit извлекает биометрический эмбеддинг и добавляет его в соответствующий индекс: любая будущая сессия, селфи в которой совпадает с этим лицом, будет автоматически отклонена.

Загрузка лица в профиль и загрузка лица в список блокировки — это разные операции. Загрузка в профиль привязывает доверенное импортированное лицо к User для подтверждения, проверки на дубликаты и поиска по лицу. Чтобы заблокировать лицо и отклонять будущие сессии при совпадении, используйте Lists API.

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

Удалите запись в консоли: Blocklist → Faces → row actions → Remove, или воспользуйтесь endpoint’ом Delete entry.

Сохранённые биометрические шаблоны после удаления сессии

Удаление сессии удаляет изображение лица и по умолчанию эмбеддинг лица, поэтому человек выпадает из обнаружения дубликатов и Поиска по лицу. Если вы удаляете сессии сразу после одобрения, но вам по-прежнему нужно выявлять повторные регистрации, включите в приложении хранение биометрических шаблонов или передайте retain_face_embeddings: true в вызове удаления. Затем Didit удаляет сессию и все её данные, как обычно, и сохраняет один отдельно управляемый биометрический шаблон лица без изображения, привязанный к пользователю:

Он содержит только числовой шаблон лица и метаданные хранения. Он никогда не содержит изображение лица, видео проверки живости, данные документа, извлечённые поля личности, решение или идентификатор удалённой сессии.
Он участвует в обнаружении дубликатов, Поиске по лицу, биометрической аутентификации и ваших списках лиц так же, как лицо из действующей сессии. О совпадениях сообщается с source: "retained_template", vendor_user_id и vendor_data пользователя, а также с biometric_template_id.
Это биометрические данные с конечным сроком действия, указанным в expires_at. Шаблон удаляется, когда удалён пользователь, когда удалена любая сессия этого пользователя с deletion_instruction: "privacy_erasure", когда истекает его срок действия или когда вы очищаете его в Lists → Биометрические шаблоны или через Biometric Templates API.
Сессия, созданная без vendor_data, не имеет пользователя, к которому можно привязать шаблон. При её удалении сообщается ineligible_no_vendor_user, а эмбеддинг удаляется вместе с сессией.
Сохранённые шаблоны никогда не попадают в список блокировки. Запись в списке блокировки, созданная из удалённой сессии, сохраняет собственную независимую биометрическую запись и собственный жизненный цикл.

Шаблоны, привязанные к пользователю, отображаются в профиле пользователя в разделе Биометрические шаблоны с действием очистки.

Сводка жизненного цикла лица

Загрузка лица из консоли

Сотрудники комплаенса могут загружать лица вручную:

Перейдите в Users → [user] → Actions → Upload face.
Выберите изображение. Didit извлекает самое крупное лицо и сохраняет новую запись Face, привязанную к пользователю.
Лицо регистрируется как подтверждение профиля, для обнаружения дубликатов и поиска по лицу. Если нужно отклонять будущие совпадающие сессии, используйте раздел списка блокировки.

Это полезно, когда:

У вас есть известный портрет клиента, проверенного через офлайн-канал.
Вы хотите заранее заполнить список блокировки известными недобросовестными участниками из вашей базы данных о мошенничестве.

Конфиденциальность и хранение

Эмбеддинги лиц являются числовыми векторами, а не изображениями. Сами изображения хранятся в зашифрованном объектном хранилище с доступом по подписанным URL. Эмбеддинг лица является биометрическими данными.
Срок хранения определяется политикой хранения данных вашего приложения. Для сохранённых биометрических шаблонов действует более строгий и ограниченный срок хранения биометрических шаблонов.
Удаление сессии удаляет изображение и по умолчанию эмбеддинг. Если ваше приложение включило хранение биометрических шаблонов, удаление сессии сохраняет шаблон без изображения до истечения срока или очистки.
Для запроса на право быть забытым по GDPR / CCPA удалите сессии этого человека с deletion_instruction: "privacy_erasure" или удалите пользователя: в обоих случаях очищаются и все сохранённые шаблоны. Записи списка блокировки лиц, которыми вы управляете, остаются, пока вы их не удалите.

Следующие шаги

Поиск по лицу

Как работает поиск по лицу 1:N.

Проверка живости

Проверка живости, которая фиксирует лицо.

API списка блокировки

Загрузка лица в список блокировки.

Биометрические шаблоны

Шаблоны, сохранённые после удаления сессии.

Список блокировки пользователей

Как работает блокировка пользователя.

Обзор

Цены

Сценарии и верификация

Проверка и операции

Сущности (пользователи и компании)

Настройки и кастомизация

Безопасность и комплаенс

Didit Academy

Ресурсы

Биометрия пользователей: поиск по лицу, список блокировки

Как лица привязываются к пользователю

Поиск по лицу (1:N)

Проверка на дубликаты

Список блокировки лиц

Загрузка импортированного лица в профиль User

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

Загрузка лица в список блокировки

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

Сохранённые биометрические шаблоны после удаления сессии

Сводка жизненного цикла лица

Загрузка лица из консоли

Конфиденциальность и хранение

Следующие шаги

Поиск по лицу

Проверка живости

API списка блокировки

Биометрические шаблоны

Список блокировки пользователей

​Как лица привязываются к пользователю

​Поиск по лицу (1:N)

​Проверка на дубликаты

​Список блокировки лиц

​Загрузка импортированного лица в профиль User

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

​Загрузка лица в список блокировки

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

​Сохранённые биометрические шаблоны после удаления сессии

​Сводка жизненного цикла лица

​Загрузка лица из консоли

​Конфиденциальность и хранение

​Следующие шаги

Поиск по лицу

Проверка живости

API списка блокировки

Биометрические шаблоны

Список блокировки пользователей

Как лица привязываются к пользователю

Поиск по лицу (1:N)

Проверка на дубликаты

Список блокировки лиц

Загрузка импортированного лица в профиль User

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

Загрузка лица в список блокировки

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

Сохранённые биометрические шаблоны после удаления сессии

Сводка жизненного цикла лица

Загрузка лица из консоли

Конфиденциальность и хранение

Следующие шаги