Аккаунты и доступ
Аккаунт — граница владения и изоляции ресурсов Just Run. У каждого аутентифицированного запроса есть один активный контекст аккаунта: ваш личный аккаунт или организация, в которой вы состоите. Песочницы, шаблоны, объекты хранилища, секреты, автоматизации, серверы Hosted MCP, квоты, потребление и активность аккаунта разрешаются относительно этого контекста.
При переключении контекста ваша учетная запись не меняется. Меняется аккаунт, в котором вы работаете.
Ментальная модель
user identity
│
├── personal account ───────────────┐
│ │
└── organization memberships ──► choose active context
│
access or refresh token ─┤
▼
account-scoped resources
quotas · usage · activity
Аутентификация устанавливает, кто вы. Контекст аккаунта определяет, к какому аккаунту относится запрос. Роль в организации управляет операциями над самой организацией, но не заменяет активный контекст аккаунта.
Личный аккаунт и организация
| Тип аккаунта | Кто может использовать | Типичный сценарий |
|---|---|---|
| Личный | Его пользователь | Индивидуальная разработка, эксперименты и пользовательские учетные данные |
| Организация | Пользователи из списка участников | Общие ресурсы, общие лимиты и потребление, управление командой |
У вошедшего пользователя всегда есть личный контекст. Создание организации добавляет еще один аккаунт и делает создателя первым владельцем. После этого в организацию можно добавлять по email других уже существующих пользователей Just Run.
Ресурсы принадлежат аккаунту, а не человеку, который последним их изменил. Переключение из организации не останавливает и не переносит ее ресурсы — оно меняет область последующих запросов на чтение и создание.
Активный контекст аккаунта
Откройте Аккаунт из меню аккаунта в веб-интерфейсе. Экран Организация показывает доступные текущему пользователю контексты. При переключении выпускается новая пара токенов (доступа и обновления) для выбранного аккаунта, очищается кэш запросов интерфейса и открывается дашборд нового контекста.
Для API-клиентов:
GET /v1/auth/meвозвращаетcurrent_contextиavailable_contexts;- персональный токен привязан к аккаунту, в котором его создали: чтобы работать в другом аккаунте, создайте токен, когда активен этот аккаунт.
Активным аккаунтом следует считать current_context.account_id. Верхнеуровневое
поле account_id в /v1/auth/me — это ID личного аккаунта пользователя,
оставленный ради обратной совместимости, пока активен контекст организации, но
у пользователя без личного аккаунта — например, принятого только через
приглашение в организацию или управляемый OIDC — это поле равно null. Не считайте
null в верхнеуровневом account_id ошибкой; ориентируйтесь на
current_context.
Корректный запрос все равно может попасть не в тот аккаунт, если клиент
использует токен из другого контекста. Читайте /v1/auth/me после входа или
переключения и сохраняйте аккаунт в логах автоматизации и в конфигурации
развертывания.
Вход, сессии и токены доступа
| Учетные данные или состояние | Для кого предназначено | Поведение аккаунта |
|---|---|---|
| Токен доступа | Веб-интерфейс и короткоживущая API-сессия | Несет активный личный контекст или контекст организации |
| Токен обновления | Продление сессии | Ротируется при использовании и сохраняет выпустивший его контекст |
| Cookie сессии превью в браузере | Аутентифицированные превью в браузере | Копирует проверенный токен доступа для запросов браузера без возможности добавить заголовок с bearer-токеном |
| Персональный токен | Скрипты, CI и MCP-клиенты | Привязан к контексту аккаунта, в котором был создан |
Во всех инсталляциях доступен вход по email и паролю; дополнительно может быть настроен провайдер OIDC/SSO. Список провайдеров и подпись SSO берутся из конфигурации инсталляции.
Персональные токены — долгоживущие bearer-токены с правами full или
read_only. Открытое значение показывается один раз. Персональные токены не
следуют за последующими переключениями контекста в веб-интерфейсе: создавайте,
просматривайте, отзывайте и заменяйте учетные данные, когда активен нужный
личный аккаунт или организация.
Разделяйте человеческие сессии, машинные учетные данные и учетные данные отдельных песочниц. Не переносите токен доступа из браузера в CI и не используйте персональный токен как универсальный секрет внутри недоверенного кода песочницы.
Организации, участники и роли
В организации есть роли Владелец, Администратор и Участник; в API им
соответствуют значения owner, admin и member.
| Операция | Участник | Администратор | Владелец |
|---|---|---|---|
| Смотреть организацию и список участников | Да | Да | Да |
| Выйти из организации | Да | Да | Да |
| Добавлять и удалять участников, не являющихся владельцами | Нет | Да | Да |
| Менять роли, не затрагивая владельцев | Нет | Да | Да |
| Назначать, понижать или удалять владельцев | Нет | Нет | Да |
| Изменять метаданные организации | Нет | Да | Да |
| Удалять организацию | Нет | Нет | Да |
Последнего владельца нельзя удалить, понизить или вывести из организации. Сначала передайте владение, добавив или повысив другого владельца.
Три роли прежде всего управляют администрированием организации и членством. После переключения в организацию обычные продуктовые операции выполняются в ее области, но роль Участник не превращает их в операции только для чтения. Добавляйте только пользователей, которым можно работать с ресурсами и данными организации.
Удаление организации намеренно защищено. Владелец должен сначала удалить ее песочницы, шаблоны и сохраненные объекты. Удаление организации не заменяет очистку этих ресурсов.
Доступ администратора платформы отделен от ролей организации. Он относится к операционной управляющей части платформы в инсталляции и не должен использоваться как модель членства в команде.
Квоты и потребление
Квоты и потребление отвечают на разные вопросы:
| Представление | На какой вопрос отвечает | Текущие данные |
|---|---|---|
| Квота | Что аккаунт может выделить прямо сейчас? | Количество песочниц, суммарные vCPU и RAM, отображаемый объем дисков песочниц и шаблонов; у хранилища объектов отдельный лимит |
| Потребление | Что аккаунт потребил за период? | vCPU·ч, ГиБ·ч RAM (с текущим часом), текущее и историческое хранение, работающие песочницы и разбивка по песочницам |
Оба представления находятся на экране Аккаунт → Биллинг и следуют за активным контекстом. Обзор показывает лимиты тарифа: активные песочницы, vCPU, память и файловое хранилище относительно лимитов, потолки на одну песочницу и все лимиты тарифа; если лимит почти исчерпан или превышен, появляется предупреждение. Участники организации видят лимиты без баланса. Расходы показывают деньги за период и ресурсы за ними: дневной график переключается между рублями, vCPU·ч и ГиБ·ч, а таблица песочниц показывает vCPU·ч и ГиБ·ч рядом со стоимостью. Деньги и единицы берутся из одного почасового снимка расходов и совпадают по дням; последний час может еще не войти в снимок.
Количество песочниц, vCPU и RAM проверяются при создании песочницы. Контроль соблюдения отображаемого лимита диска песочницы зависит от конфигурации инсталляции, потому что размер шаблонов в байтах пока не входит в эту проверку при создании. Считайте отображаемый лимит хранения жесткой границей создания только там, где инсталляция включила этот контроль. Хранилище объектов применяет собственную квоту аккаунта.
Аудит и активность
Экран Аккаунт → Активность показывает выпущенные события аудита активного аккаунта. Их можно фильтровать по типу события, результату и типу ресурса; рядом с успешными действиями отображаются результаты Ошибка и Отказано.
API аккаунта всегда сам применяет текущий account_id: клиент не может
запросить логи другого аккаунта через строку запроса. Среди записываемых
семейств событий есть переключение контекста, вход, смена пароля, действия с
персональными токенами и основные переходы жизненного цикла ресурсов.
Журнал аудита — история событий приложения, а не обещание записать каждый низкоуровневый процесс в гостевой системе, сетевой запрос или изменение файловой системы. Если нужна такая детализация, используйте логи сущности и внешнюю систему наблюдаемости.
Изменения доступа и безопасность сессий
- Удаленному участнику организации больше не будет выдан новый токен обновления этого контекста. Уже выпущенный токен доступа действует до настроенного срока истечения, поэтому удаление — ограниченная по времени, но не мгновенная ревокация.
- Смена локального пароля отзывает токены обновления пользователя. Существующие токены доступа остаются короткоживущими учетными данными и истекают по обычному расписанию конкретной инсталляции.
- Отзыв персонального токена запрещает дальнейшее использование и удаляет запись из кэша проверки.
- Персональный токен с правами
read_onlyблокирует изменяющие операции на общих REST- и MCP-путях, но у отдельных частей API есть задокументированные исключения.
Точное поведение учетных данных и актуальное исключение для хранилища описаны на странице Персональные токены. Общеплатформенные гарантии идентификации и совместной ответственности относятся к разделу Безопасность.
Точки входа
| Способ | Для чего использовать |
|---|---|
| Веб-интерфейс → меню аккаунта → Аккаунт | Профиль, биллинг (лимиты, расходы и потребление активного контекста), организации и активность |
| Веб-интерфейс → Токены | Создание, просмотр и отзыв привязанных к аккаунту персональных токенов |
| Веб-интерфейс → Аккаунт → Организация | Переключение контекста, создание организации и переход к ее управлению |
REST /v1/auth/me | Текущий пользователь и активный аккаунт |
REST /v1/auth/tokens | Создание, просмотр и отзыв персональных токенов |
REST /v1/account/audit-logs | Журнал аудита активного аккаунта |
Подробнее об аккаунтах и доступе
- Контекст аккаунта — выбор аккаунта и его влияние на ресурсы и учетные данные.
- Вход и сессии — локальный вход, зависящий от инсталляции SSO, обновление токенов, выход и сессии превью в браузере.
- Персональные токены — права, хранение, использование и отзыв.
- Управление организациями — создание, метаданные, жизненный цикл и условия удаления.
- Участники и роли — границы ролей, передача владения, удаление и выход.
- Квоты и потребление — лимиты выделения, единицы учета, актуальность и разбивка по песочницам.
- Аудит и активность — события, привязанные к аккаунту, фильтры, результаты и интерпретация.
- Основы работы с API — bearer-аутентификация и REST-запросы, привязанные к аккаунту.
- REST API — точные контракты Authentication, Tokens, Organizations и Account.