Область действия и доступ
Каждый секрет принадлежит ровно одному аккаунту Just Run. Контекст активного аккаунта, а не поле запроса или имя секрета, определяет, где запись создается, показывается, обновляется и разрешается.
personal context ──► Secrets личного account
organization context ──► Secrets account организации
├─ private: автору и owner/admin организации
└─ org: всем участникам организации
Имена уникальны только внутри аккаунта. В личном аккаунте и организации могут
одновременно существовать секреты с именем github-token; получатель разрешит
запись из контекста своего текущего аккаунта.
Секреты личного аккаунта и организации
| Активный контекст | Просмотр метаданных и использование ссылки | Создание, обновление и удаление |
|---|---|---|
| Личный аккаунт | Владелец аккаунта | Владелец аккаунта |
| Аккаунт организации | org: все участники; private: автор и пользователи с ролью Владелец или Администратор | Автор — свои секреты; пользователи с ролью Владелец или Администратор — все |
До создания секрета выберите нужный аккаунт. По умолчанию новый секрет получает
private; в организации укажите visibility: "org", чтобы открыть его всем
участникам. Поле visibility не переносит секрет в другой аккаунт. В личном
аккаунте используется private.
visibility управляет доступом к метаданным секрета и новым ссылкам внутри
организации. Другой участник получает 404 для чужого секрета private даже
по известному ID. Для изменения видимого секрета org без права записи ответ
403. Списка допустимых участников для отдельного секрета, списка допустимых
получателей и общего доступа между аккаунтами нет.
Запрос ID секрета за пределами активного аккаунта возвращает 404, не
подтверждая существование ID в другом месте. Ссылки также разрешаются только
внутри активного аккаунта.
Роли в организации
Участники организации могут создавать свои секреты и управлять ими. Пользователи с ролью Владелец или Администратор могут управлять любым секретом организации. Веб-интерфейс показывает действия изменения и удаления по правам на каждую запись.
При этом участники могут:
- просматривать доступные маскированные метаданные и маскированные значения;
- ссылаться на секреты
orgв получателях, которые им разрешено создавать или развертывать; - использовать получившуюся песочницу или сервис Hosted MCP в соответствии с правами самого получателя.
Доступ к секрету org перестает быть границей конфиденциальности, когда
участник может материализовать его у получателя. Пользователь, способный
выполнять команды в получившейся песочнице, обычно может прочитать ее
переменные окружения, файлы или конфигурацию учетных данных. Помещайте секрет
только в ту организацию, операторам получателей которой можно доверить его
значение.
API песочниц заменяет значения из секретов env в env_vars маской и
перечисляет их ключи в redacted_env_keys. У старых песочниц с неизвестным
происхождением скрыты все значения переменных окружения. Оператор песочницы все
еще может прочитать значения внутри VM. Значения переменных окружения, заданные
напрямую, остаются читаемыми через API песочниц.
Сессии и персональные токены
Аутентифицированные сессии браузера и персональные токены с правами full
подчиняются описанным выше правилам аккаунта и роли в организации.
Персональный токен с правами read_only может вызывать безопасные эндпоинты
чтения, но общий слой авторизации REST отклоняет запросы на создание, изменение
и удаление.
Персональный токен с правами full не обходит роли в организации и владение
секретом.
Секрет private организации можно подключить к новой личной песочнице
(включая создание через E2B) или личной среде выполнения Hosted MCP того же
автора. Общие получатели отклоняют его до копирования значения. Для секретов
private личного аккаунта и секретов org организации действуют прежние пути
использования.
Имена и ссылки
Имя секрета:
- содержит от 1 до 64 ASCII-символов;
- допускает буквы, цифры,
-и_; - чувствительно к регистру;
- должно быть уникально внутри аккаунта.
Получатели ссылаются на секрет по имени, а не по ID в базе данных. Поэтому переименование или удаление ломает будущие ссылки, которые продолжают использовать старое имя. Неизвестная прямая ссылка останавливает операцию до создания песочницы или успешного развертывания Hosted MCP.
Считайте имя стабильным интерфейсом конфигурации. Предпочитайте долговечное
логическое имя вроде github-release-bot и ротируйте его значение на месте.
Создавайте новое имя, когда старые и новые учетные данные должны сосуществовать
во время поэтапной миграции.
Материализация создает снимок
При создании песочницы шлюз:
- загружает все запрошенные имена из активного аккаунта клиента;
- расшифровывает и проверяет типизированные значения;
- объединяет их с конфигурацией создания песочницы;
- удаляет ссылки по именам перед передачей запроса дальше.
Управляющий компонент и песочница получают материализованные данные, а не живую
связь с записью секрета. Тот же принцип действует, когда Hosted MCP разрешает
ссылки типа env во время развертывания.
Следствия:
- обновление секрета влияет только на последующие создания или развертывания;
- смена видимости ограничивает последующие чтения и ссылки, но не отзывает значения, уже скопированные в среду выполнения;
- удаление секрета не стирает копии из уже созданных активных или остановленных песочниц;
- если существующие копии должны перестать работать, учетные данные нужно отозвать у внешнего провайдера;
- получатель не может разрешить секрет из другого аккаунта, даже зная его имя.
Ссылка предоставляет всю типизированную запись. Секрет типа env с пятью
переменными материализует все пять; синтаксиса выбора одного ключа нет.
Разделяйте записи, если значения имеют разные аудитории или графики ротации.
Шифрование при хранении и маскированные значения
Значения секретов зашифрованы при хранении с помощью ключа шифрования данных
аккаунта. API секретов (создание, чтение, обновление, удаление) не предоставляет
операции раскрытия значения: ответы со списком и с одной записью содержат тип,
временные метки, описание, видимость и маскированное значение (preview), но
не исходное значение.
Маскированные значения хранятся и возвращаются в открытом виде пользователям с доступом к секрету. В зависимости от типа они показывают имена переменных, хосты, имена пользователей, пути, окончания токенов или даже полную спецификацию сохраненного репозитория. Эти метаданные видит каждый, кому доступен секрет.
Шифрование при хранении защищает сохраненные значения, но не означает, что шлюз, путь до управляющего компонента или рабочая нагрузка получателя никогда не работают со значением в открытом виде. Для материализации получатель должен получить пригодное к использованию значение.
Контрольный список перед добавлением секрета
Перед добавлением секрета определите:
- какой личный аккаунт или аккаунт организации им владеет;
- кто может создавать и управлять получателями в этом аккаунте;
- содержит ли одна типизированная запись только значения с общей аудиторией;
- какие метаданные допустимо раскрыть в имени, описании и маскированном значении;
- как будут отозваны уже материализованные копии при ротации или реагировании на инцидент.