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

Аккаунты и доступ

Аккаунт — граница владения и изоляции ресурсов 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Журнал аудита активного аккаунта

Подробнее об аккаунтах и доступе​