Предупреждения биометрической аутентификации и коды

Биометрическая аутентификация сочетает проверку живости с опциональным сравнением лиц 1:1 с эталонным лицом, определённым при создании сессии (переданное изображение portrait_image или сохранённое лицо пользователя, найденное по vendor_data). Каждый шаг генерирует собственные предупреждения в payload решения V3. На этой странице перечислены все коды, места их появления и то, как пороги преобразуются в итоговый статус сессии.

Обзор

При выполнении сессии биометрической аутентификации Didit:

Снимает живое селфи с помощью 3D Action, Flash или Passive Liveness (method: ACTIVE_3D, FLASHING или PASSIVE).
Извлекает самое крупное лицо из снимка и оценивает его живость.
Если сценарий включает Сравнение лиц, сравнивает полученное лицо с эталонным лицом сессии (переданным portrait_image или сохранённым лицом пользователя).
Записывает результат каждого шага, а также любые предупреждения в решение по сессии.

Предупреждения сохраняют общую структуру объекта предупреждения, используемую на всей платформе: feature, risk, additional_data, log_type, short_description, long_description и node_id.

Где появляются предупреждения

Ключ в ответе с решением	Тег функции в предупреждении	Когда срабатывает
`liveness_checks[].warnings[]`	`LIVENESS`	Оценка живости, качество лица, освещённость, несколько лиц, а также проверки по списку блокировки, списку разрешений и на дубликаты лиц.
`face_matches[].warnings[]`	`FACEMATCH`	Сравнение лиц с эталонным лицом сессии (переданным `portrait_image` или сохранённым лицом пользователя).

В типичной сессии биометрической аутентификации в каждом массиве содержится по одному элементу. В сценариях с несколькими экземплярами шагов node_id в каждом предупреждении позволяет однозначно определить, какой шаг его сгенерировал.

Условия автоматического отклонения

Следующие предупреждения всегда приводят к отклонению шага (log_type: "error") независимо от настроек сценария:

Риск	Функция	Почему отклоняется автоматически
`FACE_IN_BLOCKLIST`	`LIVENESS`	Лицо совпало с записью в вашем списке блокировки лиц.
`NO_FACE_DETECTED`	`LIVENESS`	Во время съёмки для проверки живости лицо не обнаружено или пользователь исчерпал лимит повторных попыток съёмки.
`LIVENESS_FACE_ATTACK`	`LIVENESS`	Обнаружена атака предъявления (маска, воспроизведение с экрана, спуфинг с использованием дипфейка).
`NO_REFERENCE_IMAGE`	`FACEMATCH`	Нет доступного эталонного изображения для проведения сравнения. При срабатывании этого предупреждения `LOW_FACE_MATCH_SIMILARITY` подавляется.

При срабатывании NO_FACE_DETECTED предупреждение LOW_LIVENESS_SCORE подавляется (нет лица для оценки).

Настраиваемые пороги и действия

Эти предупреждения оцениваются, а затем сопоставляются со статусом с помощью порогов и действий, которые вы задаёте для каждого сценария:

Риск	Функция	Настраиваемое поведение
`LOW_LIVENESS_SCORE`	`LIVENESS`	Оценка на уровне или ниже порога проверки → `In Review`; на уровне или ниже порога отклонения → `Declined`.
`LOW_FACE_MATCH_SIMILARITY`	`FACEMATCH`	Оценка на уровне или ниже порога проверки (по умолчанию 70) → `In Review`; на уровне или ниже порога отклонения (по умолчанию 50) → `Declined`.
`LOW_FACE_QUALITY`	`LIVENESS`	Порог проверки (по умолчанию 15) → `In Review`; порог отклонения (по умолчанию 0, то есть отклонение отключено) → `Declined`. Только Passive Liveness.
`LOW_FACE_LUMINANCE`	`LIVENESS`	Ниже минимального порога освещённости (по умолчанию 20): Без действия / Проверка (по умолчанию) / Отклонение. Только Passive Liveness.
`HIGH_FACE_LUMINANCE`	`LIVENESS`	Выше максимального порога освещённости (по умолчанию 80): Без действия / Проверка (по умолчанию) / Отклонение. Только Passive Liveness.
`MULTIPLE_FACES_DETECTED`	`LIVENESS`	Без действия (по умолчанию) / Проверка / Отклонение при обнаружении более одного лица. Только Passive Liveness.
`DUPLICATED_FACE` / `POSSIBLE_DUPLICATED_FACE`	`LIVENESS`	Одно общее действие для дубликатов лиц: Без действия (по умолчанию) / Проверка / Отклонение при совпадении с одобренными или импортированными лицами других пользователей.
`DUPLICATED_FACE_NAME_MISMATCH`	`LIVENESS`	Собственное действие (`face_liveness_duplicated_face_name_mismatch_action`): Без действия / Проверка (по умолчанию) / Отклонение. Генерируется вместе с `DUPLICATED_FACE`, когда личность, связанная с найденной сессией, не соответствует имени, определённому для этой сессии — см. Предупреждения проверки живости.

