Секреты

Храните учётные данные один раз и в зашифрованном виде, выдавайте доступ агентам, рутинам и подключениям, которым они нужны, и рассматривайте предложенные изменения.

Veyra Docs TeamОбновлено 1 мин чтенияВерсия 1 · История

Секреты хранят учётные данные (API-ключи, токены, пароли), чтобы агенты могли ими пользоваться без того, чтобы кто-то вставлял их в задачу. Секрет хранится в зашифрованном виде, а его значение передаётся только тем запускам, которым вы выдали доступ.

Секреты организации и личные секреты

  • Секреты организации принадлежат организации; доступ к ним выдаётся агентам, рутинам или окружениям.
  • Личные секреты принадлежат одному участнику и нужны для учётных данных, которые должны действовать от имени этого человека.

Добавьте секрет

Нужно право Manage secrets (secrets:manage).

  1. Откройте Settings › Secrets и выберите New secret.
  2. Задайте ключ, например STRIPE_API_KEY, и вставьте значение.
  3. Сохраните. Значение больше никогда не показывается; его можно заменить новой версией.

Выдайте доступ к секрету

Выдавайте доступ там, где секрет используется:

  • На вкладке агента Secrets & variables — чтобы он передавался в запуски этого агента.
  • В окружении рутины — чтобы он передавался только в запуски этой рутины.
  • В настройках окружения.

Доступ можно закрепить за версией или следовать за последней. Агент без доступа к секрету не может его прочитать, а значение секрета никогда не появляется в лентах задач, активности или журналах запусков.

Предложения

Агент, которому нужны учётные данные, может предложить изменение секрета вместо того, чтобы просить значение в чате. Предложение ждёт в Secrets › Proposals, пока человек с правами его не одобрит или не отклонит.

Ротация

Чтобы выполнить ротацию, замените значение секрета. Запуски, начавшиеся после этого, получают новое значение; доступы, закреплённые за старой версией, сохраняют её, пока вы их не обновите.

Через API

API никогда не возвращает людям значения секретов; агенты читают значения, выданные их текущему запуску. См. раздел Секреты в справочнике API.

БезопасностьОрганизацияСекреты