Main page •Help
23.12.2025
•
74

Authentication Flow

Authentication

Налаштування методів доступу та безпеки для підключення до API.

Authentication Flow - є фундаментальним етапом створення інтеграції. У ньому ви налаштовуєте спосіб передачі облікових даних, що дозволяє платформі отримати санкціонований доступ до ресурсів стороннього сервісу.

Навігація

  1. Як працює Authentication Flow
  2. Доступні методи авторизації
  3. Структура блоку (Settings / Note / Test)
  4. Алгоритм підключення акаунту
  5. Ключові принципи роботи
  6. FAQ


Як працює Authentication Flow

─────────────────────────────────────────────────────────────-

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

Ключові особливості:

  • Пріоритетність: Це перший вузол, який активується перед будь-якими іншими API-запитами.
  • Централізоване зберігання: Усі облікові дані зберігаються у вигляді Акаунтів в Flow Test.
  • Глобальна доступність: Результати авторизації (токени, сесії) автоматично стають доступними для використання в наступних потоках інтеграції.


Доступні методи авторизації

─────────────────────────────────────────────────────────────-

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

Bearer: Авторизація через передачу токена у заголовку Authorization: Bearer {token}.

OAuth 2.0: Протокол з використанням Client ID, Secret та Access/Refresh tokens.

Basic: Класична пара Login та Password, що кодуються у Base64.

API Key: Передача статичного ключа у Query-параметрах або Headers.

Custom: Гнучке налаштування авторизації для нестандартних API.

Static Headers: Додавання постійних заголовків до кожного запиту.  

No Authorization: Використовується для публічних API, які не потребують передачі облікових даних або ключів доступу.  

Рекомендація: Використовуйте блок Error у цьому Flow для обробки помилок ініціалізації сесії або специфічних відповідей сервера під час авторизації.
Authentication | Вибір авторизації
Authentication | Вибір авторизації


Структура блоків налаштування

─────────────────────────────────────────────────────────────-

Authentication | Панель налаштування

Кожен блок методу авторизації містить три вкладки:

1 ->  Settings: Конфігурація технічних параметрів (URLs, ключі, формати запитів). Деякі методи (наприклад, Bearer) можуть не потребувати додаткових налаштувань, тому вкладка Settings може бути відсутня.

2 ->  Note: Примітка для розробника.

3 ->  Test: Технічне середовище для перевірки роботи методу.

 
Алгоритм підключення та активації акаунту

─────────────────────────────────────────────────────────────-

Authentication | Підключення акаунту
Authentication | Ввод даних
Authentication | Вибір акаунту, збереження та активація акаунту

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

1 ->  кнопка Flow Test: перехід до налаштування тесту. Тут проводиться підключення акаунту, запуск інтеграції, заповнення вхідних тестових даних.

2 ->  кнопка Add New Account: додає новий акаунт по обраному методу авторизації.

3 ->  введення даних: у спливаючому вікні заповнюються поля валідними даними вашого сервісу. В залежності від метода авторизації поля для вводу змінюються.

4 ->  кнопка Save всередині вікна: зберігає введені дані нового акаунту.
Важливо: Вікно не закривається автоматично. Після збереження закрийте вікно вручну, щоб повернутися до інтерфейсу.

5 ->  вибір акаунту: це список всіх підключених акаунтів. Необхідно обрати щойно підключений.

6 ->  кнопка Save в Flow Test: зберігає підключені акаунти та введені вхідні дані.

7 ->  кнопка Run Test: ініціалізує запуск інтеграції. Це дозволяє DEV платформі отримувати дані (наприклад, токени), які стануть доступними для використання в інших потоках (Account Validation, Main Action тощо).  

Authentication | Розташування та використання токену


Ключові принципи роботи

─────────────────────────────────────────────────────────────-

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

  • Глобальність: Метод авторизації налаштовується один раз і автоматично використовується всією інтеграцією.
  • Відповідність API: Вибір методу повинен суворо відповідати вимогам документації зовнішнього сервісу (наприклад, якщо API вимагає OAuth 2.0, Bearer не спрацює).
  • Обов'язкова ініціалізація: Акаунт вважається активним лише після успішного натискання Run Test у вікні Flow Test.
  • Пріоритетність: Без успішно налаштованої авторизації виконання інших Flows (Main Action, Output тощо) буде неможливим, оскільки вони не матимуть доступу до даних. Виключення: якщо обрано метод No Authorization.


FAQ

─────────────────────────────────────────────────────────────-

1. Чи можна змінити метод авторизації після створення Flow?

Так, ви можете видалити поточний блок та додати інший, проте пам'ятайте, що це потребуватиме створення нового акаунту у Flow Test.

2. Що робити, якщо акаунт не підключається?

Перевірте вкладку Settings на відповідність вимогам API та переконайтеся, що в Flow Test введені актуальні дані. Також перегляньте Логи виконання.

3. Як передати отриманий токен у наступні Flow?

Після успішного Run Test дані авторизації автоматично стають частиною контексту інтеграції та доступні для використання в API-запитах в Globals - ACCOUNT - token.


Що далі?

─────────────────────────────────────────────────────────────-

Ви налаштували автентифікацію — тепер платформа може виконувати запити від імені користувача.

Наступний крок налаштування:
Account Validation Flow →
Тут ви перевірите, що підключений акаунт є дійсним і має необхідні доступи.

Попередній крок:
← Integration Overview