# Роли и права

Кто что может в пространстве Router — владелец, администратор, участник и наблюдатель, доступ к журналу содержимого и приглашения.

Пространство Router — общее рабочее место команды: участники, API-ключи, бюджет, настройки и плательщик. У каждого участника одна **роль**, она определяет, что он может делать в кабинете. Права проверяет сервер, поэтому кнопки, на которые у вас нет прав, в кабинете неактивны, а в подсказке видна причина.

Роль влияет только на кабинет. Запрос с API-ключом не зависит от роли того, кто ключ создал: его ограничивают настройки самого ключа и политики пространства (см. [Аутентификация](/docs/ru/authentication)).

## Роли

- **Владелец** — один на пространство. Может все, в том числе удалить пространство и передать владение.
- **Администратор** — управляет пространством наравне с владельцем, кроме удаления, передачи владения и доступа поддержки.
- **Участник** — создает свои API-ключи, пользуется чатом, видит расход и логи.
- **Наблюдатель** — только смотрит: ключи, расход, логи и статистику.

## Что может каждая роль

| Действие                                                                                | Владелец | Администратор |    Участник   |  Наблюдатель  |
| --------------------------------------------------------------------------------------- | :------: | :-----------: | :-----------: | :-----------: |
| Видеть пространство, список ключей, логи и статистику (без тел запросов)                |     ✓    |       ✓       |       ✓       |       ✓       |
| Создавать API-ключи и пользоваться чатом                                                |     ✓    |       ✓       |       ✓       |       —       |
| Изменять, отключать, переносить и отзывать **свои** ключи                               |     ✓    |       ✓       |       ✓       |       —       |
| Изменять, отключать, переносить и отзывать **чужие** ключи, управлять пресетами ключей  |     ✓    |       ✓       |       —       |       —       |
| Настройки пространства: название, бюджет, разрешенные IP-адреса, политики, маскирование |     ✓    |       ✓       |       —       |       —       |
| Включать и выключать логирование содержимого, удалять сохраненное содержимое            |     ✓    |       ✓       |       —       |       —       |
| Приглашать и удалять участников, менять роли                                            |     ✓    |       ✓       |       —       |       —       |
| Выбирать плательщика                                                                    |     ✓    |       ✓       |       —       |       —       |
| Удалить пространство, передать владение, выдать доступ поддержке                        |     ✓    |       —       |       —       |       —       |
| Читать содержимое запросов и ответов                                                    |     ✓    | с разрешением | с разрешением | с разрешением |

Для чтения содержимого администратору, участнику и наблюдателю нужно отдельное разрешение, см. ниже.

## Доступ к журналу содержимого

Если в пространстве включено [логирование содержимого](/docs/ru/data-and-privacy#логирование-содержимого), тела запросов и ответов могут содержать персональные данные и секреты. Поэтому их чтение — отдельное разрешение **logs:read**, а не часть роли. У владельца оно есть всегда, остальным его выдают по одному.

Разрешение выдает владелец или администратор — галочкой «Может читать журнал содержимого» при приглашении или позже в карточке участника. Его можно дать участнику любой роли, в том числе наблюдателю. Метаданные запросов (время, модель, ключ, токены, стоимость, статус) видны всем участникам и без него.

## Приглашения

Владелец или администратор приглашает человека на странице **Участники** по email или Nodul ID и сразу выбирает роль: администратор, участник или наблюдатель. Пригласить сразу владельцем нельзя — владение передается отдельно.

- Пока приглашение не принято, у человека нет доступа: пространство не появляется в его списке, а пригласивший видит только то, что ввел.
- Приглашенный принимает или отклоняет приглашение в кабинете, в блоке «Приглашения» на странице пространств Router, или по ссылке из письма.
- Вход в кабинет сам по себе приглашение не принимает.
- Приглашение по email можно отправить повторно, но не чаще раза в 10 минут.

## Владелец

- Владелец у пространства один. Его роль нельзя изменить, а самого владельца нельзя удалить из пространства.
- Владение передается активному участнику (принявшему приглашение) на странице **Участники**; прежний владелец становится администратором, и оба сохраняют доступ к журналу содержимого.
- Только владелец может удалить пространство и выдать сотрудникам поддержки доступ к пространству на время от 1 до 72 часов.

## Администраторы

Администратор управляет участниками, но не другими администраторами: изменить роль администратора или удалить его может только владелец. Себя администратор может понизить или удалить из пространства сам.

Участника и наблюдателя из пространства удаляет владелец или администратор.

## Плательщик и роль

Плательщика пространства выбирает владелец или администратор из своих пространств Nodul. Привязка действует, пока привязавший остается **владельцем или администратором** этого пространства Router и сохраняет право на оплату в пространстве Nodul.

Если привязавшего понизили до участника или наблюдателя, удалили или он вышел сам, плательщик сразу отвязывается, и новые запросы блокируются, пока владелец или администратор не выберет плательщика заново. Подробнее о плательщике — в разделе [Цены и оплата](/docs/ru/pricing-and-billing).

## Ключи участников

- Участник управляет только ключами, которые создал сам. Владелец и администраторы управляют всеми ключами пространства.
- Владелец или администратор может включить политику **обязательного пресета**: тогда участник создает ключи только из пресета пространства и может лишь ужесточить его — снизить бюджет и лимит запросов, сузить список моделей и IP-адресов, сократить срок действия, добавить категории маскирования. На владельца и администраторов политика не действует.
- Политики пространства (запрет сбора данных провайдерами, только модели в России) действуют на ключи всех ролей и на чат.
- Перенести ключ в другое пространство может тот, кто управляет ключом и может создавать ключи в целевом пространстве.

## Что видят все участники

Любой участник пространства, включая наблюдателя, видит:

- список всех API-ключей пространства (без секретов — секрет показывается только один раз при создании);
- логи и статистику по всем ключам и по чату, без тел запросов и ответов;
- участников пространства и их роли.

Если ключ нужно скрыть от других участников, создайте для него отдельное пространство Router.