사용자 관리
관리자는 GenD UI에서 직접 사용자 역할, 그룹, 활성 상태를 관리합니다.
사용자 관리 페이지
사이드바 하단 ⚙ 관리 콘솔 → 테넌트 & 사용자 → 사용자 관리 메뉴에서 접근합니다.
사용자 목록
사용자 목록 페이지에서 모든 Keycloak 사용자를 조회합니다.
기능:
- 사용자 목록 (이름, 이메일, 역할 Badge, 그룹 Badge, 상태)
- 이름/이메일 검색
- 사용자 행 클릭 → 상세 Sheet 열기
사용자 상세 편집
사용자 행을 클릭하면 상세 Sheet가 열립니다.
편집 가능 항목:
| 항목 | 설명 |
|---|---|
| 역할 | admin, analyst, viewer, gend-llm-internal/confidential/external |
| 그룹 | marketing, finance, hr (부서) |
| 활성 상태 | 활성/비활성 Switch |
역할/그룹 Badge를 클릭하여 토글하고, 저장 버튼으로 반영합니다.
첫 로그인 시 기본 역할
| 가입 방법 | 기본 역할 |
|---|---|
| 셀프 회원가입 | viewer + gend-llm-external |
| Google SSO | viewer + gend-llm-external |
| 관리자 생성 | 관리자가 직접 지정 |
역할 승격 절차
- 사용자가 회원가입 또는 Google SSO로 첫 로그인
- 관리자가 사용자 관리 페이지에서 해당 사용자 확인
- 역할을
analyst또는admin으로 변경 - 필요 시 그룹(부서) 할당
- 저장
API 레퍼런스
모든 엔드포인트는 admin 역할 필수입니다.
| Method | Path | 설명 |
|---|---|---|
GET | /api/v1/admin/users | 사용자 목록 (검색, 필터) |
GET | /api/v1/admin/users/{id} | 사용자 상세 (역할+그룹) |
PUT | /api/v1/admin/users/{id}/roles | 역할 할당/해제 |
PUT | /api/v1/admin/users/{id}/groups | 그룹 할당/해제 |
PUT | /api/v1/admin/users/{id}/enabled | 활성/비활성화 |