> 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-upravleniya-oblachnoi-ecp-esign/opisanie-klientskogo-puti.md).

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

Сервис управления облачной ЭЦП Esign предоставляет удобный и интуитивно понятный интерфейс для пользователя. 

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

{% hint style="warning" %}
Подписание документов ЭЦП доступно для людей, у которых имеется как минимум один из следующих документов:  

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

## Подписание документов пользователем

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2Fwrml2RPg9NvhGuO4vqvl%2FPrPayments%20-%202024-05-17T163047.556.jpg?alt=media&amp;token=242ee260-0025-45d7-908e-994466e38a4a" alt=""><figcaption><p>Обзор клиентского пути подписания документов облачной ЭЦП пользователя</p></figcaption></figure>

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

1. Для подписания документов ЭЦП приложение Участника перенаправляет пользователя на Сервис управления облачной ЭЦП Esign.
2. Сервис управления облачной ЭЦП Esign обеспечивает проведение мероприятий по подписанию электронных документов, включая:

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 технологии и т.д.)

{% hint style="warning" %}
В случае неуспешного результата liveness-проверки лица, проводится повторная проверка. Допускается проведение не более 4 (четырех) 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>

{% hint style="warning" %}
**Альтернативный путь обслуживания**

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

В случае неуспешной верификации запрос может быть передан разработчику биометрического решения на дополнительный анализ. До получения результатов анализа рекомендуется обслуживать клиента альтернативным методом в соответствии с внутренними процедурами Участника.
{% endhint %}

2.3. Выполняется проверка одноразового (единовременного) кода, который направляется пользователю по СМС.

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FBTwcmBUF2n0pUpoNBnhw%2Fimage.png?alt=media&amp;token=ebfade26-73c8-45ca-afeb-09ffd80d4aa7" alt="" width="375"><figcaption><p>Ввод одноразового (единовременного) кода</p></figcaption></figure>

{% hint style="warning" %}
Отправляется не более 2 (двух) СМС в пределах одной сессии двухфакторной аутентификации
{% endhint %}

{% hint style="warning" %}
**На тестовом стенде отправка СМС не производится, необходимо ввести код «**<mark style="color:red;">**0000**</mark>**»**
{% endhint %}

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

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FYRN1p58rYSrnV60AnbhF%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(19).png?alt=media&amp;token=d0ba3c6f-9d55-4d28-8cc0-2bf81e904c3e" alt=""><figcaption><p>Отображение информации о документах, поступивших для подписания ЭЦП</p></figcaption></figure>

<details>

<summary><strong>2.4.1.  Если у пользователя отсутствует облачная ЭЦП, то производится ее выпуск</strong></summary>

* Пользователю отображается форма установки пароля для ЭЦП.
* Пользователь вводит пароль для ЭЦП, подтверждает согласие Заявлением на выпуск ЭЦП и нажимает кнопку "Выпустить ЭЦП и продолжить".

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FhuMqpDqPB591yIRkHB7n%2Fimage.png?alt=media\&token=4bee6c12-3015-4809-9416-bb65ba3aa9f8)

* Производится выпуск новой облачной ЭЦП пользователя и выполняется подписание документов.

{% hint style="warning" %}
Облачная ЭЦП выпускается на 1 год и может использоваться для подписания документов.
{% endhint %}

* Выполняется переход на шаг 3.

</details>

2.5. Сервис управления облачной ЭЦП предлагает Клиенту подписать электронные документы путем ввода пароля, для доступа к закрытым ключам пользователя.&#x20;

{% hint style="warning" %}
Пароль, заданный пользователем, не хранится в информационных системах ЦОИД и удостоверяющего центра. Для проверки пароля от закрытого ключа пользователя, хранится только хэш пароля в HSM
{% endhint %}

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

<figure><img src="https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2F3DMdj7C6ocpVSUOZknO8%2Fimage.png?alt=media&amp;token=4bb0fe22-7bd0-47fa-9229-5947cc2403d2" alt="" width="375"><figcaption><p>Ввод пароля ЭЦП</p></figcaption></figure>

<details>

<summary>2.6.1. Если Пользователь не помнит пароль от ЭЦП, то он может задать новый пароль</summary>

* Если Пользователь не помнит пароль, он нажимает на кнопку "Не помню пароль".
* Пользователю отображается форма установки пароля для ЭЦП.
* Пользователь вводит пароль для ЭЦП, подтверждает согласие с Заявлением на выпуск ЭЦП и нажимает кнопку выпуска ЭЦП.

![](https://3642634829-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKJIIe9wXRYlANVFHqJE%2Fuploads%2FhuMqpDqPB591yIRkHB7n%2Fimage.png?alt=media\&token=4bee6c12-3015-4809-9416-bb65ba3aa9f8)

* Производится выпуск новой облачной ЭЦП пользователя и выполняется подписание документов.
* Выполняется переход на шаг 3.

</details>

3. Пользователь перенаправляется назад в приложение Участника.&#x20;
4. Приложение Участника получает подписанные документы.