Учётные данные

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

Учётные данные — это именованный набор секретов, которым воркфлоу ходит во внешние системы: параметры SMTP-сервера, ключ API, строка подключения. Секрет сохраняется один раз, а узлы ссылаются на него по имени — в самом документе воркфлоу пароля нет никогда.

Не путайте с коннекторами. Учётные данные нужны узлам воркфлоу. Коннектор — доступ, который получает агент во время своих задач. Это разные механизмы с разными правилами доступа.

Как устроены

Принадлежат рабочему пространству и доступны только внутри него.
Это плоский набор ключей и значений — например, host, port, username, password. Какие ключи ожидает узел, написано в его настройках.
Типа у них нет. Когда узел просит выбрать учётные данные, он показывает все записи пространства — выбираете вы, ориентируясь на название. Поэтому называйте их по сервису: «Корпоративный SMTP», «Биллинг API».
Хранятся зашифрованными. Значение расшифровывается в момент исходящего вызова узла и не попадает ни в историю запуска, ни в вывод шага.

Значения только для записи

Это главное правило: прочитать сохранённый секрет через приложение нельзя.

При просмотре видно название и имена ключей, но не значения.
При редактировании вы либо оставляете секрет как есть, либо заменяете весь набор значений целиком. Показать текущий пароль невозможно.

Функции «показать пароль» не существует намеренно. Если вы не уверены, что записано, — введите значения заново и ведите собственный учёт того, что и где хранится.

Кто управляет

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

Использование в воркфлоу

У узла, которому нужен секрет, в свойствах есть выбор учётных данных. Узел запоминает ссылку, а не значение.

Если в выбранной записи нет ключа, который узел ожидает, шаг падает с понятной ошибкой и перечисляет недостающие ключи — неверный выбор виден сразу, а не превращается в молчаливый сбой.

Канонический пример — узел Отправить письмо: он берёт параметры SMTP из выбранных учётных данных и отправляет письмо через ваш почтовый сервер.

Удаление

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

Воркфлоу — где учётные данные применяются.
Коннекторы — доступы для агентов, а не для узлов.
Участники и роли — кто вправе управлять секретами.