Секреты рабочего пространства
Держите токены и секретные 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_…), которым подписываются все его доставки. Администраторы и владелец показывают и меняют его в Настройки → Назначения → Секрет подписи — см. Проверка подписи и Смена секрета подписи.
Функции
Пусть по результату действует ваш собственный код — ответ называет функцию и её параметры, а SDK для TypeScript и Python вызывают зарегистрированный вами обработчик, по порядку и один раз за вызов.
Доставка и повторные попытки
Как Dcision доставляет вебхуки, API-запросы, workflows и передачу агентам — минимум один раз, шесть попыток примерно за семь часов, Retry-After, тайм-ауты, статусы, повторная отправка и хранение.