POSSIBLE_FACE_IN_BLOCKLIST (LIVENESS) не настраивается — менее уверенное совпадение со списком блокировки всегда направляется на проверку (log_type: "warning").

Повторные попытки съёмки

Ошибки, вызванные только устранимыми рисками качества съёмки (низкая оценка, отсутствие лица, качество, освещённость, несколько лиц, а также низкая схожесть при сравнении лиц), запускают цикл повторных попыток до фиксации статуса: пользователю предоставляется всего до face_liveness_max_attempts / face_match_max_attempts попыток (по умолчанию 3, настраивается от 2 до 5 для каждого узла сценария). Когда лимит исчерпан, применяется рассчитанный статус последней попытки, а в журнал записывается LIVENESS_MAX_ATTEMPTS_EXCEEDED или FACE_MATCH_MAX_ATTEMPTS_EXCEEDED с типом журнала information.

Предупреждения проверки живости

API возвращает именно эти строки short_description и long_description:

`risk`	`short_description`	`long_description`
`LOW_LIVENESS_SCORE`	Low liveness score	Проверка живости завершилась низкой оценкой, что указывает на возможное использование неживого изображения лица или низкое качество биометрических данных.
`NO_FACE_DETECTED`	No Face Detected in liveness	Системе не удалось распознать лицо во время проверки живости, что может быть вызвано низким качеством изображения, неправильным положением или техническими проблемами.
`LIVENESS_FACE_ATTACK`	Liveness Face Attack	Система обнаружила потенциальную попытку обойти проверку живости.
`FACE_IN_BLOCKLIST`	Face in blocklist	Система обнаружила лицо в списке блокировки; верификация этого лица запрещена.
`POSSIBLE_FACE_IN_BLOCKLIST`	Possible face in blocklist	Система обнаружила возможное лицо в списке блокировки; верификация этого лица запрещена.
`FACE_IN_ALLOWLIST`	Face in allowlist	Лицо совпало со списком разрешенных лиц приложения, поэтому действия при обнаружении дубликатов лиц для этого сигнала были пропущены.
`POSSIBLE_FACE_IN_ALLOWLIST`	Possible face in allowlist	Лицо предположительно совпало со списком разрешенных лиц приложения, поэтому действия при обнаружении возможных дубликатов лиц для этого сигнала были пропущены.
`DUPLICATED_FACE`	Duplicated face from other approved session	Система обнаружила дубликат лица из другой одобренной сессии, что требует дополнительного рассмотрения.
`POSSIBLE_DUPLICATED_FACE`	Possible duplicated face from other approved session	Система обнаружила возможный дубликат лица из другой одобренной сессии, что требует дополнительного рассмотрения.
`DUPLICATED_FACE_NAME_MISMATCH`	Duplicated face under a different name	То же лицо уже было одобрено в другой сессии, но под другим именем. Личность дубликата не совпадает с личностью, заявленной в текущей сессии, что является серьезным признаком мошенничества с идентификационными данными.
`MULTIPLE_FACES_DETECTED` (только для пассивной проверки)	Multiple faces detected	На изображении проверки живости обнаружено несколько лиц. Система использует самое крупное лицо для проверки живости и сравнения лиц, однако наличие нескольких лиц может потребовать дополнительной проверки.
`LOW_FACE_QUALITY` (только для пассивной проверки)	Low face quality	Качество изображения лица ниже допустимого порога, что может повлиять на надежность проверки живости. Причиной могут быть разрешение камеры, фокусировка или артефакты сжатия.
`LOW_FACE_LUMINANCE` (только для пассивной проверки)	Low face luminance	Изображение лица слишком темное, что может повлиять на точность проверки живости. Рекомендуется улучшить освещение.
`HIGH_FACE_LUMINANCE` (только для пассивной проверки)	High face luminance	Изображение лица слишком яркое или переэкспонированное, что может повлиять на точность проверки живости. Рекомендуется снизить уровень освещения или избегать прямого света.
`LIVENESS_MAX_ATTEMPTS_EXCEEDED`	Maximum liveness attempts exceeded	Достигнуто максимальное количество попыток захвата для проверки живости. Применен расчетный статус последней попытки (отклонение или проверка).

