Підсистема зовнішніх інтеграцій

Сторінка технічної документації у процесі розробки…​

Загальний опис

Підсистема, призначення якої є забезпечення інтероперабельності платформи шляхом налаштування можливості надавати доступ до бізнес-процесів та API читання даних, а також надання інтерфейсів для взаємодії зовнішніх систем з реєстром через СЕВДЕІР "Трембіта".

Функції підсистеми

  • Ініціювання автоматичних та напівавтоматичних бізнес-процесів реєстру

  • Виконання пошукових операцій по даним реєстру

  • Отримання записів за унікальним ідентифікатором з реєстру

  • Надання API для виклику бізнес-процесів реєстру сторонніми для реєстру системами.

  • Надання доступу іншим реєстрам або системам до окремих запитів читання Підсистеми управління даними реєстру.

  • Маршрутизація запитів до зовнішніх реєстрів до яких було надано доступ.

Технічний дизайн підсистеми

cross registry integration context
Figure 1. Логічна діаграма підсистеми
cross registry integration flow
Figure 2. Розгорнуті сценарії послідовності даних

В рамках цієї підсистеми виникає взаємодія між двома реєстрами розгорнутими на одній платформі, що створює звʼязок реєстр джерело даних та реєстр споживач даних.

Реєстр джерело даних - реєстр тримач даних який дозволяє операції читання цих даних за допомогою окремих пошукових запитів.

Реєстр споживач даних - реєстр якому було надано доступ до пошукових запитів реєстру джерела даних

Ключовий аспект який дозволяє таку взаємодію це створення сервісного користувача в реєстрі джерелі для реєстру споживача даних та використання його при здійсненні запитів. Отримання облікових даних сервісного користувача та операція автентифікації здійснюється API-шлюзом міжреєстрової взаємодії розгорнутим в реєстрі споживачі даних. Сам API-шлюз міжреєстрової взаємодії доступний для автентифікованих користувачів реєстру споживача даних.

Окремим випадком є надання доступу до даних сторонній системі споживачу даних. В даному сценарії створюється окремий сервісний користувач, а його облікові дані передаються адміністраторам системи тоді автентифікація і обмін токенів має відбуватись безпосередньо сторонньою системою.

Складові підсистеми

Назва компоненти Представлення в реєстрі Походження Репозиторій Призначення

API-шлюз для викликів БП зовнішніми системами

bp-webservice-gateway

origin

-

Шлюз надання доступу для виклику бізнес процесів сторонніми системами через ШБО Трембіта та напряму через Підсистему управління зовнішнім трафіком.

API-шлюз для читання даних реєстру зовнішніми системами

registry-soap-api-deployment

origin

-

Компонент який надає SOAP інтерфейс для читання даних через ШБО Трембіта.

API-шлюз міжреєстрової взаємодії

platform-gateway-deployment

origin

-

Сервіс виконання запитів до реєстрів платформи від імені сервісних користувачів.

Сервіс синхронного управління даними реєстру для міжреєстрової взаємодії

registry-rest-api-ext

origin

-

Виділений екземпляр сервісу синхронного управління даними для надання доступу до читання даних іншим реєстрам на платформі.

Технологічний стек

Атрибути якості підсистеми

Interoperability

Підсистема зовнішніх інтеграцій підтримує сумісність з іншими системами за рахунок надання стандартизованих інтерфейсів для взаємодії з платформою (REST, SOAP).

Scalability

Підсистема зовнішніх інтеграцій підтримує як горизонтальне, так і вертикальне масштабування.

Детальніше з масштабуванням підсистем можна ознайомитись у відповідних розділах:

Observability

Підсистема зовнішніх інтеграцій підтримує журналювання та збір метрик продуктивності для подальшого аналізу через веб-інтерфейси відповідних підсистем Платформи.

Детальніше з дизайном підсистем можна ознайомитись у відповідних розділах: