№ кроку

Крок

Опис

Технічний модуль

Методи API які мають або можуть бути використані

SE 1.10

Початок процесу

Користувач бажає авторизуватись у КПІС

1.10

Користувач ініціював авторизацію у Системі

Користувач:

• виконав вхід в інтерфейс КПІС

• ініціює процедуру авторизації в ЕСОЗ

КПІС розпочинає процес авторизації пацієнта в ЕСОЗ. в ЕСОЗ

1.20

Отримати дані для авторизації

КПІС виконує запит до сервісу авторизації на отримання даних для авторизації, які будуть підписані користувачем

Scope -

Resource - POST /oauth/nonce

https://e-health-ua.atlassian.net/wiki/x/VQBVFwQ

2.10

Get nonce

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ

https://e-health-ua.atlassian.net/wiki/x/VQBVFwQ

1.30

Користувач підписав дані для авторизації за допомогою ЕП

КПІС:

• отримала дані для авторизації від сервісу

• відображає форму для накладення електронного підпису (ЕП)

Користувач підписує дані для авторизації за допомогою ЕП

1.40

Передати підписані дані до Системи

Користувач підписв дані для авторизації за допомогою ЕП

КПІС повинна передати підписані дані до Системи та відобразити веб-частину сервісу авторизації Системи у фреймі

Scope - trusted_person:login

Resource - POST /api/pis/sign-in

API-010-001-006003-04420373

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/sign-in/patient-sign-in

2.20

PIS. Patient sign-in

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ

GW 1.10

Підписні дані коректні?

• якщо Якщо “так“ (підписні дані коректні) перейти до кроку GW 1.20

• якщо Якщо “ні“ (підписні дані не коректні) перейти до кроку 1.50

1.50

Зупинити процес авторизації

КПІС повинна зупинити процес авторизації, у випадку отримання від Системи помилки некоректних даних

1.60

Інформаційне повідомлення користувачу про помилку

КПІС відображає помилку авторизації повідомлення користувачу з посиланням на помилкову сутність

EE 1.10

Процес завершено

Процес авторизації завершується через отримання помилки під час авторизації

GW 1.20

Знайдено активного запису про пацієнта?

• якщо Якщо “так“ (знайдено активного запису про пацієнта) перейти до кроку GW 1.30

• якщо Якщо “ні“ (не знайдено активного запису про пацієнтаі) перейти до кроку 1.70

1.70

Зупинити процес авторизації

КПІС повинна зупинити процес авторизації у разі відсутності активного запису про пацієнта на основі даних з ЕП

1.80

Інформаційне повідомлення користувачу про необхідність реєстрації пацієнта

КПІС відображає помилку авторизації повідомлення користувачу з пропозицією перейти до процедури реєстрації в ЕСОЗ

EE 1.20

Процес завершено

Процес авторизації завершується через відсутність активного запису про пацієнта

GW 1.30

Знайдено більше одного активного запису про пацієнта?

• якщо Якщо “так“ (знайдено більше одного активного запису про пацієнта) перейти до кроку 1.90

• якщо Якщо “ні“ (знайдено одного активного запису про пацієнта) перейти до кроку 1.120

1.90

Зупинити процес авторизації

КПІС повинна зупинити процес авторизації у разі якщо знайдено більше одного активного запису про пацієнта

1.100

Інформаційне повідомлення користувачу: "Звернутись до НЦЗУ за уточненням персональних даних"

КПІС відображає помилку авторизації повідомлення користувачу з пропозицією звернутись до НЦЗУ за уточненням персональних даних

EE 1.30

Процес завершено

Процес авторизації завершується через виявлення більш ніж одного активного запису про пацієнта

1.110

Відобразити форму для погодження переліку скоупів

КПІС повинна відобразити користувачу форму для погодження переліку скоупів для отримання КПІС

1.120

Переглянути та погодити перелік скоупів

Користувач переглядає перелік скоупів, та виконує погодження переліку скоупів

1.130

Запит на отримання токена доступу

В результаті погодження переліку скоупів користувачем, КПІС повинна отримати від Системи "grant code" та сформувати запит на отримання токена доступу ("access token") на основі "grant code"

Scope -

Resource - POST /oauth/tokens

додати метод для ПІС (Компоненти, сутності та API) API-009-001-001-0328

https://pisapi1.docs.apiary.io/#reference/public.-patient-information-system/sign-in/exchange-oauth-code-grant-to-access-token

2.40

Exchange oAuth Code Grant to Access Token

В ЦБД ЕСОЗ виконуються дії, передбачені відповідним методом АРІ

1.140

Зберегти токен доступу “access token” та токен оновлення доступу “refresh token”

У разі успішної авторизації, КПІС повинна зберегти токен доступу ("access token") та токен оновлення доступу ("refresh token")

1.150

Відображена головна сторінка КП

Після успішної авторизації в Системі, користувачу відображається головна сторінка КП

EE 1.40

Процес завершено користувач авторизований

Користувач успішно авторизований в Системі