Роли и права
Кто что может в пространстве Router — владелец, администратор, участник и наблюдатель, доступ к журналу содержимого и приглашения.
Пространство Router — общее рабочее место команды: участники, API-ключи, бюджет, настройки и плательщик. У каждого участника одна роль, она определяет, что он может делать в кабинете. Права проверяет сервер, поэтому кнопки, на которые у вас нет прав, в кабинете неактивны, а в подсказке видна причина.
Роль влияет только на кабинет. Запрос с API-ключом не зависит от роли того, кто ключ создал: его ограничивают настройки самого ключа и политики пространства (см. Аутентификация).
Роли
- Владелец — один на пространство. Может все, в том числе удалить пространство и передать владение.
- Администратор — управляет пространством наравне с владельцем, кроме удаления, передачи владения и доступа поддержки.
- Участник — создает свои API-ключи, пользуется чатом, видит расход и логи.
- Наблюдатель — только смотрит: ключи, расход, логи и статистику.
Что может каждая роль
| Действие | Владелец | Администратор | Участник | Наблюдатель |
|---|---|---|---|---|
| Видеть пространство, список ключей, логи и статистику (без тел запросов) | ✓ | ✓ | ✓ | ✓ |
| Создавать API-ключи и пользоваться чатом | ✓ | ✓ | ✓ | — |
| Изменять, отключать, переносить и отзывать свои ключи | ✓ | ✓ | ✓ | — |
| Изменять, отключать, переносить и отзывать чужие ключи, управлять пресетами ключей | ✓ | ✓ | — | — |
| Настройки пространства: название, бюджет, разрешенные IP-адреса, политики, маскирование | ✓ | ✓ | — | — |
| Включать и выключать логирование содержимого, удалять сохраненное содержимое | ✓ | ✓ | — | — |
| Приглашать и удалять участников, менять роли | ✓ | ✓ | — | — |
| Выбирать плательщика | ✓ | ✓ | — | — |
| Удалить пространство, передать владение, выдать доступ поддержке | ✓ | — | — | — |
| Читать содержимое запросов и ответов | ✓ | с разрешением | с разрешением | с разрешением |
Для чтения содержимого администратору, участнику и наблюдателю нужно отдельное разрешение, см. ниже.
Доступ к журналу содержимого
Если в пространстве включено логирование содержимого, тела запросов и ответов могут содержать персональные данные и секреты. Поэтому их чтение — отдельное разрешение logs:read, а не часть роли. У владельца оно есть всегда, остальным его выдают по одному.
Разрешение выдает владелец или администратор — галочкой «Может читать журнал содержимого» при приглашении или позже в карточке участника. Его можно дать участнику любой роли, в том числе наблюдателю. Метаданные запросов (время, модель, ключ, токены, стоимость, статус) видны всем участникам и без него.
Приглашения
Владелец или администратор приглашает человека на странице Участники по email или Nodul ID и сразу выбирает роль: администратор, участник или наблюдатель. Пригласить сразу владельцем нельзя — владение передается отдельно.
- Пока приглашение не принято, у человека нет доступа: пространство не появляется в его списке, а пригласивший видит только то, что ввел.
- Приглашенный принимает или отклоняет приглашение в кабинете, в блоке «Приглашения» на странице пространств Router, или по ссылке из письма.
- Вход в кабинет сам по себе приглашение не принимает.
- Приглашение по email можно отправить повторно, но не чаще раза в 10 минут.
Владелец
- Владелец у пространства один. Его роль нельзя изменить, а самого владельца нельзя удалить из пространства.
- Владение передается активному участнику (принявшему приглашение) на странице Участники; прежний владелец становится администратором, и оба сохраняют доступ к журналу содержимого.
- Только владелец может удалить пространство и выдать сотрудникам поддержки доступ к пространству на время от 1 до 72 часов.
Администраторы
Администратор управляет участниками, но не другими администраторами: изменить роль администратора или удалить его может только владелец. Себя администратор может понизить или удалить из пространства сам.
Участника и наблюдателя из пространства удаляет владелец или администратор.
Плательщик и роль
Плательщика пространства выбирает владелец или администратор из своих пространств Nodul. Привязка действует, пока привязавший остается владельцем или администратором этого пространства Router и сохраняет право на оплату в пространстве Nodul.
Если привязавшего понизили до участника или наблюдателя, удалили или он вышел сам, плательщик сразу отвязывается, и новые запросы блокируются, пока владелец или администратор не выберет плательщика заново. Подробнее о плательщике — в разделе Цены и оплата.
Ключи участников
- Участник управляет только ключами, которые создал сам. Владелец и администраторы управляют всеми ключами пространства.
- Владелец или администратор может включить политику обязательного пресета: тогда участник создает ключи только из пресета пространства и может лишь ужесточить его — снизить бюджет и лимит запросов, сузить список моделей и IP-адресов, сократить срок действия, добавить категории маскирования. На владельца и администраторов политика не действует.
- Политики пространства (запрет сбора данных провайдерами, только модели в России) действуют на ключи всех ролей и на чат.
- Перенести ключ в другое пространство может тот, кто управляет ключом и может создавать ключи в целевом пространстве.
Что видят все участники
Любой участник пространства, включая наблюдателя, видит:
- список всех API-ключей пространства (без секретов — секрет показывается только один раз при создании);
- логи и статистику по всем ключам и по чату, без тел запросов и ответов;
- участников пространства и их роли.
Если ключ нужно скрыть от других участников, создайте для него отдельное пространство Router.