#Управление пользователями и ролями

Keycloak предоставляет комплексное управление жизненным циклом пользователей и тонко настроенный контроль доступа на основе ролей (RBAC). Пользователи, роли и группы управляются в пределах каждого Realm.

#Управление пользователями

#Создание пользователя

# Получить токен доступа администратора
ACCESS_TOKEN=$(curl -s -X POST \
  "https://<keycloak-host>/realms/master/protocol/openid-connect/token" \
  -d "client_id=admin-cli" \
  -d "username=<admin-user>" \
  -d "password=<admin-password>" \
  -d "grant_type=password" | jq -r '.access_token')

# Создать пользователя
curl -s -X POST \
  "https://<keycloak-host>/admin/realms/<realm>/users" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "jdoe",
    "email": "jdoe@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "enabled": true,
    "emailVerified": true,
    "credentials": [{
      "type": "password",
      "value": "changeme",
      "temporary": true
    }]
  }'

#Сброс пароля пользователя

1. В Admin Console перейдите в Users и выберите нужного пользователя.
2. Нажмите на вкладку Credentials.
3. Нажмите Reset password.
4. Введите новый пароль и включите Temporary, если хотите, чтобы пользователь сменил пароль при следующем входе.
5. Нажмите Save password.

#Управление ролями

Keycloak поддерживает два типа ролей:

#Создание роли Realm

1. В Admin Console перейдите в Realm Roles.
2. Нажмите Create role.
3. Введите Role name и необязательное Description.
4. Нажмите Save.

#Назначение ролей пользователям

1. Перейдите в Users и выберите нужного пользователя.
2. Нажмите вкладку Role mapping.
3. Нажмите Assign role.
4. Выберите роли для назначения и нажмите Assign.

#Управление группами

Группы позволяют управлять назначением ролей сразу для нескольких пользователей. Назначьте роли группе, и все участники группы автоматически наследуют эти роли.

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

1. В Admin Console перейдите в Groups.
2. Нажмите Create group.
3. Введите Name и нажмите Create.
4. На вкладке Role Mapping группы назначьте нужные роли Realm или клиента.

#Добавление пользователей в группу

1. Перейдите в Users и выберите нужного пользователя.
2. Нажмите вкладку Groups.
3. Нажмите Join Group, выберите группу и нажмите Join.

#Составные роли

Composite Role — это роль, которая содержит другие роли. При назначении пользователю составной роли он наследует все роли, входящие в неё. Это упрощает управление разрешениями при сложных иерархиях ролей.

Для создания составной роли:

1. Создайте роль Realm.
2. В деталях роли включите Composite role.
3. На вкладке Associated roles добавьте дочерние роли.