ІНСТРУКЦІЯ
з реєстрації віджета ID.GOV.UA
для домену reoca.gov.ua

Інтегрована система електронної ідентифікації (ІСЕІ) — Технічний адміністратор: ДП «ДІЯ»
Дата: березень 2026

Зміст

  1. Загальні відомості про ІСЕІ ID.GOV.UA
  2. Передумови для підключення
  3. Етап 1: Підключення до тестового середовища
  4. Етап 2: Укладання Договору (продуктивне середовище)
  5. Етап 3: Технічна інтеграція віджета
  6. Сертифікат шифрування
  7. Оплата та пільги для державних органів
  8. Контактна інформація та корисні посилання

1. Загальні відомості про ІСЕІ ID.GOV.UA

ID.GOV.UA — Інтегрована система електронної ідентифікації, що є складовою інформаційно-телекомунікаційної інфраструктури України. Система забезпечує електронну ідентифікацію та автентифікацію користувачів за допомогою:

Для домену reoca.gov.ua підключення дозволить користувачам проходити електронну ідентифікацію та/або використовувати віджет електронного підпису безпосередньо на сайті.

Технічний адміністратор ІСЕІ — державне підприємство «ДІЯ». Правова основа: Закон України «Про електронну ідентифікацію та електронні довірчі послуги» (№ 2155-VIII).

2. Передумови для підключення

Перед початком процедури підключення переконайтеся, що у вас наявні:

ВимогаОпис
1КЕП керівникаКваліфікований електронний підпис керівника організації або особи, уповноваженої укладати правочини
2Код ЄДРПОУКод юридичної особи — власника домену reoca.gov.ua
3Сертифікат шифруванняКваліфікований сертифікат технологічної електронної печатки з розширенням «Протокол розподілу ключів» (детальніше у розділі 6)
4URL інформаційної системиhttps://reoca.gov.ua — домен, для якого буде підключено віджет
5Технічний спеціалістРозробник, який здійснить інтеграцію віджета на сайті

3. Етап 1: Підключення до тестового середовища

Перед укладанням Договору обов'язково необхідно спочатку підключити інформаційну систему до тестового середовища ІСЕІ. Тестове підключення безкоштовне.

Крок 3.1. Вхід до Електронного кабінету

  1. Перейдіть на сайт https://cabinet.id.gov.ua
  2. Натисніть кнопку «Керівник/Підписант»
  3. Здійсніть автентифікацію одним зі способів: КЕП, BankID або Дія.Підпис

Крок 3.2. Заповнення Заяви про приєднання до тестового середовища

  1. У меню кабінету оберіть розділ «Заява про приєднання до тестового середовища ІСЕІ»
  2. Заповніть дані для підключення:
    • Повна назва організації
    • Код ЄДРПОУ
    • URL системи: https://reoca.gov.ua
    • Контактні дані відповідальної особи (email, телефон)
    • Серійний номер сертифіката шифрування
  3. За потреби додайте Уповноважених осіб для роботи з кабінетом

Крок 3.3. Підписання та відправка

  1. Підпишіть Заяву електронним підписом через інтерфейс Електронного кабінету
  2. Натисніть «Направити на розгляд»
  3. Очікуйте підтвердження на вказану електронну пошту

Крок 3.4. Тестова інтеграція

Після підтвердження, здійсніть інтеграцію згідно з тестовою технічною документацією:

РесурсПосилання
Технічна документація (тест)IDInfoProcessingD_QA.pdf
Тестові ключіtest_certificatesqa_2026.zip
Сертифікати тестового НадавачаCACertificates.Test.All.p7b
Віджет підпису (тест) — накладанняhttps://test.id.gov.ua/sign-widget/v2022testnew/
Віджет підпису (тест) — перевіркаhttps://test.id.gov.ua/verify-widget/v2022testnew/
Приклад використання віджетаEUSignWidget(Usage)-20220527.zip
Обмеження тестового середовища: 250 успішних автентифікацій/місяць; тестування віджета підпису — 1 календарний місяць з дня підключення.

4. Етап 2: Укладання Договору (продуктивне середовище)

Після успішного тестування переходьте до підключення продуктивного середовища:

Крок 4.1. Вхід до Електронного кабінету

  1. Перейдіть на https://cabinet.id.gov.ua
  2. Натисніть «Керівник/Підписант»
  3. Автентифікуйтесь за допомогою КЕП, BankID або Дія.Підпис

