사용자 & 서비스 클라이언트 API

Keycloak 사용자와 M2M 서비스 클라이언트를 관리하는 관리 API입니다. admin 전용.

사용자 관리

prefix: /api/v1/admin/users — Keycloak realm 사용자 조회 및 역할/그룹/활성 상태 관리.

Method	Path	설명
GET	/api/v1/admin/users/	사용자 목록
GET	/api/v1/admin/users/{user_id}	사용자 상세
PUT	/api/v1/admin/users/{user_id}/roles	역할 부여/회수
PUT	/api/v1/admin/users/{user_id}/groups	그룹 멤버십 변경
PUT	/api/v1/admin/users/{user_id}/enabled	계정 활성/비활성

서비스 클라이언트

prefix: /api/v1/admin/service-clients — M2M(client_credentials) 서비스 계정 클라이언트 관리 (#644).

Method	Path	설명
POST	/api/v1/admin/service-clients	서비스 클라이언트 생성
GET	/api/v1/admin/service-clients	목록
GET	/api/v1/admin/service-clients/{internal_id}	상세
POST	/api/v1/admin/service-clients/{internal_id}/regenerate-secret	시크릿 재발급
PATCH	/api/v1/admin/service-clients/{internal_id}	수정
POST	/api/v1/admin/service-clients/{internal_id}/self-test	토큰 발급 self-test
DELETE	/api/v1/admin/service-clients/{internal_id}	삭제

인증

JWT Bearer + admin 역할. 사용자/역할/그룹 변경은 Keycloak Admin API 를 통해 서버에서 시행됩니다.