ЕСОЗ - публічна документація
Managing Access Rights
Цілі
регулювання доступності даних пацієнта в залежності від наявного контексту (декларації, направлення, прямого дозволу пацієнта тощо)
Обгрунтування
На момент опрацювання вимог до процесів роботи з направленнями, виявлені вимоги з надання повного (або часткового) тимчасового доступу до даних пацієнта для лікаря (або ЗОЗ), який надає послугу(и) за направленням. Також, необхідність передати або надати права доступу, може виникати у випадку, коли лікар, який веде активний епізод пацієнта за якихось обставин не може продовжити роботу тимчасово або постійно і потрібна заміна лікаря, а це потребує надання йому прав доступу до даних пацієнта.
Припущення
- Власником та розпорядником медичних даних є пацієнт, якого ці дані стосуються.
- Права доступу надаються за наявності контексту (декларації, направлення, прямого дозволу пацієнта чи епізоду, створеного у ЗОЗ).
Вимоги
- Будь-який запит до медичних даних пацієнта повинен реєструватися у системі e-Health, із зазначенням дати та часу запиту, користувача та ЗОЗ від імені яких виконано запит, контексту запиту.
- Можливість виконання будь-якої дії користувачем, надання доступу до ресурсу чи даних, регулюється сукупністю:
- ролей та скоупів, зазначених для ролі ([AH] Scopes model v.2 [04.09.24]#Rolesscopes)
- конфігурації, яка визначає набір даних, які дозволено відображати у Patient Summary
- поточних значень параметрів користувача, ЗОЗ, та атрибутів сутностей, до яких виконується запит згідно правилам доступу за атрибутами
- обмежень, та валідацій, діючих на рівні кожного API
- (підлягяє уточненню та реалізації у наступних етапах проекту) обмежень на доступ до інформації на підставі:
- законодавства (наприклад, mental diseases)
- рішення пацієнта закрити доступ до безумовного доступу до даних (Patient Summary) та/або до конкретних епізодів (що також може впливати на склад Patient Summary)
Правила доступу за атрибутами
- Завжди: ЗОЗ, від імені якого виконується запит, повинне бути активним
- Завжди: Користувач, від імені якого виконується запит, повинен бути активним
- Завжди: У користувача, повинен бути хоча б один активний співробітник у ЗОЗ
- Якщо наведені вище правила виконуються, доступ визначається наступним чином:
Є активна декларація з пацієнтом1 | ЗОЗ = ЗОЗ у запиті2 | Ланка = Ланці у запиті3 | Є використане направлення, де ЗОЗ, яке його використало = ЗОЗ у запиті та епізод входить у список епізодів, на які надає правдо доступу направлення4 | Створення | Читання | Зміна | Дія5 | |
Medical Events/* 6 | Так | Так | Будь-яке | Будь-яке | Y7 | Y | Y | Y |
Так | Ні | Будь-яке | Будь-яке | N8 | Y | N | N | |
Ні | Так | Так | Будь-яке | Y | Y | Y | Y | |
Ні | Так | Ні | Будь-яке | N | Y | N | N | |
Ні | Ні | Будь-яке | Так | N | Y | N | N | |
Ні | Ні | Будь-яке | Ні | N | N | N | N | |
Patient Summary/* | Будь-яке | Будь-яке | Будь-яке | Будь-яке | N | Y | N | N |
Referrals/* | Будь-яке | Так | Так | Будь-яке | Y | Y | N | Y |
Будь-яке | Так | Ні | Будь-яке | N | Y | N | Y | |
Будь-яке | Ні | Будь-яке | Будь-яке | N | Y | N | Y |
1 - декларація вважається активною, коли її стан дорівнює Active
2 - ЗОЗ визначається в залежності від сутності, для якої перевіряються права доступу
3 - Ланка, яка створила запис визначається в залежності від сутності
4 - Направлення вважається використаним, коли воно знаходиться у стані "Використане" (In Queue)
5 - Для дій можливе надання доступу на конкретну дію чи перелік дій, наприклад для направлень у разі, якщо вони підписані лікарем іншої ланки, або іншого ЗОЗ, можливе виконання тільки дій використання, відміни використання та закриття направлення через процес надання зворотнього зв'язку за направленням (закриття епізоду, який посилається на направлення)
6 - У випадку Medical Events доступ надається від епізоду на всі його дочірні записи у сутностях
- Visit
- Encounter
- Observation
- Condition
- Immunization
- Allergy_intolerance
- Merged Episodes (сутність, яка зберігає посилання на епізоди пацієнта(ів), які були об'єднані з пацієнтом епізоду)
- Дочірні дані до Merged Episodes)
7 - доступ є
8 - доступу немає
Деталізація правил
Даний розділ деталізує правила, описані в попередньому розділі та містить інструкції по імплементації цих правил
Є активна декларація з пацієнтом
Не реалізовується правилами на ABAC. Реалізовується на IL
Користувач та ресурс належать до одного закладу
Не реалізовується правилами на ABAC. Реалізовується на IL
Ланка користувача що звертається до ресурсу та ланка користувача що створив ресурс (володіє ресурсом) співпадають
Правило
При наявності в користувача хоча б одного активного співробітника в данному ЗОЗ з відповідною ланкою - користувач має правдо доступу до ресурсів даного ЗОЗ створених користувачем з такою ж ланкою
Ланка - рівень медичних послуг які виконує лікар (медичний працівник, що зареєстрований у системі eHealth)
Ланка визначається виходячи із типу медичного закладу
Маємо наступні ланки (рівні) медичних послуг:
№ | Ланка | Тип медичного закладу |
---|---|---|
1 | Первинна медична допомога | PRIMARY_CARE |
2 | Вторинна (спеціалізована) медична допомога | OUTPATIENT |
3 | Третинна (високоспеціалізована) медична допомога | TBD |
4 | Паліативна допомога | TBD |
5 | Медична реабілітація | TBD |
Для реалізації даного правила необхідно визначити відповідні атрибути користувача (Consumer), що звертається до ресурсу та відповідні атрибути самого ресурсу (Resource)
Визначення ланки для користувача (Consumer)
Consumer характеризується токеном доступу, з яким він звертається до ресурсу.
Токен містить наступну інформацію
Attribute | Description |
---|---|
user_id | ID користувача в системі |
client_id | ID клієнта, через який користувач звертається до ресурсу |
client_type | Тип клієнта (ЗОЗ, NHS Admin etc) |
1. Необхідно визначити пов'язаний party_id з даним user_id за допомогою party_users
SELECT pu.party_id FROM party_users pu WHERE pu.user_id = :user_id;
2. Визначити усіх employees даного party у даному ЗОЗ
SELECT e.id, speciality ->> 'speciality' as speciality FROM employees e WHERE e.party_id = :party_id AND e.legal_entity_id = :client_id;
3. Визначити ланки, наявні в даного користувача виходячи з таблиці, що наведена вище
Визначення ланки для ресурсу (Resource)
В даному правилі та контексті маємо на увазі наступні ресурси
Resource | Route | Relations |
---|---|---|
episodes | GET /api/patients/:patient_id/episodes/:id PATCH /api/patients/:patient_id/episodes/:id PATCH /api/patients/:patient_id/episodes/:id/actions/close PATCH /api/patients/:patient_id/episodes/:id/actions/cancel | |
encounters | GET /api/patients/:patient_id/encounters/:id | $.episode.encounters[:id].episode |
conditions | GET /api/patients/:patient_id/conditions/:id | $.conditions[:id].context |
observations | GET /api/patients/:patient_id/observations/:id | $.observations[:id].context |
immunizations | GET /api/patients/:patient_id/immunizations/:id | $.episode.encounters[<immunizations condition>].episode |
allergy_intolerances | GET /api/patients/:patient_id/allergy_intolerances/:id | $.episode.encounters[<allergy_intolerances condition>].episode |
Дані ресурси мають наступну ієрархію:
-- patient -- episodes -- encounters -- conditions -- observations -- immunizations -- allergy_intolerances
Для визначення ланки співробітника, що створив ресурс - необхідно визначити по ієрархії епізод, до якого належить ресурс, взяти $.episodes[:id].care_manager та визначити його ланку.
Технічний опис правил ABAC наведено на сторінці ABAC rules.
Питання
Question | Answer |
---|---|
Чи є обмеження, за яких пацієнт не зможе виключити епізод з доступних для перегляду будь-ким (наприклад, соціально-небезпечні хвороби)? | Так |
Яким чином необхідно подовжувати права доступу, які вже не дійсні? | Оскільки обрано модель регулювання доступів ABAC, права доступу припиняють дію одразу ж, як перестають діяти умови, які ці права надавали. |
Яким чином надавати права доступу, якщо пацієнт сам не в змозі це зробити? |
ЕСОЗ - публічна документація