Підстава запровадження​

Вимога запроваджена відповідно до:

• Постанови Кабінету Міністрів України від 25.04.2018 № 411 «Деякі питання електронної системи охорони здоров’я», яка визначає порядок функціонування ЕСОЗ;
• оновлених технічних вимог до медичних інформаційних систем, затверджених наказом НСЗУ № 138 від 20.03.2026, якими передбачено обов’язкове використання двофакторної автентифікації для користувачів ЕСОЗ.

Що це означає на практиці​

Зі свого боку ми забезпечуємо підтримку функціоналу відповідно до чинних вимог ЕСОЗ.

Корисні матеріали​

• Змінюється порядок входу до кабінету користувача МІС СКАРБ Cloud
• Інструкція: Вхід до системи СКАРБ Cloud

Просимо врахувати зазначене під час роботи в системі.

З повагою,
Команда СКАРБ Cloud.

Що змінюється в авторизації​

Після введення логіна і пароля система повертає тимчасовий pre_auth_token.

Вхід лише за обліковими даними більше не підтримується — без підтвердження 2FA користувач не отримає робочий доступ до API.

Пов’язана новина для користувачів: Змінюється порядок входу до кабінету користувача МІС СКАРБ Cloud.

Що має зробити облікова система​

Після успішного /account/login:

1. Запропонувати користувачу ввести 6-значний TOTP-код із застосунку-автентифікатора.
2. Передати pre_auth_token і code у метод POST /account/verify-2fa/.
3. Після успішної перевірки використовувати той самий token, отриманий на етапі login, з оновленим expires_in для подальших API-запитів (Authorization: Bearer <token>).

POST /account/login/  →  token + pre_auth_token (+ QR при першому налаштуванні)
        ↓
POST /account/verify-2fa/  (pre_auth_token + code)
        ↓
той самий token (з оновленим expires_in) → подальші API-запити

Приклад запиту POST /account/verify-2fa/​

{
  "pre_auth_token": "xyz789...",
  "code": "012345"
}

Обробка помилок​

Перше налаштування 2FA​

Якщо користувач ще не налаштував 2FA, після /account/login повертаються дані QR:

• qr_code_base64 — покажіть як зображення QR-коду в інтерфейсі облікової системи;
• qr_code_url — рядок у форматі otpauth://... для додавання облікового запису в TOTP-додаток (сканування або ручне додавання).

Користувач може використати:

• Microsoft Authenticator;
• Google Authenticator;
• Authy;
• інший TOTP-застосунок.

Важливо при реалізації​

Документація​

• /account/login — початок авторизації
• /account/verify-2fa — підтвердження входу через TOTP
• /account/verify-2fa-by-sign — альтернатива через КЕП

З повагою,
Команда СКАРБ Cloud.

Що змінюється​

Для всіх користувачів МІС СКАРБ Cloud підтвердження двофакторної автентифікації є обов’язковим.

Авторизація надалі складається з двох етапів:

1. Вхід за допомогою логіна і пароля.
2. Підтвердження 2FA — код із додатка-автентифікатора (TOTP — одноразовий 6-значний код у застосунку на телефоні) або підпис через КЕП.

Вхід через веб-інтерфейс​

Коротко:

1. Перейдіть на https://skarb.phrm.pro і введіть e-mail та пароль.
2. На екрані 2FA оберіть спосіб підтвердження:
   • Автентифікатор — 6-значний код із додатка (Google Authenticator, Microsoft Authenticator, Authy тощо);
   • КЕП — підтвердження кваліфікованим електронним підписом.
3. Завершіть підтвердження протягом 5 хвилин. Якщо час вичерпано — почніть вхід знову з логіна та пароля.

Для отримання кодів можна використовувати:

• Microsoft Authenticator;
• Google Authenticator;
• Authy;
• інший застосунок, що підтримує TOTP (одноразові коди).

Під час першого налаштування потрібно буде встановити застосунок, відсканувати QR-код у кабінеті МІС СКАРБ Cloud та ввести отриманий 6-значний код.

Детальна інструкція: Вхід до системи СКАРБ Cloud.

Якщо ви втратили смартфон із автентифікатором і не можете увійти — зверніться до служби технічної підтримки для скидання 2FA.

Просимо врахувати зазначені зміни під час роботи в системі.

З повагою,
Команда СКАРБ Cloud.