Перейти к основному содержимому

# Аппликант

Аппликант (заявитель) — это учетная запись человека, проходящего биометрическую проверку.

Все биометрические проверки, связанные с конкретным аппликантом, сохраняются в попытки.

Аппликант может находиться в одном из двух состояний:

- Зарегистрированный — биометрические данные пользователя привязаны к этому аккаунту.

- Незарегистрированный — биометрические данные еще не закреплены.

После регистрации биометрические данные закрепляются за конкретным аппликантом и не могут быть повторно использованы для другого аккаунта.

## Операции над аппликантами​

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

### Регистрация​

Регистрация аппликанта представляет собой процесс привязки биометрических данных пользователя к его учетной записи на основании успешно проведённых биометрических проверок.

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

примечание

На данном этапе биометрический шаблон из сданной биометрии проверяется на совпадение по общей базе данных зарегистрированных аппликантов.

осторожно

Добавление биометрии в базу происходит не моментально. Максимальный период времени добавления зависит от настройки модуля platform index_update_period. Пока фото не будет добавлено, возможна регистрация дубликатов.

Авторизация доступна сразу после регистрации т.к. в этом процессе идет сравнение биометрии из попытки авторизации с регистрационными биометрическими данными, а не с биометрией из базы системы.

### Авторизация​

Авторизация аппликанта — это процесс верификации личности пользователя путём сравнения предоставленных биометрических данных с данными, ранее привязанными к аппликанту.

В ходе авторизации система проводит анализ и сопоставление текущих биометрических параметров с эталонными, что позволяет подтвердить подлинность личности пользователя. При совпадении данных происходит успешная авторизация.

примечание

На данном этапе биометрический шаблон из сданной биометрии проверяется на совпадение исключительно с биометрией, привязанной к аппликанту.

### Подтверждение регистрации​

примечание

Этот этап возможен только после включения соответствующей настройки в системе.

В режиме подтверждения регистрации система обрабатывает биометрические данные следующим образом:

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

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

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

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

осторожно

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

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

### Блокировка​

Блокировка аппликанта позволяет запретить попытки сдачи биометрии по этому аппликанту.

Если заблокировать незарегистрированного аппликанта, то никакие последующие попытки регистрации будут невозможны.

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

### Разблокировка​

Разблокировка аппликанта позволяет возобновить попытки сдачи биометрии по этому аппликанту.

Разблокировка не зарегистрированного аппликанта сбросит счётчик попыток регистрации этого аппликанта.

### Обновление эталонного биометрического шаблона​

примечание

Эта возможность доступна только через API.

Обновление биометрического шаблона позволяет поменять эталонную биометрию аппликанта. Обновлённая биометрия будет в дальнейшем использоваться для авторизации.

осторожно

Обновление не происходит моментально. Максимальный период времени обновления зависит от настройки модуля platform index_update_period. Пока фото не обновлено, авторизация будет работать по старой биометрии.

### Удаление аппликанта​

Удаление аппликанта представляет собой процесс полного удаления биометрических и иных данных об аппликанте из системы. После завершения этого процесса биометрические данные могут быть зарегистрированы повторно.

## Статусы аппликантов​

Статус аппликанта отражает текущее состояние аппликанта и определяет допустимые для него операции.

### Места отображения статусов аппликанта​

В ответах API статус аппликанта хранится в полях statusName (текстовое представление) и status (численное представление). Пример ответа API, содержащий данные аппликанта:

    {
      "applicantId": "78c57b83-9420-404e-bc7e-9edd1c131e55",
      ...
      "status": 1,
      "statusName": "Success",
    }

В дашборде статус аппликанта можно увидеть в таблице всех аппликантов:

### Описание статусов аппликанта​

Ниже приведена таблица описания статусов аппликанта. Для каждого статуса приведён список действий, которые можно совершить над аппликантом в этом статусе.

Название статуса | Номер статуса | Описание статуса | Возможные действия над аппликантом
Pending | 0 | Аппликант только что создан. Попытки регистрации не предпринимались | Регистрация Блокировка
Success | 1 | Аппликант был успешно зарегистрирован. Биометрия сохранена в базу | Авторизация Блокировка Обновление эталонного биометрического шаблона
Failed | 2 | Аппликант заблокирован из-за превышения попыток регистрации | Разблокировка
Canceled | 3 | Аппликант закрыт вручную | Разблокировка
FailedAttempt | 5 | По аппликанту безуспешно пытались зарегистрироваться. Повторные попытки возможны | Регистрация Блокировка
Unconfirmed | 6 | Система BAF посчитала попытку регистрации успешной, но требуется валидация внешней системы для сохранения биометрии | Подтверждение регистрации Регистрация Блокировка

примечание

Аппликант считается зарегистрированным, если имеет статус Success или Canceled (в случае блокировки ранее уже зарегистрированного аппликанта). Остальные статусы соответствуют состоянию не зарегистрирован.

### Диаграмма перехода статусов аппликанта​