[Improvement] 이메일 인증/재전송 강화 (WP-AUTH-03) #205

Closed
opened 2026-02-25 01:37:05 +00:00 by seonkyu.kim · 0 comments
Owner

작업 배경

PRD FR-AUTH-003: "이메일 인증 검증은 세션 기반 입력을 지원한다"
PRD FR-AUTH-004: "이메일 인증 재전송 API를 제공한다"

현재 문제

  • POST /v1/in/auth/email/verify — email+code만 지원 (verifySessionId 미지원)
  • 재전송 API 없음 — FE "코드 재전송" 버튼 동작 불가
  • 인증 시도 횟수 제한 없음 — 무차별 시도 가능
  • VerifyEmailAsync 반환값 void — FE에 분기 정보 제공 불가

작업 항목

  • ErrorCodes 추가 (VerifyResendCooldown, VerifyAttemptExceeded)
  • EmailVerifyRequestDto에 verifySessionId 필드 추가
  • 신규 DTO 3개 (EmailVerifyResponseDto, EmailResendRequestDto, EmailResendResponseDto)
  • IAuthService 시그니처 변경 + ResendVerificationAsync 추가
  • AuthService VerifyEmailAsync 확장 + ResendVerificationAsync 구현
  • AuthController verify 수정 + resend 엔드포인트 추가
  • email_verify TTL 1시간→5분 변경 (signup/login 포함)
  • 빌드 검증 통과

변경 API

메서드 엔드포인트 변경사항
POST /v1/in/auth/email/verify verifySessionId 지원, 시도횟수 제한, 응답DTO 추가
POST /v1/in/auth/email/verify/resend 신규 — 인증코드 재전송
## 작업 배경 PRD FR-AUTH-003: "이메일 인증 검증은 세션 기반 입력을 지원한다" PRD FR-AUTH-004: "이메일 인증 재전송 API를 제공한다" ## 현재 문제 - `POST /v1/in/auth/email/verify` — email+code만 지원 (verifySessionId 미지원) - 재전송 API 없음 — FE "코드 재전송" 버튼 동작 불가 - 인증 시도 횟수 제한 없음 — 무차별 시도 가능 - VerifyEmailAsync 반환값 void — FE에 분기 정보 제공 불가 ## 작업 항목 - [x] ErrorCodes 추가 (VerifyResendCooldown, VerifyAttemptExceeded) - [x] EmailVerifyRequestDto에 verifySessionId 필드 추가 - [x] 신규 DTO 3개 (EmailVerifyResponseDto, EmailResendRequestDto, EmailResendResponseDto) - [x] IAuthService 시그니처 변경 + ResendVerificationAsync 추가 - [x] AuthService VerifyEmailAsync 확장 + ResendVerificationAsync 구현 - [x] AuthController verify 수정 + resend 엔드포인트 추가 - [x] email_verify TTL 1시간→5분 변경 (signup/login 포함) - [x] 빌드 검증 통과 ## 변경 API | 메서드 | 엔드포인트 | 변경사항 | |--------|-----------|---------| | POST | /v1/in/auth/email/verify | verifySessionId 지원, 시도횟수 제한, 응답DTO 추가 | | POST | /v1/in/auth/email/verify/resend | **신규** — 인증코드 재전송 |
seonkyu.kim added the
Priority
Medium
Status
In Progress
Type
Improvement
labels 2026-02-25 01:37:15 +00:00
seonkyu.kim self-assigned this 2026-02-25 01:37:17 +00:00
seonkyu.kim added this to the Phase 0: 공통 기반 + 인증 milestone 2026-02-25 01:37:17 +00:00
seonkyu.kim added
Status
Done
and removed
Status
In Progress
labels 2026-02-25 01:41:19 +00:00
Sign in to join this conversation.
No description provided.