🔐 JWT Spring Security template

Spring Boot template with core Spring JWT-based Security setup. The implementation includes access and refresh tokens. Template utilizes modern libraries and approaches to securing application.

---

Technologies used • Demo • How to use

---

Technologies used

Spring Boot — core backend framework.
Spring Security — authentication and authorization system.
Spring Data JPA + Hibernate — ORM and data persistence.
MySQL — relational database.
Flyway — data migration tool.
JJWT — jwt encoding and decoding.
Gradle — build automation tool.
Docker & Docker Compose — containerization and orchestration of Spring Boot app and MySQL instance.

---

Demo

How to use

---

• Have Docker installed on your local machine

---

• Clone the repository to your local machine

git clone https://github.com/antonio-backnotfront/security-jwt-template.git

---

• Create .env file in the root folder (on the same level as build.gradle) following the structure specified in .env.example file:

security-jwt-template/
├── .env.example  

---

• Run docker compose

docker compose up --build

---

• Access API endpoints under localhost:8080 and MySQL instance under localhost:3306.

---

• Authentication is performed via /api/auth/login and /api/auth/register.

---

• Access tokens are required for secured endpoints via the Authorization: Bearer <token> header.

---

• To refresh tokens, use the /api/auth/refresh endpoint with your refresh token inside Authorization: Bearer <token> header.

---

Copyright (c) 2025 Anton Solianyk