Basic

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

Навігація

1. Призначення, розташування та особливість
2. Налаштування блоку
3. Додавання акаунту та ініціалізація запуску
4. FAQ

Призначення, розташування та особливість

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

Блок використовується виключно у флоу Authentication. Він повідомляє системі, що для взаємодії з сервісом необхідно використовувати облікові дані користувача.

Як це працює:

1. Ви додаєте блок у Authentication Flow.
2. Система активує поля Login та Password у вікні Flow Test.  
3. Платформа автоматично формує рядок виду login:password, шифрує його за стандартом Base64 і підставляє у кожен HTTP-запит.  

Налаштування блоку

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

Унікальність цього блоку в тому, що він не має внутрішніх налаштувань.

Коли ви відкриваєте блок Basic, ви побачите лише 2 розділи:

• Note - для технічних нотаток або опису особливостей API.
• Test - технічна інформація про Глобальні дані акаунту.

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

Додавання акаунту та ініціалізація запуску (Flow Test)

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

Після того, як ви обрали Basic як метод автентифікації, необхідно створити реальне підключення та ініціалізувати тестовий запуск, щоб система «побачила» ці дані.

Цей порядок є обовʼязковим для коректної роботи Basic-автентифікації.

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

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

2 -> Кнопка Add New Account: Натисніть Add New Account, щоб додати нові облікові дані для Basic авторизації.

3 -> Заповнення даних: У вікні, що з'явилося, заповніть наступні поля:

• 4 -> Name: вкажіть зрозуміле ім'я для вашого підключення (наприклад, "Prod auth"), для майбутньої швидкої ідентифікації.
• 5 -> Login: ваш логін або Username у сервісі.
• 6 -> Password: ваш пароль або API Secret.

7 -> Save: Натисніть кнопку Save всередині спливаючого вікна, щоб зберегти введені дані нового акаунту.

8 -> Вибір акаунту: У списку акаунтів оберіть щойно створений акаунт.

9 -> Кнопка Save (у Flow Test): Натисніть Save на панелі Flow Test. Це закріпить обраний акаунт за поточною сесією розробки.

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

FAQ

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

1. Чи потрібно мені самому кодувати логін та пароль у Base64?
Ні. Платформа робить це автоматично. Ви просто вводите чистий текст у поля Login та Password, а система перетворює їх на вигляд 0YTRltCyOtGE0ZbQsg== під час відправки запиту.

2. Що робити, якщо замість пароля сервіс видає "API Key" або "Secret"?
У методі Basic Auth поле Password часто використовується для введення API Secret, якщо логін залишається статичним або порожнім. Перевірте документацію вашого сервісу.

3. Чи безпечно вводити пароль у полі Password?
Так. Пароль зберігається в зашифрованому сховищі акаунтів і ніколи не відображається у відкритому вигляді в коді самої інтеграції.

4. Чому я отримую 401 помилку, хоча логін і пароль правильні?
Переконайтеся, що ви натиснули Run Test після додавання акаунту. Також перевірте, чи не додає сервіс додаткових вимог.

5. Чи потрібно вручну додавати заголовок Authorization в HTTP Request?
Ні. Якщо використовується Basic у Authentication Flow, заголовок додається автоматично до всіх запитів інтеграції.

6. Чи можу я змінити пароль без редагування флоу?
Так. Достатньо відредагувати акаунт у Flow Test, зберегти зміни та повторно виконати Run Test.

7. Чи впливає Basic на Account Validation Flow?
Так. Усі запити в Account Validation виконуються вже з авторизацією Basic. Некоректні дані призведуть до невалідного акаунту.