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

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

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

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

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

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

## Поддерживаемые типы[​](#supported-types "Прямая ссылка на Поддерживаемые типы")

| Тип                   | Поддерживаемые получатели |
| --------------------- | ------------------------- |
| `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` для окружения собственного процесса.

## Поведение типов[​](#how-each-type-behaves "Прямая ссылка на Поведение типов")

### Переменные окружения[​](#environment-variables "Прямая ссылка на Переменные окружения")

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

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

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

### Учетные данные Git и сохраненные репозитории[​](#git-credentials-and-saved-repositories "Прямая ссылка на Учетные данные Git и сохраненные репозитории")

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

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

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

### Конфигурация MCP-сервера[​](#mcp-server-configuration "Прямая ссылка на Конфигурация MCP-сервера")

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

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

### SSH-ключи[​](#ssh-keys "Прямая ссылка на SSH-ключи")

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

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

### Учетные данные реестров[​](#registry-credentials "Прямая ссылка на Учетные данные реестров")

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

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

### Файлы[​](#files "Прямая ссылка на Файлы")

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

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

## Выбор и приоритет[​](#selection-and-precedence "Прямая ссылка на Выбор и приоритет")

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

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

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

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

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

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

## Маскированные значения[​](#masked-previews "Прямая ссылка на Маскированные значения")

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

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

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

## Связанные разделы[​](#related "Прямая ссылка на Связанные разделы")

* [Область действия и доступ](/secrets/scope-and-access.md)
* [Создание и управление секретами](/secrets/create-and-manage.md)
* [Использование секретов с песочницами](/secrets/use-with-sandboxes.md)
* [Использование секретов с MCP-хостингом](/secrets/use-with-mcp-hosting.md)
* [Секреты и данные](/security/secrets-and-data)
