Типы секретов и материализация
Секрет в 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 КиБ. Для больших данных, генерируемых артефактов и файлов, которые рабочая нагрузка должна обновлять независимо, используйте хранилище.
Выбор и приоритет
При создании песочницы передается список имен секретов, и шлюз разрешает каждую запись в активном аккаунте. Все имена должны существовать: если прямая ссылка неизвестна, создание песочницы не начинается.
Правила объединения:
- Конфигурация песочницы, заданная напрямую, побеждает материализованные секреты.
- Записи
envконфликтуют по имени переменной, учетные данные Git — по хосту, MCP-серверы — по имени. - Если конфликтуют два секрета, побеждает запись с большим внутренним ID секрета. Порядок имен в запросе не задает приоритет.
- Репозитории, SSH-ключи, учетные данные реестров и файлы добавляются к спискам.
Не полагайтесь на порядок внутренних ID. Уберите пересекающиеся ключи или имена либо задайте нужное переопределение явно, напрямую.
Необязательные учетные данные сохраненного репозитория — косвенная ссылка. Если
такой секрет отсутствует или имеет тип, отличный от git_credential,
клонирование не получит учетных данных, и приватный клон может завершиться
ошибкой подготовки.
Hosted MCP разрешает только секреты типа env. Неизвестная ссылка или любой
другой тип останавливает развертывание; переменные сервиса, заданные напрямую,
по-прежнему побеждают для совпадающего ключа.
Маскированные значения
Ответы со списком и с одной записью возвращают метаданные и preview в открытом
виде, но никогда не сохраненное значение, шифртекст или одноразовое число
шифрования. Маскированное значение помогает распознать запись, поэтому доступно
всем, кто может просматривать секреты аккаунта.
| Тип | Маскированное значение в открытом виде |
|---|---|
env | Имена переменных |
git_credential | Хост, имя пользователя, последние четыре символа токена |
repo | Полная спецификация клонирования |
mcp_server | Имя сервера, хост URL, транспорт |
ssh_key | Определенный тип ключа, имя файла |
registry_credential | Реестр, хост, область, последние четыре символа токена |
file | Путь, права, декодированный размер |
Выбирайте имена, описания, пути, URL, имена хостов, имена пользователей и области с учетом этой видимости. Эти поля метаданных не являются хранилищем секретов.