Як керувати секретами для сценаріїв?

Централізоване сховище для API-ключів, токенів і паролів, які використовують Send Request та custom actions у сценаріях. Секрети зберігаються зашифровано; у сценарії лишається лише посилання на запис.

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

• Потрібно один раз зберегти Bearer/API key/OAuth secret і використовувати в кількох сценаріях.
• Треба змінити (ротувати) ключ без редагування кожної ноди Send Request.
• Потрібно знайти, де в сценаріях ще лежать «inline» токени в constants або параметрах нод.

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

• Секрети для сценаріїв — окрема вкладка в Налаштування (маршрут /settings-page/credentials, у меню — Секрети для сценаріїв).
• Доступність — можливість вимкнена за замовчуванням. Root-адміністратор увімкне її в Налаштування інстансу (перемикачі функцій платформи), потім надайте права ролям.
• Права: перегляд (Перегляд у ролі) і збереження (Збереження у ролі) — окремі дозволи в розділі Налаштування → Ролі → Секрети для сценаріїв.
• Не плутати з токенами каналів (Telegram/Viber), ключами Mailgun чи ключами AI — вони налаштовуються в інших розділах.
• Видалення: запис, який використовується в сценарії (включно з inline-посиланнями в URL/headers/body), не видалиться — спочатку зніміть посилання або оберіть інший запис у нодах.

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

• Root-адміністратор увімкнув Секрети для сценаріїв для інстансу.
• У вашої ролі є право переглядати або зберігати секрети для сценаріїв.
• Ви увійшли в Налаштування (/settings-page).

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

1. Відкрити вкладку секретів

1. У головному меню оберіть Меню → Налаштування (або перейдіть за адресою /settings-page).
2. У бічному меню оберіть Секрети для сценаріїв.
3. Якщо вкладки немає — перевірте перемикачі функцій платформи (root) і права ролі.

2. Створити запис

1. Натисніть Додати секрет.
2. Заповніть:
   • Назва — зрозуміла назва (наприклад, «CRM production API»).
   • Slug — унікальний ідентифікатор латиницею (наприклад, crm-main); після використання змінити важко.
   • Тип — тип секрету: Bearer, Basic, API key, OAuth2 client credentials, SMTP, Telegram bot, HMAC тощо.
   • Дозволені споживачі — які дії можуть використовувати запис (для Send Request оберіть Send Request у списку).
3. Заповніть поля секрету (token, login/password, headers тощо).
4. Натисніть Зберегти. Поля секрету очистяться — це очікувана поведінка.

3. Редагувати метадані

1. У таблиці оберіть Редагувати секрет біля запису.
2. Змініть назву, опис або дозволених споживачів.
3. Значення секрету не показується при редагуванні. Щоб змінити секрет — використовуйте Ротація секрету.

4. Ротувати секрет

1. Оберіть Ротація секрету для потрібного запису.
2. Введіть нове значення (token, password тощо).
3. Збережіть. Усі сценарії з посиланням на цей запис (inline або legacy) використовуватимуть новий секрет без зміни нод.

5. Переглянути використання

1. Відкрийте Використання запису (іконка списку в рядку або колонка Використання).
2. Перегляньте список: бот, секція, нода, дія.
3. Якщо потрібно видалити запис — спочатку приберіть посилання на секрет у цих місцях у Scenario Builder.

6. Сканування legacy-секретів

1. Натисніть Сканувати застарілі секрети.
2. Перегляньте вкладки: Константи, Ноди Send Request, Кастомні дії (Action Jail).
3. Зразки значень масковані. Створіть нові записи і перенесіть посилання вручну — автоматичної міграції немає.
4. Для custom actions скопіюйте підказки для міграції коду (без розкриття секретів).

7. Видалити запис

1. Переконайтеся, що у колонці Використання — 0.
2. Натисніть Видалити і підтвердіть.
3. Якщо запис ще використовується — система покаже помилку; відкрийте Використання запису і зніміть посилання.

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

• Що таке секрети для сценаріїв
• Використати секрет у Send Request
• Використати секрет у custom action Action Jail
• Налаштувати ролі
• Налаштувати параметри інстансу