- This project demonstrates a Spring Boot microservices architecture with JWT-based authentication and role-based access control. The setup includes an API Gateway to manage routing and authentication.
- Roles and Permissions:
- Admin and User roles each have their own authentication and authorization mechanisms defined by their roles.
- Admin can:
- Create products
- Retrieve all products
- Retrieve products by ID
- Update products by ID
- Delete products by ID
- User can:
- Retrieve all products
- Retrieve products by ID
Method | Url | Description | Request Body | Header | Valid Path Variable | No Path Variable |
---|---|---|---|---|---|---|
POST | /api/v1/authentication/admin/register | Admin Register | AdminRegisterRequest | |||
POST | /api/v1/authentication/admin/login | Admin Login | LoginRequest | |||
POST | /api/v1/authentication/admin/refreshtoken | Admin Refresh Token | TokenRefreshRequest | |||
POST | /api/v1/authentication/admin/logout | Admin Logout | TokenInvalidateRequest | |||
POST | /api/v1/authentication/user/register | User Register | UserRegisterRequest | |||
POST | /api/v1/authentication/user/login | User Login | LoginRequest | |||
POST | /api/v1/authentication/user/refreshtoken | User Refresh Token | TokenRefreshRequest | |||
POST | /api/v1/authentication/user/logout | User Logout | TokenInvalidateRequest | |||
POST | /api/v1/products | Create Product | ProductCreateRequest | |||
GET | /api/v1/products/{productId} | Get Product By Id | ProductId | |||
GET | /api/v1/products | Get Products | ProductPagingRequest | |||
PUT | /api/v1/products/{productId} | Update Product By Id | ProductUpdateRequest | ProductId | ||
DELETE | /api/v1/products/{productId} | Delete Product By Id | ProductId | |||
- Java 21
- Spring Boot 3.0
- Restful API
- Lombok
- Maven
- Junit5
- Mockito
- Integration Tests
- Docker
- Docker Compose
- CI/CD (Github Actions)
- Spring Cloud
- Postman
- Spring Security
- JWT
Import postman collection under postman_collection folder
DATABASE_USERNAME={DATABASE_USERNAME}
DATABASE_PASSWORD={DATABASE_PASSWORD}
- Maven or Docker
The application can be built and run by the Docker
engine. The Dockerfile
has multistage build, so you do not need to build and run separately.
Please follow directions shown below in order to build and run the application with Docker Compose file;
$ cd springbootmicroserviceswithsecurity
$ docker-compose up -d
If you change anything in the project and run it on Docker, you can also use this command shown below
$ cd springbootmicroserviceswithsecurity
$ docker-compose up --build
To build and run the application with Maven
, please follow the directions shown below;
$ cd springbootmicroserviceswithsecurity
$ cd eurekaserver
$ mvn clean install
$ mvn spring-boot:run
$ cd ..
$ cd apigateway
$ mvn clean install
$ mvn spring-boot:run
$ cd ..
$ cd authservice
$ mvn clean install
$ mvn spring-boot:run
$ cd ..
$ cd userservice
$ mvn clean install
$ mvn spring-boot:run
$ cd ..
$ cd productservice
$ mvn clean install
$ mvn spring-boot:run
https://hub.docker.com/repository/docker/noyandocker/springbootmicroserviceswithsecurityeurekaserver/general
https://hub.docker.com/repository/docker/noyandocker/springbootmicroserviceswithsecurityapigateway/general
https://hub.docker.com/repository/docker/noyandocker/springbootmicroserviceswithsecurityauthservice/general
https://hub.docker.com/repository/docker/noyandocker/springbootmicroserviceswithsecurityuserservice/general
https://hub.docker.com/repository/docker/noyandocker/springbootmicroserviceswithsecurityproductservice/general