Як використати збережені секрети для сценаріїв у Send Request?

У Scenario Builder нода Send Request може брати секрети з Секретів для сценаріїв (Налаштування) через Вставити посилання на секрет у URL, заголовки або body — без вводу токена або пароля вручну.

Коли знадобиться

  • API вимагає Bearer/Basic/API key у URL, заголовку або JSON body, і ключ уже збережено в Секретах для сценаріїв.
  • Потрібно один ключ у query (?token=…) і другий у заголовку Authorization.
  • Після ротації ключа в Налаштуваннях сценарії мають працювати без редагування кожної ноди.

Що важливо знати

  • Можливість увімкнена адміністратором інстансу (перемикачі функцій у Налаштування інстансу). Без цього кнопки вставки секрету не з’являться — використовуйте Basic/Bearer як раніше.
  • У сценарії зберігається посилання (текстовий маркер), не значення секрету. Розшифрування лише на сервері під час виконання запиту.
  • Кнопки в інтерфейсі Send Request:
    • Вставити auth header — додає автентифікацію в заголовок Authorization.
    • Вставити посилання на секрет — вставляє поле обраного секрету в URL, значення заголовка або body.
  • Несекретні заголовки (ID клієнта, мова) додавайте вручну з плейсхолдерами {{variable}}.
  • Старі ноди з полем Credential (випадаючий список) або Basic/Bearer у параметрах продовжують працювати — їх не треба змінювати без потреби.

Перед початком

  • Адміністратор увімкнув Секрети для сценаріїв і створив потрібний запис (див. керування секретами).
  • У запису в Дозволені споживачі дозволено Send Request.
  • У вас є доступ до редагування сценарію в Scenario Builder.
  • Відкрито сценарій з нодою Action → Send Request.

Покрокова інструкція

1. Відкрити конфігурацію Send Request

  1. На полотні клацніть ноду Action з шаблоном Send Request.
  2. У Node Inspector (права панель) переконайтеся, що обрано режим Форма (не лише JSON), якщо доступний перемикач форма/JSON.

2. Вставити секрет у URL (за потреби)

  1. У блокі Method + URL клацніть іконку ключа біля поля URL (Вставити посилання на секрет).
  2. Оберіть запис і поле (наприклад, значення API key).
  3. Маркер вставиться в URL — типово для query-параметра ?token=….

3. Налаштувати автентифікацію в заголовках

  1. У блокі Headers натисніть Вставити auth header.
  2. Система додасть заголовок Authorization з посиланням на обраний секрет (Bearer або Basic).
  3. Для API key у нестандартному заголовку використайте Вставити посилання на секрет у значенні потрібного заголовка.

4. Вставити секрет у body (за потреби)

  1. У блокі Body оберіть формат (JSON, form data тощо).
  2. Для JSON — Вставити посилання на секрет у редакторі body; для пари ключ/значення — іконка ключа біля поля значення.
  3. Підходить для client_secret, токенів у JSON body та form fields.

5. Зберегти та протестувати

  1. Натисніть Зберегти сценарій.
  2. Запустіть тест сценарію або перевірте виклик на stage.
  3. При помилці автентифікації — перевірте тип запису, Ротація секрету або список дозволених дій у Налаштуваннях.

Старі ноди (поле Credential або Basic/Bearer)

  • Credential (випадаючий список) — legacy UX; нові ноди налаштовуйте через вставку полів.
  • Basic auth / Bearer auth без збереженого секрету — працюють як до появи Секретів для сценаріїв.
  • Інформаційний блок Legacy auth показує збережені старі поля без зміни їх автоматично.

Імпорт сценарію

Якщо після імпорту з’явилось попередження про секрет — створіть запис з потрібним slug у Налаштуваннях або вручну виберіть інший запис у ноді. Inline-маркери зіставляються по slug на цільовому інстансі.

Пов’язані статті