https://github.com/guhyunwoo/auth-boilerplate
내 1년간의 정수를 담은 대해커톤용 jwt 보일러플레이트 코드 모두 공식문서 기반
https://github.com/guhyunwoo/auth-boilerplate
boilerplate java jwt jwt-authentication mysql redis spring-boot spring-security-jwt
Last synced: 10 months ago
JSON representation
내 1년간의 정수를 담은 대해커톤용 jwt 보일러플레이트 코드 모두 공식문서 기반
- Host: GitHub
- URL: https://github.com/guhyunwoo/auth-boilerplate
- Owner: guhyunwoo
- Created: 2025-08-19T07:09:28.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-19T07:49:53.000Z (10 months ago)
- Last Synced: 2025-08-19T09:46:53.857Z (10 months ago)
- Topics: boilerplate, java, jwt, jwt-authentication, mysql, redis, spring-boot, spring-security-jwt
- Language: Java
- Homepage:
- Size: 59.6 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Auth-Boilerplate
Spring Boot 기반 JWT 인증 보일러플레이트입니다.
회원가입, 로그인, 로그아웃, 토큰 리프레시 등 **JWT 기반 인증** 기능을 빠르게 구현할 수 있도록 설계했습니다.
---
## 주요 기능
* 회원가입 (Sign Up)
* 로그인 (Login)
* 로그아웃 (Logout)
* Access Token / Refresh Token 기반 인증
* JWT 토큰 발급 및 검증
* Refresh Token으로 Access Token 갱신
---
## 기술 스택
* Java 21
* Spring Boot 3.5.4
* Spring Security
* JJWT 0.12.6
* Gradle
* MySQL
* Redis
---
## 설치 및 실행
1. 레포지토리 클론
```bash
git clone https://github.com/guhyunwoo/auth-boilerplate.git
cd auth-boilerplate
```
2. 의존성 설치 및 빌드
```
./gradlew clean build
```
3. 애플리케이션 실행
```
./gradlew spring-boot:run
```
---
## API 예시
| 기능 | 엔드포인트 | 메서드 |
| ---------------- | ------------------- | ---- |
| 회원가입 | `/users/register` | POST |
| 로그인 | `/users/login` | POST |
| 로그아웃 | `/users/logout` | DELETE |
| Access Token 재발급 | `/users/refresh` | POST |
> 각 엔드포인트는 JWT 토큰을 사용하여 인증/인가 처리됩니다.
---
## 토큰 구조
* **Access Token**: 짧은 유효기간, API 접근용
* **Refresh Token**: 상대적으로 긴 유효기간, Access Token 갱신용
---
## 특징
* 보일러플레이트용 구조로, 다른 프로젝트에 쉽게 통합 가능
* Spring Security 기반으로 확장 용이
* JWT 예외 처리 및 커스텀 응답 구조 제공
---
## 향후 개선 예정
* OAuth2 연동
* 이메일 인증 기능
---
## 라이선스
MIT License