Крок 4.2. Заповнення Заяви про приєднання

  1. Оберіть розділ «Заява про приєднання»
  2. Заповніть усі необхідні поля:
    • Реквізити юридичної особи (назва, ЄДРПОУ, адреса)
    • URL: https://reoca.gov.ua
    • Вид послуги: автентифікація та/або віджет підпису та печатки
    • Серійний номер сертифіката шифрування
    • Контактні дані уповноваженої особи
  3. За потреби додайте Уповноважених осіб

Крок 4.3. Підписання Заяви

  1. Перевірте правильність усіх даних
  2. Підпишіть Заяву про приєднання електронним підписом (КЕП) через Електронний кабінет
  3. Направте Заяву на розгляд

Крок 4.4. Очікування підтвердження

Після розгляду Заяви ви отримаєте повідомлення на електронну пошту та в Електронному кабінеті про приєднання системи reoca.gov.ua до ІСЕІ.

Крок 4.5. Інтеграція з продуктивним середовищем

Здійсніть технічну інтеграцію відповідно до продуктивної технічної документації (розділ 5).

Зразок Договору: Завантажити Договір (PDF з КЕП)

Інструкція до кабінету: Instruction_E-cabinet.pdf

5. Етап 3: Технічна інтеграція віджета

5.1. Віджет автентифікації (OAuth 2.0)

ІСЕІ використовує протокол OAuth 2.0. Після укладання Договору вам будуть надані:

Детальний протокол інтеграцію описано в технічній документації.

5.2. Віджет підпису та печатки

Віджет підпису завантажується як iframe і забезпечує:

  1. Роботу з особистим ключем користувача
  2. Перевірку статусу сертифікатів (OCSP)
  3. Отримання сертифікатів (CMP)
  4. Створення та перевірку електронного підпису
  5. Отримання позначок часу
ФункціяURI (продуктивне середовище)
Накладання підписуhttps://id.gov.ua/sign-widget/v20220527/
Перевірка підписуhttps://id.gov.ua/verify-widget/v20220527/

Детальний порядок підключення — розділ 4 Технічної документації.

Приклад коду використання віджета: EUSignWidget(Usage)-20220527.zip

Логотип ІСЕІ для розміщення на сайті: idgovua_logo.zip

6. Сертифікат шифрування

Для обміну зашифрованими даними між ІСЕІ та системою reoca.gov.ua необхідний кваліфікований сертифікат відкритого ключа технологічної електронної печатки.

Вимоги до сертифіката:

Де отримати:

У будь-якого кваліфікованого надавача електронних довірчих послуг. Перелік надавачів: czo.gov.ua/ca-registry

Що вказати в Заяві:

Серійний номер сертифіката (наприклад: 3ed5083160dbc59b040000006310060042b30f00). Файл сертифіката додається до Заяви через Електронний кабінет.

Не плутайте сертифікат шифрування з сертифікатом підпису! Перевірте, що розширення «Використання ключів» має значення саме «Протокол розподілу ключів».

7. Оплата та пільги для державних органів

Домен reoca.gov.ua належить державному органу, тому відповідно до ч. 4 ст. 15-3 Закону України «Про електронну ідентифікацію та електронні довірчі послуги», організація звільняється від плати за приєднання до ІСЕІ та використання її ресурсів.

Від плати звільняються: органи державної влади, НБУ, СБУ, органи місцевого самоврядування, державні установи та заклади, та інші органи згідно із Законом.

Для комерційних організацій оплата здійснюється:

Діючий тариф: Tariffs_07092021_04122025.pdf

8. Контактна інформація та корисні посилання

ПитанняКонтакт
Робота з Електронним кабінетомcontract@id.gov.ua
Технічна підтримка ІСЕІhelp@id.gov.ua
Мінцифриhello@thedigital.gov.ua

Корисні посилання:

РесурсURL
Електронний кабінет Учасникаcabinet.id.gov.ua
Сторінка підключенняid.gov.ua/connect
Підключення тестового середовищаid.gov.ua/connectqa
Технічна документація (прод)IDInfoProcessingD.pdf
Технічна документація (тест)IDInfoProcessingD_QA.pdf
Інструкція до Е-кабінетуInstruction_E-cabinet.pdf
Зразок ДоговоруStatement_for_accession_2025.pdf
Приклад використання віджетаEUSignWidget(Usage)-20220527.zip
Логотип ІСЕІidgovua_logo.zip
Реєстр кваліф. надавачів ЕДПczo.gov.ua/ca-registry
Закон про електронну ідентифікаціюЗакон № 2155-VIII