https://github.com/stackpan/vivlio
Spring Boot RESTful API project that implement HATEOAS, authentication with JWT using OAuth2 Resource Server and method based authorization using built-in Spring Security
https://github.com/stackpan/vivlio
jpa jwt oauth2 spring-boot spring-security
Last synced: about 2 months ago
JSON representation
Spring Boot RESTful API project that implement HATEOAS, authentication with JWT using OAuth2 Resource Server and method based authorization using built-in Spring Security
- Host: GitHub
- URL: https://github.com/stackpan/vivlio
- Owner: stackpan
- Created: 2024-01-22T12:50:18.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-23T04:15:31.000Z (over 2 years ago)
- Last Synced: 2025-12-29T07:32:28.977Z (6 months ago)
- Topics: jpa, jwt, oauth2, spring-boot, spring-security
- Language: Java
- Homepage:
- Size: 97.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Vivlio
βιβλίο (Reading: Vivlio) in Greek means book. This is just simple Book management API. The goal of this project is to implementing HATEOAS architecture, authentication with JWT using OAuth2 Resource Server and method based authorization using built-in Spring Security. And also implement custom UserDetails and its service that can be persisted into database.
## Installation
Requirement:
- Java 21 or later
- PostgreSQL database server
Steps:
1. Migrate the database from file `database.sql` that already located in the root directory of this repository.
2. Generate private and public RSA key (you can use tool like [openssl](https://www.openssl.org/) to generate it). Feel free to locate those file anywhere in you machine but i prefer put them in project classpath (inside `src/main/resources` folder).
3. Configure the app. You can follow the example from `application.yaml.example` file inside `src/main/resources`.
4. Run the app: `./mvnw spring-boot:run`