승인 워크플로우
메뉴 통합 안내 — UI 상의 승인 처리는 액세스 페이지의 검토 탭(
/governance/access?tab=reviews)에서 수행합니다./admin/approvalsURL 은 해당 탭으로 자동 리디렉트됩니다. 이 문서는 승인 워크플로우의 상태 머신과 API 를 설명하며, UI 사용법은 액세스 가이드를 참조하세요.
GenD의 승인 워크플로우는 데이터 접근 권한 요청, 정책 변경 등 관리자 승인이 필요한 작업에 대한 요청-승인-반려 상태 머신을 제공합니다.

주요 기능
- 승인 요청 생성: 사용자가 권한 요청이나 정책 변경 요청을 제출합니다
- 요청 목록 조회: 관리자가 대기 중인 승인 요청을 조회합니다
- 승인/반려 처리: 관리자가 요청을 승인(approved) 또는 반려(rejected)합니다
- 내 요청 조회: 사용자가 본인이 제출한 요청의 상태를 확인합니다
- 요청 취소: 사용자가 대기 중인 본인의 요청을 취소할 수 있습니다
- 만료 처리: 장기간 미처리된 요청을 자동으로 만료 처리합니다
상태 흐름
pending → approved
pending → rejected
pending → cancelled (요청자 취소)
pending → expired (기한 만료)
사용 방법
- 사용자가 데이터 접근 등 승인이 필요한 작업을 요청합니다
- 관리자에게 알림이 전송됩니다
- 관리자는 사이드바 → 거버넌스 → 데이터 액세스 의 검토 탭(
/governance/access?tab=reviews)에서 대기 중인 요청을 확인합니다 - 요청 내용을 검토하고 승인 또는 반려합니다
- 승인 시 요청된 권한이 자동으로 부여됩니다
API 엔드포인트
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/approvals/ | 승인 요청 생성 |
| GET | /api/v1/approvals/ | 요청 목록 조회 |
| GET | /api/v1/approvals/my | 내 요청 목록 조회 |
| GET | /api/v1/approvals/{request_id} | 요청 상세 조회 |
| POST | /api/v1/approvals/{request_id}/decide | 승인/반려 처리 |
| POST | /api/v1/approvals/{request_id}/cancel | 요청 취소 |
| POST | /api/v1/approvals/expire | 만료 요청 일괄 처리 |