Repository navigation
Auth Architecture
wcorn edited this page Apr 5, 2026
·
1 revision
┌──────────────┐ ┌──────────────────┐ ┌─────────┐
│ Frontend │─────▶│ Backend │─────▶│ MySQL │
│ (React) │◀─────│ (Spring Boot) │─────▶│ │
└──────────────┘ └──────────────────┘ └─────────┘
│
▼
┌─────────┐
│ Redis │
│ (RT저장) │
└─────────┘
Client Backend MySQL Redis
│ │ │ │
│ POST /api/auth/login │ │ │
│ {loginId, password} │ │ │
│─────────────────────────▶│ │ │
│ │ SELECT user │ │
│ │──────────────────────▶│ │
│ │ user data │ │
│ │◀──────────────────────│ │
│ │ │ │
│ │ password 검증 (BCrypt)│ │
│ │ │ │
│ │ Refresh Token 저장 │ │
│ │──────────────────────────────────▶│
│ │ │ │
│ {accessToken} │ │ │
│ Set-Cookie: refreshToken│ │ │
│◀─────────────────────────│ │ │
Client Backend Redis
│ │ │
│ POST /api/auth/reissue │ │
│ Cookie: refreshToken │ │
│─────────────────────────▶│ │
│ │ RT 조회/검증 │
│ │──────────────────────▶│
│ │ 유효한 RT │
│ │◀──────────────────────│
│ │ │
│ │ 기존 RT 삭제 + 새 RT 저장 (Rotation)
│ │──────────────────────▶│
│ │ │
│ {accessToken} │ │
│ Set-Cookie: refreshToken│ │
│◀─────────────────────────│ │
Client Backend Redis
│ │ │
│ POST /api/auth/logout │ │
│ Cookie: refreshToken │ │
│─────────────────────────▶│ │
│ │ RT 삭제 │
│ │──────────────────────▶│
│ │ │
│ Clear-Cookie │ │
│◀─────────────────────────│ │
| 항목 | Access Token | Refresh Token |
|---|---|---|
| 만료 시간 | 30분 | 14일 |
| 저장 위치 (클라이언트) | 메모리 (JS 변수) | HttpOnly Cookie |
| 저장 위치 (서버) | 저장 안 함 (Stateless) | Redis |
| 전달 방식 | Authorization: Bearer 헤더 | Cookie 자동 전송 |
| 갱신 | Refresh Token으로 재발급 | Rotation (재발급 시 교체) |
토큰 갱신 시 기존 Refresh Token을 폐기하고 새로운 Refresh Token을 발급한다. 탈취된 토큰의 재사용을 방지한다.
Spring Security 필터 체인에 JWT 인증 필터를 추가한다.
요청 → JwtAuthenticationFilter → Controller
│
├─ Authorization 헤더에서 AT 추출
├─ AT 유효 → SecurityContext에 인증 정보 설정 → 통과
├─ AT 만료 → 401 응답 (클라이언트가 /reissue 호출)
└─ AT 없음 → 미인증 상태로 통과 (보호된 엔드포인트에서 403)
| 경로 | 접근 |
|---|---|
POST /api/auth/login |
허용 |
POST /api/auth/reissue |
허용 |
/actuator/health |
허용 |
/swagger-ui/**, /v3/api-docs/**
|
허용 |
| 그 외 모든 경로 | 인증 필요 |