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

Персоны

Персона — это профиль физического лица внутри организации. Он объединяет идентификаторы пользователя, фотографии, статус верификации и историю связанных сессий Workflow.

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

Состав персоны

flowchart TD
    P[Персона] --> A[Алиасы]
    P --> F[Фотографии]
    P --> V[Статус is_verified]
    P --> S[Сессии Workflow]
    P --> H[История действий]

Каждая персона принадлежит одной организации. Алиасы уникальны в пределах организации и используются для поиска и предотвращения дубликатов.

Алиасы

Алиас — это идентификатор, по которому система может найти персону.

Тип Назначение Особенности
system_id Внутренний UUID персоны Создаётся автоматически и не изменяется
phone Номер телефона Может извлекаться из результата E-Document
personal_number ИИН или другой персональный номер Может извлекаться из документа
document_number Номер паспорта или удостоверения Может извлекаться из результата документа
custom Идентификатор клиентской системы Передаётся клиентской системой

Одна персона может иметь несколько алиасов разных типов. Значение алиаса должно быть уникальным в пределах организации.

Фотографии

Профиль может содержать фотографии из разных источников. Приоритет определяет, какое изображение предпочтительно использовать как основное:

Тип Приоритет Источник
digital 1 Цифровая фотография из E-Document
scan 2 Портрет со сканированного документа
live 3 Лучший кадр Liveness
other 4 Загруженная вручную фотография

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

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

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

Не используйте наличие персоны как самостоятельное подтверждение успешности текущей сессии. Для бизнес-решения проверяйте актуальный результат сессии.

Автоматический сбор данных

Если сбор персон включён в конфигурации Workflow, после завершения сессии система обрабатывает результаты в фоне:

  1. Извлекает алиасы и фотографии из результатов технологий и метаданных.
  2. Ищет существующую персону по найденным алиасам.
  3. Обновляет найденный профиль или создаёт новый.
  4. Добавляет новые алиасы и фотографии без дублирования существующих данных.
  5. Выбирает основную фотографию с учётом приоритета.
  6. Связывает сессию с персоной.

Источники автоматического сбора:

Источник Данные
E-Document ИИН, номер документа, телефон, фотография digital
Document Recognition Персональный номер, номер документа, фотография scan
Liveness Лучший кадр live
Метаданные сессии Алиас клиентской системы

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

Связь сессии с персоной

При создании сессии передайте значение любого алиаса существующей персоны либо новый уникальный идентификатор клиентской системы:

{
  "api_key": "<FLOW_API_KEY>",
  "metadata": {
    "person": {
      "alias": "<PERSON_ALIAS>"
    }
  }
}

Тип алиаса отдельно не передаётся:

  • если значение совпадает с любым алиасом существующей персоны организации, система связывает сессию с ней;
  • если значение не найдено, при включённом сборе персон система создаёт новую персону и добавляет переданное значение как алиас типа custom.

Настройки персон в Workflow

Настройка Поведение
Сбор персон Автоматически создаёт и обновляет профили по завершённым сессиям
Принудительная верификация Создаёт новые персоны с is_verified = true независимо от Face2Face
Пропуск существующих результатов Ищет персону по metadata.person.alias и может использовать результаты предыдущих технологий
Использование для Face2Face Использует подходящую фотографию персоны как эталон для сравнения

Если сбор персон выключен, автоматическое создание и связывание прекращается, но ручное управление через Backend API или личный кабинет остаётся доступным. Изменение конфигурации влияет на новые сессии и не изменяет уже созданные профили задним числом.

Повторная проверка

Для повторной проверки известного пользователя:

  1. Получите один из алиасов его персоны в своей системе.
  2. Передайте значение как metadata.person.alias при создании новой сессии.
  3. Запустите Workflow обычным способом.
  4. Получите результат новой сессии и примите решение по актуальным данным.

Если в Workflow включён пропуск существующих результатов, система может скопировать подходящий результат из предыдущей сессии и не запускать соответствующую технологию повторно. Если включено использование фотографии персоны для Face2Face, система выбирает эталон с приоритетом digital → scan → live.