Перейти к содержанию

Фотографии и верификация Person

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

О создании профиля и настройках читайте в Person и Workflow, о запросах — в Person Integration API.

Тип и источник фотографии

Тип в API Содержимое
DIGITAL Цифровая фотография, в том числе из PPS или E-Document
SCAN Портрет из распознанного документа
LIVE Лучший кадр Liveness
OTHER Другое изображение, например загруженное организацией

Тип и источник — разные поля. Ручная загрузка через API получает источник MANUAL и is_uploaded=true, даже если выбран тип DIGITAL. Тип не превращает её в фотографию PPS.

Как выбирается основная фотография

Автоматический выбор рассматривает только активные, неудалённые фотографии:

  1. Действующая временная фотография имеет высший приоритет.
  2. Сохраняется вручную назначенная основная фотография с источником MANUAL.
  3. Для остальных фотографий используется порядок из таблицы.
Приоритет Тип и источник
1 DIGITAL из PPS
2 DIGITAL из E-Document, включая детский документ
3 SCAN из Document Recognition
4 LIVE из Liveness
5 Другие сочетания типа и источника, включая старые данные с неизвестным источником

При равном приоритете учитывается назначение основной фотографии; затем предпочтение отдаётся более новой. При сборе нового PPS одна из его фотографий назначается предпочтительной.

Через API постоянная фотография становится основной при явном is_default=true. Одна только загрузка с is_default=false не запускает автоматический выбор по приоритету.

Постоянную фотографию с is_default=true удалить нельзя — сначала назначьте другую. Для временной фотографии действует отдельное правило удаления с восстановлением эталона.

Использование в Face2Face

В Workflow должна присутствовать технология Person с Use person's photo for F2F comparison=true. Персона определяется по сохранённой связи при старте сессии либо по metadata.person.alias. Используется её актуальная основная фотография.

Переданный metadata.face2face.photo1 имеет приоритет: фотография Person в этом случае не добавляется для сравнения. См. метаданные Face2Face.

В автоматическом сценарии с активными Person + PPS + Face2Face + Liveness, без явно переданных изображений и face2face.photo1, система выбирает:

  • лучший кадр успешного Liveness текущей сессии;
  • основную фотографию Person, если она доступна для этого сценария;
  • если фотография Person не выбрана или её файл недоступен — фотографию успешного PPS текущей сессии.

Если обязательных изображений не хватает, сравнение завершается ошибкой отсутствия изображений. Состав и результат сравнения описаны в Face2Face.

Статус верификации

is_verified — статус профиля, который может быть получен автоматически или выставлен организацией:

  • при автоматическом создании учитывается успешный Face2Face; настройка Skip person verification=true принудительно выставляет статус новой персоне;
  • при обновлении существующей персоны успешный Face2Face может установить true; неуспешный результат сам по себе не снимает ранее установленный статус;
  • Integration API позволяет явно изменить is_verified;
  • истечение или удаление временной фотографии снимает статус, если не удалось восстановить постоянный эталон.

Загрузка временной фотографии сама по себе не подтверждает личность и не требует is_verified=true. Проверка принадлежности загруженного изображения человеку остаётся частью процесса организации: загрузка не запускает биометрическое сравнение.

Для решения по новой попытке проверяйте результат сессии, а не только статус Person.

Временная фотография

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

Временность не является отдельным типом: можно использовать OTHER или другой допустимый тип, а срок задаётся отдельно.

Назначение

Добавьте фотографию через API с будущим expires_at в ISO 8601 с часовым поясом, например 2030-10-01T12:00:00+05:00. Перед отправкой выбирайте дату, которая действительно находится в будущем.

При назначении:

  • фотография становится основной, даже если передано is_default=false;
  • сохраняется ссылка на предыдущую основную фотографию;
  • предыдущая фотография остаётся в профиле, но перестаёт быть основной;
  • у персоны может быть только одна действующая временная фотография.

Пока она действует, нельзя добавить вторую временную фотографию или назначить другую основную. Можно добавлять постоянные фотографии с is_default=false. Автоматический сбор новых фотографий, включая PPS, сохраняет приоритет временной.

Изменение срока

Через обновление фотографии можно продлить или сократить срок действующей временной фотографии. Новая дата должна оставаться в будущем.

Нельзя:

  • продлить уже истёкшую или удалённую фотографию;
  • снять срок с временной фотографии;
  • превратить постоянную фотографию во временную через обновление;
  • снять is_default с действующей временной фотографии.

Пропущенный expires_at оставляет срок без изменений. Явный null в запросе обновления недопустим. Максимальная длительность и число продлений в этом контракте не ограничены.

Замена и досрочное прекращение

Для замены изображения удалите текущую временную фотографию и загрузите новую с новым сроком. Обновление фотографии через Integration API изменяет свойства, но не принимает новый файл.

Удаление временной фотографии разрешено, даже если она основная. Оно немедленно запускает восстановление постоянного эталона. Удаление и следующая загрузка — отдельные запросы: между ними уже действует восстановленная фотография либо профиль остаётся без основной.

Если постоянной фотографии нет, удаление снимет is_verified. Следующая загрузка временной фотографии сама этот статус не вернёт.

Истечение срока и восстановление

Фотография действует, пока текущее время строго меньше expires_at. В момент наступления срока она больше не используется как эталон.

Система выбирает замену в следующем порядке:

  1. Возвращает предыдущую основную постоянную фотографию, если она ещё активна и не удалена.
  2. Иначе выбирает подходящую постоянную фотографию по правилам приоритета.
  3. Если подходящих фотографий нет, профиль остаётся без основной фотографии и получает is_verified=false.

При успешном восстановлении существующий is_verified=true сохраняется; false автоматически не становится true.

Чтение через API и выбор эталона учитывают наступивший срок независимо от того, успела ли выполниться фоновая обработка. Фоновая обработка сохраняет истечение и действия восстановления в истории.

Если Face2Face уже выбрал действовавшую фотографию, последующее истечение не меняет выбранную пару в выполняющемся сравнении. При следующем выборе используется актуальное состояние.

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

Активные фотографии и история

Поле Значение
expires_at Плановая дата окончания временной фотографии; null для постоянной
is_expired Фотография выведена из активного использования
expired_at Дата истечения или перевода в историю
expiration_reason Причина, например TTL или SOURCE_REPLACED
source_technology_code Источник изображения
is_default Является ли фотография текущей основной

Истечение и удаление различаются. Истёкшие фотографии сохраняются и доступны при чтении с include_expired=true. Удалённые фотографии не возвращаются даже с этим параметром.

При получении нового оригинального PPS с фотографиями старые активные фотографии PPS переходят в историю с SOURCE_REPLACED. Если прежний постоянный эталон стал неактивным во время действия временного, после истечения выбирается другая подходящая постоянная фотография.

Правило замены PPS не означает автоматического истечения всех старых фотографий E-Document или Document Recognition. Срок повторного использования результата документа настраивается отдельно в Person и Workflow.

Дальше