JWT 인증 플로우

JWT 토큰 사양

항목	값
알고리즘	HS256 (HMAC SHA-256)
Access Token 유효기간	14일
Refresh Token 유효기간	21일
전달 방식	Authorization: Bearer <token>

Access Token Claims

{
  "sub": "userId",
  "auth": "ROLE_INFLUENCE",
  "userId": "user123",
  "username": "홍길동",
  "userImage": "프로필이미지URL",
  "onboardingCompleted": true
}

인증 시퀀스

클라이언트 요청이 JwtAuthFilter를 거쳐 인증되는 전체 흐름입니다.

토큰 갱신 플로우

Access Token이 만료되면 Refresh Token으로 새 토큰 쌍을 발급받습니다.

인증 제외 경로 (permitAll)

아래 경로는 JWT 인증 없이 접근할 수 있습니다.

경로 패턴	설명
/ai/auth/**	로그인, 회원가입, 토큰 갱신
/business/login	비즈니스 로그인
/ai/oauth/**	OAuth 소셜 로그인
/health	헬스체크

역할별 접근 권한

인증된 사용자는 역할에 따라 접근 가능한 경로가 제한됩니다.

경로 패턴	필요 권한
/admin/**	ROLE_ADMIN
/ai/admin/**	ROLE_ADMIN
/ai/payments/**	ROLE_BUSINESS
/ai/influence/**	ROLE_INFLUENCE