Реєстрація сервісів та виклик API дата-фабрики через ШБО "Трембіта"

1. Передумови

  1. Отримайте доступ до інтерфейсу ШБО "Трембіта". Для цього зверніться до адміністратора інфраструктури, де розгорнуто ШБО. Він має видати вам IP-адресу та порт, а також логін та пароль для автентифікації.

  2. Запросіть IP-адресу сервера ШБО "Трембіта" для забезпечення whitelisting між сервісами реєстру та ШБО. Додайте отриману IP-адресу до списку дозволених. Наприклад, 172.16.0.0.

    Whitelisting налаштовується на рівні конфігурації ШБО "Трембіта" в адміністративній панелі Control Plane.

    Детальніше про це — див. на сторінці Обмеження доступу на рівні IP до SOAP-роутів ШБО "Трембіта".

  3. Для того, щоб інші реєстри могли звернутися до API-ендпоінтів Фабрики даних вашого реєстру через ШБО "Трембіта", виконайте передумови, описані на сторінці Налаштування доступу до API-представлень реєстру.

2. Додавання WSDL-файлу

  1. Увійдіть до адміністративного інтерфейсу ШБО "Трембіта".

  2. Відкрийте меню Клієнти Сервера Безпеки.

    trembita add wsdl step 1

    У результаті ви побачите список доступних клієнтів.

    Рекомендовано розділяти клієнтів на споживачів API (API consumers — додавайте суфікс cons) та надавачів API (API producers — додавайте суфікс _prod).

    Наприклад, DDMTest_prod — надавач, а DDMTest_cons — споживач.

  3. У розділі клієнта-надавача перейдіть до налаштувань Сервіси SOAP, натиснувши відповідну іконку soap config та оберіть Додати WSDL.

    trembita bp invoking 1

  4. У новому вікні введіть посилання до WSDL, що буде доступне в SOAP-вебсервісі після розгортання регламенту.

    WSDL-файл з описом вебсервісу можна отримати, наприклад, за таким шляхом:

    https://bp-webservice-gateway-example-registry.apps.example.com/ws/bpWebservice.wsdl

    • bp-webservice-gateway — назва API-сервісу, що розгортається разом з реєстром;

    • example-registry — назва вашого реєстру;

    • apps.example.com — DNS-wildcard (домен та піддомени сервера);

    • /ws/bpWebservice.wsdl — ендпоінт, де зберігається WSDL-файл.

    trembita add wsdl step 2

  5. Натисніть кнопку OK.

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

trembita add wsdl step 4

3. Налаштування прав доступу

"Трембіта" дозволяє надавати доступ на рівні окремих SOAP-методів.

За замовчуванням, після додавання WSDL, доступ до точок інтеграції через ШБО "Трембіта" для всіх заборонений.

trembita setup consumer step 1

  1. Надайте доступ до точки інтеграції іншому учасникові обміну. Для цього виберіть точку інтеграції та натисніть кнопку Права доступу.

    trembita setup consumer step 2

  2. У новому вікні натисніть Додати об’єкт.

    trembita setup consumer step 3

  3. У рядку пошуку знайдіть клієнта, якому необхідно надати доступ (у нашому випадку — це DDMTest_cons).

  4. Далі виділіть його та додайте за допомогою кнопки Додати обране.

    trembita setup consumer step 5

    У результаті, обраний клієнт має з’явитися в переліку учасників СЕВ ДЕІР.

    trembita setup consumer step 6

  5. Закрийте вікно за допомогою кнопки Закрити.

    trembita setup consumer step 7

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

4. Увімкнення сервісу

Після налаштування усіх прав доступу, увімкніть сервіс. Для цього виділіть посилання (підсвічене червоним) та натисніть кнопку Увімкнути.

trembita setup consumer step 8

5. Пов’язані сторінки