> For the complete documentation index, see [llms.txt](https://docs.npck.kz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.npck.kz/servisy-coid/servis-biometricheskoi-autentifikacii/opisanie-klientskogo-puti.md).

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

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

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

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FKSPGfKqPG7YMcgO2s1qU%2Fimage.png?alt=media&amp;token=e7fd3626-bbd2-4577-ac4f-1a83a0949350" alt=""><figcaption><p>Обзор клиентского пути</p></figcaption></figure>

{% hint style="warning" %}
Верификацию могут пройти люди, у которых имеется как минимум один из следующих документов:&#x20;

* удостоверение личности гражданина РК
* паспорт гражданина РК
* вид на жительство иностранца в РК
* удостоверение лица без гражданства (казахстанского образца)
  {% endhint %}

#### Обзор клиентского пути

1. Для проведения верификации приложение Участника перенаправляет пользователя на Сервис биометрической аутентификации.&#x20;
2. Сервис биометрической аутентификации обеспечивает проведение мероприятий по проверке личности клиента, включая:

#### 2.1. Пользователю отображается для подтверждения ИИН, по которому проводится верификация личности.

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2F2jcV9RDvtdZkQ8s532Pk%2Fimage.png?alt=media&amp;token=0e2c6cc9-6831-4b91-aab7-a21d5f345637" alt="" width="375"><figcaption><p>Подтверждение ИИН</p></figcaption></figure>

#### 2.2. Проводится биометрическая идентификация личности пользователя:

* проведение liveness-проверки лица в целях исключения применения злоумышленниками средств подделки (фотоизображения, видеозаписи, маски, deepfake технологии и т.д.)&#x20;

{% hint style="success" %}
Проверка Liveness работает по мультивендорной схеме. Визуальный интерфейс может отличаться  функциональность остаётся прежней.
{% endhint %}

{% hint style="warning" %}
В случае неуспешного результата liveness-проверки лица, проводится повторная проверка. Допускается проведение не более 3 (трех) liveness-проверок лица в пределах одной сессии. После исчерпания попыток сессия завершается, а возможность проведения **liveness-проверки** для верифицируемого лица **блокируется по умолчанию на 15 минут**.

Данное значение может быть изменено — минимально допустимое время блокировки составляет **1 минуту**.

Для настройки времени блокировки необходимо передать дополнительный параметр в метод\
`/v1/auth/generate-user-url`:

```json
"blockTimeMinutes": "n"
```

где `n` — желаемое время блокировки в минутах.
{% endhint %}

* получение фотоизображение из сеанса liveness-проверки лица для проведения процедуры сопоставления фотоизображений
* получение из доступных источников эталонного фотоизображения лица клиента, включая данные из:
  * удостоверения личности гражданина РК
  * паспорта гражданина РК
  * вида на жительство иностранца в РК
  * удостоверения лица без гражданства (казахстанского образца)
* проведение процедуры сопоставления фотоизображения, полученного из сеанса liveness-проверки лица, с эталонным фотоизображением из доступных источников

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2F9xiHR0mMDHF7eiZTlE8T%2Fimage.png?alt=media&amp;token=19b744f3-6142-449c-8190-cb18630e89c3" alt="" width="375"><figcaption><p>Проведение liveness-проверки лица </p></figcaption></figure>

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

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2Fvjn2kNuo8yWEebQ33j0W%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(17).png?alt=media&amp;token=f467c7fb-6047-428f-8f05-3c7dfe6ec497" alt=""><figcaption><p>Предоставление согласия пользователем на доступ к его данным</p></figcaption></figure>

3. Пользователь дает согласие на доступ к его данным.&#x20;

{% hint style="danger" %}
Пользователь может отклонить запрос на доступ к его данным, в таком случае доступ к его данным не предоставляется
{% endhint %}

3. Пользователь перенаправляется назад в приложение Участника. При этом, Сервис аутентификации личности клиента предоставляет приложению участника результат верификации.