Управление учетными записями, ролями и группами в Keycloak

Создание новой учетной записи

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

Для создания новой учетной записи необходимо выполнить следующие действия:

  1. Выбрать реалм, перейти в раздел Users и нажать кнопку [Add user].
  2. Заполнить поля формы.

    img

    Указать логин в поле Username и электронный адрес в поле Email.

    В поле Required user actions можно выбрать обязательное действие, которое данный пользователь должен будет совершить при первом входе в LDM.Box.

    Активация тумблера Email verified устанавливает признак подтвержденного электронного адреса для создаваемого пользователя. В таком случае Keycloak не будет отправлять данному пользователю письмо с подтверждением регистрации, если отправка настроена в Realm settings. Поле Email verified имеет приоритет над Required user actions.

  3. После заполнения полей нажать кнопку [Create].

    В карточке пользователя активировать тумблер Enabled.

    Если нужно добавить создаваемого пользователя в группу, необходимо открыть вкладку Groups, нажать кнопку [Join group], в открывшемся окне отметить чекбоксом одну или несколько групп и нажать кнопку [Join].

    img

  4. На вкладке Credentials в карточке пользователя установить пароль, нажав кнопку [Set password].

  5. В открывшемся окне указать пароль и деактивировать тумблер Temporary.

Учетная запись пользователя будет создана.

Создание и привязка глобальных ролей

Для создания и привязки глобальной роли (роли для реалма) необходимо выполнить следующие действия:

  1. Перейти в раздел Realm roles и нажать кнопку [Create role].
  2. Заполнить поля формы и нажать кнопку [Save].

    img

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

  4. В карточке пользователя перейти на вкладку Role Mappings, нажать кнопку [Assign Role] и выбрать значение «Realm roles».

  5. Отметить чекбоксом нужную роль и нажать кнопку [Assign].

img

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

Подробнее процесс работы в Keycloak описан в документе Руководство по установке и конфигурированию ЛДМ. ПЛАТФОРМА КОНТЕНТ-СЕРВИСОВ (ЛДМ.ПКС).

Создание групп

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

  1. Открыть раздел Groups и нажать кнопку [Create group].

    img

  2. В открывшемся окне указать наименование группы и нажать кнопку [Create].

    img

  3. Для добавления в группу пользователя необходимо открыть вкладку Members и нажать кнопку [Add member].

    img

  4. В открывшемся окне отметить чекбоксами пользователей, которых планируется добавить в группу, и нажать кнопку [Add].

img

Добавленные пользователи появятся на вкладке Members.

Добавлять в группы также можно через карточку пользователя на вкладке Groups с помощью кнопки [Join Group].

img