API / ADMIN

GraphQL Admin API

Администрирование пользователей, ролей, групп и клиентов. Административные запросы требуют отдельной проверки доступа и realm context.

RustCloak / Технические материалы · Сверяйте примеры с используемой версией проекта.

Endpoint

GraphQL request, schema проверить · bash
curl -X POST 'http://localhost:8080/admin/graphql' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ADMIN_ACCESS_TOKEN' \
  -d '{"query":"query { dashboardStats { usersCount clientsCount rolesCount } }"}'

Области API

РесурсПримеры операций
ПользователиСписки, поиск, профиль, сессии, управление состоянием
RBACРоли, группы, scopes, composite roles
OIDC-клиентыРегистрация и параметры redirect URI
СобытияАудит и история действий

Контроль доступа

Проверяйте подпись JWT, роль администратора, принадлежность realm и доступ к объекту. Ограничение области realm требуется на сервере, независимо от маршрутов UI.

Ожидаемые негативные сценарии

  • Нет токена → запрос отклонён.
  • Токен другого realm → невозможно получить чужие данные.
  • Администратор без нужных прав → операция запрещена.
  • Пользовательский токен → не эквивалентен административному.