Skip to content

Auth Architecture

wcorn edited this page Apr 5, 2026 · 1 revision

시스템 아키텍처: 인증 모듈

1. 전체 구조

┌──────────────┐      ┌──────────────────┐      ┌─────────┐
│   Frontend   │─────▶│     Backend      │─────▶│  MySQL   │
│   (React)    │◀─────│  (Spring Boot)   │─────▶│         │
└──────────────┘      └──────────────────┘      └─────────┘
                              │
                              ▼
                        ┌─────────┐
                        │  Redis  │
                        │ (RT저장) │
                        └─────────┘

2. 인증 흐름

2.1 로그인

Client                    Backend                  MySQL        Redis
  │                          │                       │            │
  │  POST /api/auth/login    │                       │            │
  │  {loginId, password}     │                       │            │
  │─────────────────────────▶│                       │            │
  │                          │  SELECT user           │            │
  │                          │──────────────────────▶│            │
  │                          │  user data             │            │
  │                          │◀──────────────────────│            │
  │                          │                       │            │
  │                          │  password 검증 (BCrypt)│            │
  │                          │                       │            │
  │                          │  Refresh Token 저장    │            │
  │                          │──────────────────────────────────▶│
  │                          │                       │            │
  │  {accessToken}           │                       │            │
  │  Set-Cookie: refreshToken│                       │            │
  │◀─────────────────────────│                       │            │

2.2 토큰 갱신

Client                    Backend                  Redis
  │                          │                       │
  │  POST /api/auth/reissue  │                       │
  │  Cookie: refreshToken    │                       │
  │─────────────────────────▶│                       │
  │                          │  RT 조회/검증          │
  │                          │──────────────────────▶│
  │                          │  유효한 RT             │
  │                          │◀──────────────────────│
  │                          │                       │
  │                          │  기존 RT 삭제 + 새 RT 저장 (Rotation)
  │                          │──────────────────────▶│
  │                          │                       │
  │  {accessToken}           │                       │
  │  Set-Cookie: refreshToken│                       │
  │◀─────────────────────────│                       │

2.3 로그아웃

Client                    Backend                  Redis
  │                          │                       │
  │  POST /api/auth/logout   │                       │
  │  Cookie: refreshToken    │                       │
  │─────────────────────────▶│                       │
  │                          │  RT 삭제              │
  │                          │──────────────────────▶│
  │                          │                       │
  │  Clear-Cookie            │                       │
  │◀─────────────────────────│                       │

3. 토큰 전략

항목 Access Token Refresh Token
만료 시간 30분 14일
저장 위치 (클라이언트) 메모리 (JS 변수) HttpOnly Cookie
저장 위치 (서버) 저장 안 함 (Stateless) Redis
전달 방식 Authorization: Bearer 헤더 Cookie 자동 전송
갱신 Refresh Token으로 재발급 Rotation (재발급 시 교체)

3.1 Refresh Token Rotation

토큰 갱신 시 기존 Refresh Token을 폐기하고 새로운 Refresh Token을 발급한다. 탈취된 토큰의 재사용을 방지한다.

4. 인증 필터

Spring Security 필터 체인에 JWT 인증 필터를 추가한다.

요청 → JwtAuthenticationFilter → Controller
         │
         ├─ Authorization 헤더에서 AT 추출
         ├─ AT 유효 → SecurityContext에 인증 정보 설정 → 통과
         ├─ AT 만료 → 401 응답 (클라이언트가 /reissue 호출)
         └─ AT 없음 → 미인증 상태로 통과 (보호된 엔드포인트에서 403)

5. 보안 설정

경로 접근
POST /api/auth/login 허용
POST /api/auth/reissue 허용
/actuator/health 허용
/swagger-ui/**, /v3/api-docs/** 허용
그 외 모든 경로 인증 필요

Clone this wiki locally