[feat] Refresh Token 기반 JWT 인증 로직 추가 및 로그아웃/재발급 API 구현 #53
Conversation
seung-in-Yoo
added
💡 feature
|
""" Walkthrough리프레시 토큰 기반의 인증 기능이 추가되었습니다. 신규 엔티티와 리포지토리로 리프레시 토큰을 관리하며, 로그인 시 액세스/리프레시 토큰을 모두 발급합니다. Changes
Sequence Diagram(s)sequenceDiagram
participant Client
participant UserController
participant AuthService
participant JwtTokenProvider
participant RefreshTokenRepository
Client->>UserController: POST /login (로그인 요청)
UserController->>AuthService: login()
AuthService->>JwtTokenProvider: generateAccessToken()
AuthService->>JwtTokenProvider: generateRefreshToken()
AuthService->>RefreshTokenRepository: deleteByUserId()
AuthService->>RefreshTokenRepository: save(refreshToken)
AuthService-->>UserController: TokenResponseDto (access+refresh)
UserController-->>Client: 응답 (access+refresh 토큰)
Client->>UserController: POST /reissue (refreshToken 전달)
UserController->>AuthService: reissue(refreshToken)
AuthService->>RefreshTokenRepository: findByToken()
AuthService->>JwtTokenProvider: getUserId(refreshToken)
AuthService->>JwtTokenProvider: generateAccessToken()
AuthService-->>UserController: TokenResponseDto (access+refresh)
UserController-->>Client: 응답 (새 access, 기존 refresh)
Client->>UserController: POST /logout (Authorization: Bearer accessToken)
UserController->>JwtTokenProvider: getUserId(accessToken)
UserController->>AuthService: logout(userId)
AuthService->>RefreshTokenRepository: deleteByUserId()
AuthService-->>UserController: 완료
UserController-->>Client: 성공 메시지
Possibly related PRs
Suggested labels
Suggested reviewers
Poem
📜 Recent review detailsConfiguration used: CodeRabbit UI 📒 Files selected for processing (5)
🚧 Files skipped from review as they are similar to previous changes (4)
🔇 Additional comments (3)
✨ Finishing Touches
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
SupportNeed help? Create a ticket on our support page for assistance with any issues or questions. Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
CodeRabbit Configuration File (
|
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 5
🧹 Nitpick comments (3)
src/main/java/com/wayble/server/user/entity/RefreshToken.java (2)
24-25: 만료 시간 필드 타입 개선 제안expiry 필드를 Long 타입으로 사용하는 것보다 LocalDateTime을 사용하는 것이 더 명확하고 안전합니다.
+import java.time.LocalDateTime; + @Column(nullable = false) -private Long expiry; // 만료 시간 +private LocalDateTime expiry; // 만료 시간이 경우 JwtTokenProvider에서도 해당 변경사항을 반영해야 합니다.
12-26: User 엔티티와의 관계 설정 고려현재 userId를 Long 타입으로 직접 참조하고 있는데, JPA의 @manytoone 관계를 사용하여 User 엔티티와의 관계를 명시적으로 설정하는 것을 고려해 보세요.
+@ManyToOne(fetch = FetchType.LAZY) +@JoinColumn(name = "user_id", nullable = false, unique = true) +private User user; - -@Column(nullable = false, unique = true) // 1인 1토큰 -private Long userId;단, 현재 구조도 충분히 동작하므로 선택사항입니다.
src/main/java/com/wayble/server/user/service/auth/AuthService.java (1)
26-46: 로그인 로직이 잘 구현되었습니다.기존 refresh token을 삭제하고 새로 생성하는 방식이 적절합니다. 다만, 동시성 문제를 완전히 방지하려면 이 메서드에도
@Transactional어노테이션을 추가하는 것을 고려해보세요.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (8)
src/main/java/com/wayble/server/common/config/SecurityConfig.java(1 hunks)src/main/java/com/wayble/server/common/config/security/JwtProperties.java(2 hunks)src/main/java/com/wayble/server/common/config/security/jwt/JwtTokenProvider.java(2 hunks)src/main/java/com/wayble/server/user/controller/UserController.java(3 hunks)src/main/java/com/wayble/server/user/dto/token/TokenResponseDto.java(1 hunks)src/main/java/com/wayble/server/user/entity/RefreshToken.java(1 hunks)src/main/java/com/wayble/server/user/repository/RefreshTokenRepository.java(1 hunks)src/main/java/com/wayble/server/user/service/auth/AuthService.java(3 hunks)
🧰 Additional context used
🧠 Learnings (1)
src/main/java/com/wayble/server/user/entity/RefreshToken.java (1)
Learnt from: seung-in-Yoo
PR: Wayble-Project/wayble-spring#37
File: src/main/java/com/wayble/server/user/entity/User.java:61-62
Timestamp: 2025-07-13T15:08:59.288Z
Learning: Java에서 같은 패키지 내의 클래스들은 import 구문 없이 서로를 참조할 수 있다. com.wayble.server.user.entity 패키지 내의 클래스들은 명시적인 import 없이 사용 가능하다.
🔇 Additional comments (8)
src/main/java/com/wayble/server/user/dto/token/TokenResponseDto.java (1)
3-3: 리프레시 토큰 필드 추가 승인accessToken과 refreshToken을 모두 포함하는 DTO 구조로 적절하게 수정되었습니다. record 타입 사용으로 불변성과 간결성을 동시에 확보했습니다.
src/main/java/com/wayble/server/common/config/security/JwtProperties.java (2)
12-12: 리프레시 토큰 만료 시간 설정 추가 승인리프레시 토큰의 만료 시간을 설정할 수 있는 refreshExp 필드가 적절하게 추가되었습니다.
31-33: 환경 설정에 refreshExp 프로퍼티 추가 확인 요청
JwtProperties.java에 새로 추가된refreshExp필드가 애플리케이션 설정 파일에 반영되어 있는지 검토해 주세요.확인 대상 파일:
application.yml/application.yaml(jwt.refresh-exp:또는refreshExp:)application.properties(jwt.refresh-exp=)필요 시 해당 키를 추가하거나, 기본값을 문서화해 주세요.
src/main/java/com/wayble/server/user/entity/RefreshToken.java (1)
18-19: 1인 1토큰 제약조건 적절히 설정됨userId에 unique 제약조건을 설정하여 사용자당 하나의 리프레시 토큰만 유지하도록 한 것은 보안상 적절한 설계입니다.
src/main/java/com/wayble/server/user/repository/RefreshTokenRepository.java (1)
8-12: 리포지토리 메서드 구조 적절함필요한 CRUD 작업을 위한 메서드들이 Spring Data JPA 네이밍 컨벤션에 따라 적절히 정의되었습니다.
src/main/java/com/wayble/server/common/config/security/jwt/JwtTokenProvider.java (1)
34-41: Refresh token 생성 로직이 적절합니다.Refresh token에는 최소한의 정보만 포함하고 role claim을 제외한 것이 보안 관점에서 좋은 선택입니다.
src/main/java/com/wayble/server/user/controller/UserController.java (1)
63-82: Token 재발급 엔드포인트가 잘 구현되었습니다.RESTful 규칙을 잘 따르고 있으며, OpenAPI 문서화도 명확합니다.
src/main/java/com/wayble/server/user/service/auth/AuthService.java (1)
66-69: 로그아웃 구현이 깔끔합니다.Refresh token을 삭제하여 로그아웃을 처리하는 방식이 적절합니다.
| "/api/v1/users/reissue", | ||
| "/api/v1/users/logout", |
There was a problem hiding this comment.
🛠️ Refactor suggestion
로그아웃 엔드포인트의 보안 설정 재검토 필요
/api/v1/users/logout 엔드포인트를 인증 없이 접근 가능하도록 설정하는 것은 보안상 위험할 수 있습니다. 로그아웃은 인증된 사용자만 수행해야 하는 작업입니다.
제안사항:
- reissue 엔드포인트는 리프레시 토큰 검증이 필요하므로 permitAll() 유지 가능
- logout 엔드포인트는 액세스 토큰 검증이 필요하므로 authenticated() 요구 권장
.requestMatchers(
"/api/v1/users/signup",
"/api/v1/users/login",
"/api/v1/users/reissue",
- "/api/v1/users/logout",
"/swagger-ui/**",
"/v3/api-docs/**"
).permitAll()📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| "/api/v1/users/reissue", | |
| "/api/v1/users/logout", | |
| http | |
| .authorizeRequests() | |
| .requestMatchers( | |
| "/api/v1/users/signup", | |
| "/api/v1/users/login", | |
| "/api/v1/users/reissue", | |
| "/swagger-ui/**", | |
| "/v3/api-docs/**" | |
| ).permitAll() | |
| // all other endpoints (including /api/v1/users/logout) now require authentication | |
| .anyRequest().authenticated(); |
🤖 Prompt for AI Agents
In src/main/java/com/wayble/server/common/config/SecurityConfig.java around
lines 39 to 40, the /api/v1/users/logout endpoint is currently configured to
allow access without authentication, which is a security risk. Modify the
security configuration to require authentication for the logout endpoint by
replacing permitAll() with authenticated() for this path, while keeping
permitAll() for the /api/v1/users/reissue endpoint as it requires refresh token
validation.
| public interface RefreshTokenRepository extends JpaRepository<RefreshToken, Long> { | ||
| Optional<RefreshToken> findByUserId(Long userId); | ||
| Optional<RefreshToken> findByToken(String token); | ||
| void deleteByUserId(Long userId); |
There was a problem hiding this comment.
🛠️ Refactor suggestion
삭제 메서드에 @transactional 추가 권장
deleteByUserId 메서드는 데이터를 삭제하는 작업이므로 @transactional 어노테이션을 추가하는 것이 좋습니다.
+import org.springframework.transaction.annotation.Transactional;
+
+@Transactional
void deleteByUserId(Long userId);📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| void deleteByUserId(Long userId); | |
| import org.springframework.transaction.annotation.Transactional; | |
| @Transactional | |
| void deleteByUserId(Long userId); |
🤖 Prompt for AI Agents
In src/main/java/com/wayble/server/user/repository/RefreshTokenRepository.java
at line 11, the deleteByUserId method performs a data deletion operation and
should be annotated with @Transactional to ensure the operation is executed
within a transaction. Add the @Transactional annotation above the deleteByUserId
method declaration to properly manage the transaction scope during deletion.
#️⃣ 연관된 이슈
#41
📝 작업 내용
📸 스크린샷
회원가입 및 토큰 발급
refresh token 토큰 DB에 저장
토큰 재발급
로그아웃
💬 리뷰 요구사항 (선택)
Summary by CodeRabbit
신규 기능
기타