Совпадения со списком блокировки, списком разрешений и дубликатами содержат additional_data с информацией о совпавшей сессии (blocklisted_session_id / allowlisted_session_id / duplicated_session_id, соответствующий *_session_number и api_service). В одном отчёте появляется только один из этих шести кодов. Исключением является DUPLICATED_FACE_NAME_MISMATCH: он выдается в дополнение к DUPLICATED_FACE, а не вместо него, когда личность из совпавшей сессии не совпадает с определённым именем в текущей сессии. Поле additional_data для него дополняет те же поля сессии-дубликата параметром name_match_score. Имя, записанное в разных системах письма в каждой из сессий, не считается несовпадением, если документы, удостоверяющие личность, в обеих сессиях имеют одинаковую страну выдачи, точный номер документа или личный номер, а также непротиворечивую дату рождения. См. раздел Предупреждения проверки живости.

Предупреждения сравнения лиц

`risk`	`short_description`	`long_description`
`LOW_FACE_MATCH_SIMILARITY`	Low face match similarity	Черты лица на предоставленном изображении недостаточно точно совпадают с эталонным изображением, что указывает на возможное несоответствие личности.
`NO_REFERENCE_IMAGE`	No source image found for performing face match	Эталонное изображение для сравнения лиц отсутствует, что не позволяет системе завершить процесс сравнения.
`FACE_MATCH_MAX_ATTEMPTS_EXCEEDED`	Maximum face match attempts exceeded	Достигнуто максимальное количество попыток захвата для сравнения лиц. Применен расчетный статус последней попытки (отклонение или проверка).

Пример — отклонена из-за атаки на проверку живости

{
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Declined",
      "method": "ACTIVE_3D",
      "score": 12.40,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": null,
      "face_luminance": null,
      "warnings": [
        {
          "feature": "LIVENESS",
          "risk": "LIVENESS_FACE_ATTACK",
          "additional_data": null,
          "log_type": "error",
          "short_description": "Liveness Face Attack",
          "long_description": "The system detected a potential attempt to bypass the liveness check.",
          "node_id": "feature_liveness"
        }
      ]
    }
  ],
  "face_matches": null
}

Пример — на проверке из-за низкого сходства

{
  "face_matches": [
    {
      "node_id": "feature_face_match",
      "status": "In Review",
      "score": 58.70,
      "source_image_session_id": "11111111-2222-3333-4444-555555555555",
      "source_image": "https://<media-host>/.../source.jpg",
      "target_image": "https://<media-host>/.../target.jpg",
      "warnings": [
        {
          "feature": "FACEMATCH",
          "risk": "LOW_FACE_MATCH_SIMILARITY",
          "additional_data": null,
          "log_type": "warning",
          "short_description": "Low face match similarity",
          "long_description": "The facial features of the provided image don't closely match the reference image, suggesting a potential identity mismatch.",
          "node_id": "feature_face_match"
        }
      ]
    }
  ]
}

Оценка (58.70) находится между порогом отклонения (по умолчанию 50) и порогом отправки на проверку (по умолчанию 70), поэтому предупреждение имеет log_type: "warning", а статус сравнения лиц — In Review. В этом примере предупреждение сработало для сессии с session_id, равным 11111111-2222-3333-4444-555555555555: поле source_image_session_id содержит собственный идентификатор сессии, поскольку эталон взят из портрета, сохраненного при создании сессии.

Типы предупреждений

Каждому риску присваивается тип предупреждения в зависимости от настроек вашего приложения. Предупреждения делятся на три категории серьезности:

Связанные материалы

Отчёт по биометрической аутентификации

Где находятся liveness_checks[] и face_matches[] в решении V3.

Предупреждения проверки живости

Полный справочник по предупреждениям проверки живости, включая сопоставление дубликатов лиц.

Предупреждения сравнения лиц

Полный справочник по предупреждениям сравнения лиц для сопоставлений 1:1.

Аутентификация

Верификация

Мониторинг

Платформа

Предупреждения биометрической аутентификации и коды

Обзор

Где появляются предупреждения

Условия автоматического отклонения

Настраиваемые пороги и действия

Повторные попытки съёмки

Предупреждения проверки живости

Предупреждения сравнения лиц

Пример — отклонена из-за атаки на проверку живости

Пример — на проверке из-за низкого сходства

Типы предупреждений

Связанные материалы

Отчёт по биометрической аутентификации

Предупреждения проверки живости

Предупреждения сравнения лиц

​Обзор

​Где появляются предупреждения

​Условия автоматического отклонения

​Настраиваемые пороги и действия

​Повторные попытки съёмки

​Предупреждения проверки живости

​Предупреждения сравнения лиц

​Пример — отклонена из-за атаки на проверку живости

​Пример — на проверке из-за низкого сходства

​Типы предупреждений

​Связанные материалы

Отчёт по биометрической аутентификации

Предупреждения проверки живости

Предупреждения сравнения лиц

Обзор

Где появляются предупреждения

Условия автоматического отклонения

Настраиваемые пороги и действия

Повторные попытки съёмки

Предупреждения проверки живости

Предупреждения сравнения лиц

Пример — отклонена из-за атаки на проверку живости

Пример — на проверке из-за низкого сходства

Типы предупреждений

Связанные материалы