Перейти к основному содержимому
Открыть Markdown

Секреты

Секрет — это именованная типизированная конфигурация, принадлежащая аккаунту Just Run. Создайте ее один раз, затем укажите имя при создании песочницы или развертывании сервера Hosted MCP. Получатель получит готовые переменные окружения, файлы, учетные данные или конфигурацию, а запрос создания не должен передавать сохраненное значение.

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

Возможности​

  • Хранить переменные окружения, учетные данные Git и реестров, SSH-ключи, файлы, сохраненные репозитории и конфигурацию удаленных MCP-клиентов.
  • Просматривать имена, типы, описания, временные метки и маскированные значения, не раскрывая сохраненные значения через API секретов.
  • Выбирать одну или несколько записей при создании песочницы.
  • Добавлять записи env в окружение сервиса Hosted MCP во время развертывания.
  • Полностью заменять значение, сохраняя стабильное имя ссылки.
  • Проверять метаданные использования, которые обновляются без гарантий, и активность аккаунта во время ротации или расследования.

Хранилище секретов настраивается на уровне инсталляции. Если ключ шифрования не настроен, его API возвращает HTTP 503.

Ментальная модель​

personal или organization account
│
▼
именованный typed Secret
├── cleartext metadata и masked preview
└── зашифрованное сохраненное значение
│ reference по имени
├── создание sandbox
│ └── environment, файлы, credentials, репозитории
│ или конфигурация MCP client
└── deploy Hosted MCP
└── окружение сервиса (только `env`)

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

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

Выбор получателя​

ПолучательПоддерживаемые секретыМомент разрешенияКак применить ротированное значение
ПесочницаВсе типы секретовПеред созданием песочницыСоздать заменяющую песочницу
Hosted MCPТолько envВо время развертыванияВыполнить повторное развертывание инстанса Hosted MCP

Используйте секрет для песочницы, когда рабочей нагрузке нужны переменные окружения, файл, доступ к репозиторию, аутентификация в реестре, SSH-ключ или конфигурация удаленного MCP-клиента.

Используйте ссылку на секрет в Hosted MCP для переменных, необходимых процессу сервера Hosted MCP. Секрет типа mcp_server устроен иначе: он настраивает MCP-клиент внутри песочницы для обращения к удаленному MCP-серверу.

Основные точки входа​

ИнтерфейсНазначение
Секреты в веб-интерфейсеСоздание, просмотр, обновление и удаление типизированных записей
REST API /v1/secretsСоздание, чтение, обновление и удаление с маскированием значений для автоматизации и интеграций
secrets в запросе создания песочницыМатериализация выбранных записей по имени
secret_refs в Hosted MCPОбъединение выбранных записей env во время развертывания

Сессии браузера и API-клиенты работают в контексте активного аккаунта. Пользователи личного аккаунта управляют собственным списком секретов. Участники организации могут просматривать маскированные общие записи и указывать их у получателей, которые им разрешено создавать, а самими записями управляют пользователи с ролью Владелец или Администратор организации.

Краткий жизненный цикл​

  1. Выберите личный аккаунт или аккаунт организации, которому должен принадлежать секрет.
  2. Выберите тип и создайте стабильное информативное имя.
  3. Укажите это имя у получателя из того же аккаунта.
  4. Дождитесь подготовки песочницы или развертывания Hosted MCP, прежде чем использовать материализованную конфигурацию.
  5. Для ротации полностью замените сохраненное значение, затем пересоздайте или повторно разверните каждого затронутого получателя.
  6. Отзовите старые учетные данные у внешнего провайдера, когда существующие копии должны перестать работать.
  7. Удалите исходную запись, когда ее имя больше не используется в будущей конфигурации.

Удаление секрета запрещает последующее разрешение. Оно не удаляет значения, уже скопированные в песочницу, окружение процесса, файл конфигурации или песочницу, в которой работает сервер Hosted MCP.

Граница безопасности​

Значения секретов шифруются перед записью в базу данных и не возвращаются операциями получения списка и получения записи. Имена, описания и маскированные значения, зависящие от типа, — это метаданные в открытом виде, доступные тем, кто может просматривать список секретов аккаунта.

Доступ к получателю означает доступ к значению

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

Разделяйте по разным записям значения с разными аудиториями или графиками ротации. Не используйте секреты для крупных изменяемых файлов или артефактов сборки — для этого предназначено хранилище. Не считайте удаление отзывом учетных данных: этот контроль принадлежит внешнему провайдеру.

Подробнее о секретах​