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

Аккаунт — граница владения и изоляции ресурсов Just Run. У каждого аутентифицированного запроса есть один активный контекст аккаунта: ваш личный аккаунт или организация, в которой вы состоите. Песочницы, шаблоны, объекты хранилища, секреты, автоматизации, серверы Hosted MCP, квоты, потребление и активность аккаунта разрешаются относительно этого контекста.

При переключении контекста ваша учетная запись не меняется. Меняется аккаунт, в котором вы работаете.

## Ментальная модель[​](#mental-model "Прямая ссылка на Ментальная модель")

```
user identity
    │
    ├── personal account ───────────────┐
    │                                   │
    └── organization memberships ──► choose active context
                                           │
                  access or refresh token ─┤
                                           ▼
                              account-scoped resources
                              quotas · usage · activity
```

Аутентификация устанавливает, кто вы. Контекст аккаунта определяет, к какому аккаунту относится запрос. Роль в организации управляет операциями над самой организацией, но не заменяет активный контекст аккаунта.

## Личный аккаунт и организация[​](#personal-and-organization-accounts "Прямая ссылка на Личный аккаунт и организация")

| Тип аккаунта    | Кто может использовать            | Типичный сценарий                                                         |
| --------------- | --------------------------------- | ------------------------------------------------------------------------- |
| **Личный**      | Его пользователь                  | Индивидуальная разработка, эксперименты и пользовательские учетные данные |
| **Организация** | Пользователи из списка участников | Общие ресурсы, общие лимиты и потребление, управление командой            |

У вошедшего пользователя всегда есть личный контекст. Создание организации добавляет еще один аккаунт и делает создателя первым владельцем. После этого в организацию можно добавлять по email других уже существующих пользователей Just Run.

Ресурсы принадлежат аккаунту, а не человеку, который последним их изменил. Переключение из организации не останавливает и не переносит ее ресурсы — оно меняет область последующих запросов на чтение и создание.

## Активный контекст аккаунта[​](#active-account-context "Прямая ссылка на Активный контекст аккаунта")

Откройте *Аккаунт* из меню аккаунта в веб-интерфейсе. Экран *Организация* показывает доступные текущему пользователю контексты. При переключении выпускается новая пара токенов (доступа и обновления) для выбранного аккаунта, очищается кэш запросов интерфейса и открывается дашборд нового контекста.

