Роль (role) — именованный набор разрешений, который назначают пользователям в тенанте. Здесь вы создадите роль в консоли администратора. Поля и правила описаны в разделе Role.
Предварительные требования
- Тенант, выбранный в консоли.
- Разрешения, которые должна давать роль.
1. Откройте Roles
Откройте Roles в нужном тенанте. На карточке — описание, ID роли и бейдж Inactive, если роль выключена. Раскройте карточку, чтобы увидеть ее разрешения.
2. Начните новую роль
Нажмите + Create Role.
3. Заполните роль
- Role ID: строчные латинские буквы, цифры и дефисы, первый символ — буква, например
auditorилиpayments-admin. Подчеркивания отклоняются, хотя подсказка под полем их упоминает. Позже ID изменить нельзя. - Description: обязательно, на английском.
- Active: оставьте включенным, чтобы роль давала доступ сразу. Выключите, чтобы сохранить роль, не давая ей ничего выдавать.
- Permissions: отметьте каждое разрешение, которое дает роль. Значок i рядом с разрешением перечисляет ресурсы и эндпоинты, которые оно покрывает.
4. Создайте роль
Нажмите Create Role. Роль готова к назначению. Откройте пользователя, нажмите Get Roles на карточке нужного тенанта и добавьте роль. См. Как зарегистрировать пользователя.
При запросе edge объединяет разрешения всех ролей, которые пользователь имеет в тенанте токена. ID ролей копируются в токен при выдаче, поэтому добавленная или снятая роль доходит до следующего выданного или обновленного токена пользователя.
Изменение и удаление роли
Нажмите карандаш на карточке, чтобы изменить описание, состояние Active или разрешения. ID не меняется. Крестик удаляет роль после подтверждения. Назначения у пользователей остаются, но ID больше не соответствует ни одному разрешению. Чтобы вывести роль из работы и сохранить ее, выключите Active.
Что дальше
- Как зарегистрировать пользователя: назначить роль.
- Как зарегистрировать разрешение: добавить разрешения для выбора.
- Role: как роли влияют на решения об авторизации.