Секреты рабочего пространства

Держите токены и секретные URL вне решений — секреты рабочего пространства через {{secrets.NAME}}, кто может ими управлять, как они хранятся и маскируются и когда применяются изменения.

API-токенам, паролям и секретным URL — URL вебхука Slack или n8n — не место в решении: схема версионируется, показывается в редакторе и сохраняется при каждой публикации. Храните их в секретах рабочего пространства и ссылайтесь на них по имени.

Добавление секрета

В Настройки → Назначения → Секреты введите имя и значение и нажмите Добавить секрет (или Заменить для существующего имени).

  • Имена пишутся в UPPER_SNAKE_CASE: заглавная буква, затем заглавные буквы, цифры и _, до 64 символов — CRM_TOKEN, SLACK_WEBHOOK.
  • Значения длиной от 1 до 4 096 символов и доступны только для записи: после сохранения приложение показывает имя, последние 4 символа (администраторам) и время изменения — но никогда само значение.
  • Рабочее пространство хранит до 50 секретов.

Использование

Пишите {{secrets.NAME}} там, где он нужен назначению:

ГдеПример
Значение заголовкаAuthorization: Bearer {{secrets.CRM_TOKEN}}
Весь URL{{secrets.SLACK_WEBHOOK}} как URL API-запроса или вебхука
Тело http{"api_key": {{secrets.MAILER_KEY}}}

Секрет может быть началом URL — всем URL — или частью заголовка либо тела. Секреты нельзя использовать в готовых ответах, промптах и входных данных LLM или в инструкциях агента: этот текст возвращается вызывающей стороне или отправляется модели.

Кто что может

НаблюдательУчастникАдминистраторВладелец
Видеть имена секретов (чтобы писать шаблоны)—✓✓✓
Видеть последние 4 символа——✓✓
Добавлять, заменять и удалять секреты——✓✓
Показывать и менять секрет подписи——✓✓

Как они защищены

  • Зашифрованы при хранении с помощью AES-256-GCM. Значения никогда не покидают API, кроме как внутри запроса, в который они подставлены.
  • Никогда не попадают в схему решения, ответ API, журнал выполнений или Playground: предпросмотр показывает вместо них ••••, а журнал доставок хранит только замаскированный предпросмотр каждого запроса — метод, URL, заголовки и размер тела.
  • Полный запрос с секретами хранится в зашифрованном виде, пока он ещё может понадобиться доставке, — см. Доставка и повторы.

Когда применяются изменения

Секреты читаются в момент запуска решения: Dcision подставляет текущие значения в запрос и сохраняет его в зашифрованном виде для попыток доставки.

  • Новое или изменённое значение применяется к следующим запускам. Уже поставленные в очередь доставки — и их повторы — сохраняют запрос, с которым были сформированы.
  • Назначение, ссылающееся на несуществующий секрет, сразу проваливает доставку с сообщением "Set the secret CRM_TOKEN in Settings → Destinations, then resend." — ничего не отправляется. Поскольку запрос был сформирован без секрета, добавьте его и запустите решение снова: повторная отправка этой доставки завершится так же. Агент в режиме sync возвращает "status": "failed" с тем же советом.
  • Удаление секрета приводит к сбою назначений, которые его используют, пока он не будет задан снова.

Секрет подписи

Помимо этих секретов, у каждого рабочего пространства есть один секрет подписи (whsec_…), которым подписываются все его доставки. Администраторы и владелец показывают и меняют его в Настройки → Назначения → Секрет подписи — см. Проверка подписи и Смена секрета подписи.

На этой странице