Для 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` после входа или переключения и сохраняйте аккаунт в логах автоматизации и в конфигурации развертывания.

## Вход, сессии и токены доступа[​](#sign-in-sessions-and-access-tokens "Прямая ссылка на Вход, сессии и токены доступа")

| Учетные данные или состояние    | Для кого предназначено                    | Поведение аккаунта                                                                                           |
| ------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Токен доступа                   | Веб-интерфейс и короткоживущая API-сессия | Несет активный личный контекст или контекст организации                                                      |
| Токен обновления                | Продление сессии                          | Ротируется при использовании и сохраняет выпустивший его контекст                                            |
| Cookie сессии превью в браузере | Аутентифицированные превью в браузере     | Копирует проверенный токен доступа для запросов браузера без возможности добавить заголовок с bearer-токеном |
| Персональный токен              | Скрипты, CI и MCP-клиенты                 | Привязан к контексту аккаунта, в котором был создан                                                          |

Во всех инсталляциях доступен вход по email и паролю; дополнительно может быть настроен провайдер OIDC/SSO. Список провайдеров и подпись SSO берутся из конфигурации инсталляции.

Персональные токены — долгоживущие bearer-токены с правами `full` или `read_only`. Открытое значение показывается один раз. Персональные токены не следуют за последующими переключениями контекста в веб-интерфейсе: создавайте, просматривайте, отзывайте и заменяйте учетные данные, когда активен нужный личный аккаунт или организация.

Разделяйте человеческие сессии, машинные учетные данные и учетные данные отдельных песочниц. Не переносите токен доступа из браузера в CI и не используйте персональный токен как универсальный секрет внутри недоверенного кода песочницы.

## Организации, участники и роли[​](#organizations-members-and-roles "Прямая ссылка на Организации, участники и роли")

В организации есть роли *Владелец*, *Администратор* и *Участник*; в API им соответствуют значения `owner`, `admin` и `member`.

| Операция                                                  | *Участник* | *Администратор* | *Владелец* |
| --------------------------------------------------------- | ---------- | --------------- | ---------- |
| Смотреть организацию и список участников                  | Да         | Да              | Да         |
| Выйти из организации                                      | Да         | Да              | Да         |
| Добавлять и удалять участников, не являющихся владельцами | Нет        | Да              | Да         |
| Менять роли, не затрагивая владельцев                     | Нет        | Да              | Да         |
| Назначать, понижать или удалять владельцев                | Нет        | Нет             | Да         |
| Изменять метаданные организации                           | Нет        | Да              | Да         |
| Удалять организацию                                       | Нет        | Нет             | Да         |

Последнего владельца нельзя удалить, понизить или вывести из организации. Сначала передайте владение, добавив или повысив другого владельца.

Роль — не права чтения и записи на уровне ресурса

Три роли прежде всего управляют администрированием организации и членством. После переключения в организацию обычные продуктовые операции выполняются в ее области, но роль *Участник* не превращает их в операции только для чтения. Добавляйте только пользователей, которым можно работать с ресурсами и данными организации.

Удаление организации намеренно защищено. Владелец должен сначала удалить ее песочницы, шаблоны и сохраненные объекты. Удаление организации не заменяет очистку этих ресурсов.

Доступ администратора платформы отделен от ролей организации. Он относится к операционной управляющей части платформы в инсталляции и не должен использоваться как модель членства в команде.

## Квоты и потребление[​](#quotas-and-usage "Прямая ссылка на Квоты и потребление")

Квоты и потребление отвечают на разные вопросы:

| Представление   | На какой вопрос отвечает                 | Текущие данные                                                                                                                 |
| --------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Квота**       | Что аккаунт может выделить прямо сейчас? | Количество песочниц, суммарные vCPU и RAM, отображаемый объем дисков песочниц и шаблонов; у хранилища объектов отдельный лимит |
| **Потребление** | Что аккаунт потребил за период?          | vCPU·ч, ГиБ·ч RAM (с текущим часом), текущее и историческое хранение, работающие песочницы и разбивка по песочницам            |

Оба представления находятся на экране *Аккаунт* → *Биллинг* и следуют за активным контекстом. *Обзор* показывает лимиты тарифа: активные песочницы, vCPU, память и файловое хранилище относительно лимитов, потолки на одну песочницу и все лимиты тарифа; если лимит почти исчерпан или превышен, появляется предупреждение. Участники организации видят лимиты без баланса. *Расходы* показывают деньги за период и ресурсы за ними: дневной график переключается между рублями, vCPU·ч и ГиБ·ч, а таблица песочниц показывает vCPU·ч и ГиБ·ч рядом со стоимостью. Деньги и единицы берутся из одного почасового снимка расходов и совпадают по дням; последний час может еще не войти в снимок.

Количество песочниц, vCPU и RAM проверяются при создании песочницы. Контроль соблюдения отображаемого лимита диска песочницы зависит от конфигурации инсталляции, потому что размер шаблонов в байтах пока не входит в эту проверку при создании. Считайте отображаемый лимит хранения жесткой границей создания только там, где инсталляция включила этот контроль. Хранилище объектов применяет собственную квоту аккаунта.

## Аудит и активность[​](#audit-and-activity "Прямая ссылка на Аудит и активность")

Экран *Аккаунт* → *Активность* показывает выпущенные события аудита активного аккаунта. Их можно фильтровать по типу события, результату и типу ресурса; рядом с успешными действиями отображаются результаты *Ошибка* и *Отказано*.

API аккаунта всегда сам применяет текущий `account_id`: клиент не может запросить логи другого аккаунта через строку запроса. Среди записываемых семейств событий есть переключение контекста, вход, смена пароля, действия с персональными токенами и основные переходы жизненного цикла ресурсов.

Журнал аудита — история событий приложения, а не обещание записать каждый низкоуровневый процесс в гостевой системе, сетевой запрос или изменение файловой системы. Если нужна такая детализация, используйте логи сущности и внешнюю систему наблюдаемости.

## Изменения доступа и безопасность сессий[​](#access-changes-and-session-safety "Прямая ссылка на Изменения доступа и безопасность сессий")

* Удаленному участнику организации больше не будет выдан новый токен обновления этого контекста. Уже выпущенный токен доступа действует до настроенного срока истечения, поэтому удаление — ограниченная по времени, но не мгновенная ревокация.
* Смена локального пароля отзывает токены обновления пользователя. Существующие токены доступа остаются короткоживущими учетными данными и истекают по обычному расписанию конкретной инсталляции.
* Отзыв персонального токена запрещает дальнейшее использование и удаляет запись из кэша проверки.
* Персональный токен с правами `read_only` блокирует изменяющие операции на общих REST- и MCP-путях, но у отдельных частей API есть задокументированные исключения.

Точное поведение учетных данных и актуальное исключение для хранилища описаны на странице [Персональные токены](/accounts/personal-access-tokens.md). Общеплатформенные гарантии идентификации и совместной ответственности относятся к разделу [Безопасность](/security.md).

## Точки входа[​](#entry-points "Прямая ссылка на Точки входа")

| Способ                                    | Для чего использовать                                                                          |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Веб-интерфейс → меню аккаунта → *Аккаунт* | Профиль, биллинг (лимиты, расходы и потребление активного контекста), организации и активность |
| Веб-интерфейс → *Токены*                  | Создание, просмотр и отзыв привязанных к аккаунту персональных токенов                         |
| Веб-интерфейс → *Аккаунт* → *Организация* | Переключение контекста, создание организации и переход к ее управлению                         |
| REST `/v1/auth/me`                        | Текущий пользователь и активный аккаунт                                                        |
| REST `/v1/auth/tokens`                    | Создание, просмотр и отзыв персональных токенов                                                |
| REST `/v1/account/audit-logs`             | Журнал аудита активного аккаунта                                                               |

## Подробнее об аккаунтах и доступе[​](#explore-accounts-access "Прямая ссылка на Подробнее об аккаунтах и доступе")

* [Контекст аккаунта](/accounts/account-context) — выбор аккаунта и его влияние на ресурсы и учетные данные.
* [Вход и сессии](/accounts/sign-in-and-sessions) — локальный вход, зависящий от инсталляции SSO, обновление токенов, выход и сессии превью в браузере.
* [Персональные токены](/accounts/personal-access-tokens.md) — права, хранение, использование и отзыв.
* [Управление организациями](/accounts/organizations) — создание, метаданные, жизненный цикл и условия удаления.
* [Участники и роли](/accounts/members-and-roles) — границы ролей, передача владения, удаление и выход.
* [Квоты и потребление](/accounts/quotas-and-usage) — лимиты выделения, единицы учета, актуальность и разбивка по песочницам.
* [Аудит и активность](/accounts/audit-and-activity) — события, привязанные к аккаунту, фильтры, результаты и интерпретация.
* [Основы работы с API](/developers/api-fundamentals.md) — bearer-аутентификация и REST-запросы, привязанные к аккаунту.
* [REST API](/api-reference/rest.md) — точные контракты Authentication, Tokens, Organizations и Account.
