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

Типы секретов и материализация

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

зашифрованный Secret
│ ссылка по имени
▼
gateway расшифровывает и проверяет
│
├── создание sandbox → env, файлы, credentials, repositories, MCP config
└── deploy Hosted MCP → environment variables процесса

Это передача при создании или развертывании, а не брокер секретов времени выполнения. После материализации значение становится обычными данными внутри песочницы или сервиса Hosted MCP. Обновление или удаление исходного секрета не меняет уже запущенного получателя.

Материализованное значение можно прочитать

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

Поддерживаемые типы​

ТипПоддерживаемые получатели
envПесочница и Hosted MCP
git_credentialПесочница
repoПесочница
mcp_serverПесочница
ssh_keyПесочница
registry_credentialПесочница
fileПесочница

Сейчас веб-интерфейс предлагает формы npm, pip, Cargo и Docker для registry_credential. Это пресеты интерфейса, а не исчерпывающее публичное перечисление значений. Ниже описано, что содержит каждый тип и как его использует песочница.

mcp_server — не Hosted MCP

Секрет типа mcp_server настраивает MCP-клиент внутри песочницы для обращения к удаленному серверу. Hosted MCP запускает MCP-сервер на Just Run и принимает только ссылки на секреты типа env для окружения собственного процесса.

Поведение типов​

Переменные окружения​

Секрет типа env группирует одну или несколько пар «ключ — значение». В маскированное значение попадают только отсортированные имена переменных.

Для песочницы значения из секрета заполняют env; значение, заданное напрямую в запросе создания песочницы, побеждает при совпадении ключа. Hosted MCP применяет то же правило «заданное напрямую побеждает» к окружению сервиса.

Объединяйте в одной записи значения с общим владельцем и графиком ротации. Не смешивайте несвязанные учетные данные рабочей среды и среды разработки: получатель ссылается на запись целиком, а не на отдельные переменные.

Учетные данные Git и сохраненные репозитории​

Секрет типа git_credential хранит HTTPS-аутентификацию для одного хоста Git. Маскированное значение показывает хост, имя пользователя и последние четыре символа токена. При материализации в песочницу учетные данные дедуплицируются по хосту.

Секрет типа repo — сохраненная спецификация клонирования: URL, необязательный ref, целевой путь, глубина неполного клонирования, политика ошибки и необязательное имя секрета типа git_credential. При выборе запись добавляет репозиторий в подготавливаемую песочницу. Если указаны учетные данные, шлюз автоматически разрешает и эту связанную запись.

Полная спецификация repo хранится в открытом виде как маскированное значение, потому что реализация считает ее нечувствительной. Не помещайте учетные данные в URL репозитория, ref или путь. HTTPS-токены храните в git_credential.

Конфигурация MCP-сервера​

Секрет типа mcp_server содержит имя удаленного сервера, URL и необязательные HTTP-заголовки. При создании песочницы он записывается в конфигурацию MCP-клиента для Claude Code. Маскированное значение показывает имя, хост и транспорт URL, но не значения заголовков.

Несколько материализованных MCP-серверов дедуплицируются по имени. Заданный напрямую сервер с таким же именем побеждает.

SSH-ключи​

Секрет типа ssh_key содержит приватный ключ, а также необязательные публичный ключ, known_hosts и целевое имя файла. Если имя файла не задано, Just Run выбирает id_rsa для RSA-ключа и id_ed25519 в остальных случаях. Маскированное значение содержит определенный тип ключа и имя файла, но не сам ключ.

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

Учетные данные реестров​

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

Такие записи добавляются в подготавливаемую песочницу. Храните одни авторитетные учетные данные для конкретного реестра: в отличие от переменных окружения, механизм материализации не определяет для этого типа ключ дедупликации.

Файлы​

Секрет типа file хранит произвольные байты в base64 вместе с целевым путем и правами доступа Unix. Права по умолчанию — 0600. Маскированное значение показывает целевой путь, права и размер декодированных данных.

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

Выбор и приоритет​

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

Правила объединения:

  1. Конфигурация песочницы, заданная напрямую, побеждает материализованные секреты.
  2. Записи env конфликтуют по имени переменной, учетные данные Git — по хосту, MCP-серверы — по имени.
  3. Если конфликтуют два секрета, побеждает запись с большим внутренним ID секрета. Порядок имен в запросе не задает приоритет.
  4. Репозитории, SSH-ключи, учетные данные реестров и файлы добавляются к спискам.

Не полагайтесь на порядок внутренних ID. Уберите пересекающиеся ключи или имена либо задайте нужное переопределение явно, напрямую.

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

Hosted MCP разрешает только секреты типа env. Неизвестная ссылка или любой другой тип останавливает развертывание; переменные сервиса, заданные напрямую, по-прежнему побеждают для совпадающего ключа.

Маскированные значения​

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

ТипМаскированное значение в открытом виде
envИмена переменных
git_credentialХост, имя пользователя, последние четыре символа токена
repoПолная спецификация клонирования
mcp_serverИмя сервера, хост URL, транспорт
ssh_keyОпределенный тип ключа, имя файла
registry_credentialРеестр, хост, область, последние четыре символа токена
fileПуть, права, декодированный размер

Выбирайте имена, описания, пути, URL, имена хостов, имена пользователей и области с учетом этой видимости. Эти поля метаданных не являются хранилищем секретов.