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

Сервис управления облачной ЭЦП 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&#x26;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&#x26;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&#x26;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%2FBTwcmBUF2n0pUpoNBnhw%2Fimage.png?alt=media&#x26;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%2FSvsuD9nXGi3irA4Uy5Oc%2Fimage.png?alt=media&#x26;token=507b3bd2-0ba9-4e3f-af16-76442a46e7de" alt="" width="375"><figcaption><p>Отображение информации о документах, поступивших для подписания ЭЦП</p></figcaption></figure>

<details>

<summary>2.4.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)

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

{% 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&#x26;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. Приложение Участника получает подписанные документы.