3.6 KiB
3.6 KiB
Frontend 기능과 백엔드 테스트 매핑 가이드
이 문서는 devfront와 userfront의 Hydra 관련 기능이 백엔드의 어떤 API를 호출하고, 해당 API가 어떤 테스트 코드로 검증되는지 설명합니다. 모든 기능은 백엔드에 이미 구현되어 있으며, '테스트' 열은 해당 기능을 검증하는 자동화 테스트의 존재 여부를 나타냅니다.
1. devfront (개발자/관리자 포털)
devfront는 OAuth2 클라이언트(RP)를 생성하고 관리하는 데 사용됩니다.
devfront 기능 |
백엔드 API | 검증 테스트 파일 | 테스트 상태 |
|---|---|---|---|
| 클라이언트 목록 조회 | GET /api/v1/dev/clients |
dev_handler_test.go |
TestListClients_Success |
| 클라이언트 생성 | POST /api/v1/dev/clients |
dev_handler_test.go |
TestCreateClient_Success |
| 클라이언트 상세 조회 | GET /api/v1/dev/clients/:id |
dev_handler_test.go |
TestGetClient_Success, TestGetClient_NotFound |
| 클라이언트 정보 수정 | PUT /api/v1/dev/clients/:id |
- | (테스트 미작성) |
| 클라이언트 상태 변경 | PATCH /api/v1/dev/clients/:id/status |
- | (테스트 미작성) |
| 클라이언트 삭제 | DELETE /api/v1/dev/clients/:id |
- | (테스트 미작성) |
| 시크릿 재발급 | POST /api/v1/dev/clients/:id/rotate-secret |
- | (테스트 미작성) |
| 동의한 사용자 목록 조회 | GET /api/v1/dev/consents |
- | (테스트 미작성) |
| 사용자 동의 철회 | DELETE /api/v1/dev/consents |
- | (테스트 미작성) |
참고: dev_handler.go 내의 기능들은 백엔드에 구현되어 있으나, 이번 커버리지 90% 달성 목표(핵심 인증 로직 중심)에서 관리자 기능으로 분류되어 우선순위가 조정되었습니다.
2. userfront (사용자 포털)
userfront는 최종 사용자가 애플리케이션(RP)의 정보 접근 요청을 승인하거나 거부하는 OIDC 동의 화면 및 연동 관리를 처리합니다.
2.1. OIDC 동의 (Consent) 및 연동 관리
userfront 기능 |
백엔드 API | 검증 테스트 파일 | 테스트 상태 |
|---|---|---|---|
| 동의 정보 조회 | GET /api/v1/auth/consent |
auth_handler_consent_test.go |
TestGetConsentRequest_Normal |
| 동의 승인 | POST /api/v1/auth/consent/accept |
auth_handler_consent_test.go |
TestAcceptConsentRequest_Normal |
| 동의 거부 | POST /api/v1/auth/consent/reject |
- | (테스트 미작성) |
| 연동된 앱 목록 조회 | GET /api/v1/user/rp/linked |
auth_handler_linked_test.go |
TestListLinkedRps_PriorityAndAggregation |
| 연동 해제 (Revoke) | DELETE /api/v1/user/rp/linked/:id |
auth_handler_client_test.go |
TestRevokeLinkedRp_Success |
| 연동 이력 조회 | GET /api/v1/user/rp/history |
auth_handler_client_test.go |
TestListRpHistory_Aggregation |
2.2. 인증 플로우 (Login Flows)
userfront 기능 |
백엔드 API | 검증 테스트 파일 | 테스트 상태 |
|---|---|---|---|
| QR 로그인 초기화 | POST /api/v1/auth/qr/init |
auth_handler_qr_test.go |
TestQRLoginFlow_Success |
| QR 로그인 승인 (Scan) | POST /api/v1/auth/qr/approve |
auth_handler_qr_test.go |
TestScanQRLogin_Success |
| 매직 링크 초기화 | POST /api/v1/auth/enchanted-link/init |
auth_handler_link_test.go |
TestEnchantedLinkFlow_Email_Success |
| 매직 링크 검증 | POST /api/v1/auth/magic-link/verify |
auth_handler_link_test.go |
TestEnchantedLinkFlow_Email_Success |