Spring WS JWT Security Example
Example for setting up JWT HTTP Security on a web service with Spring Boot.
Usage
Just run it as any Spring boot application:
mvn spring-boot:run
And the web service be available at http://localhost:8080/.
Requests with Postman
To make things easier import src/test/resources/jwt_auth.postman_collection.json
into Postman. It includes all the queries needed to test the project.
Users
User | Password | Permissions |
---|---|---|
admin | 1234 | all |
noroles | 1111 | none |
locked | 1111 | all |
expired | 1111 | all |
disabled | 1111 | all |
expcreds | 1111 | all |
noread | 1111 | all minus read |
Features
- Spring MVC
- JWT security
- Basic Spring Boot security auditing
Documentation
Documentation is always generated for the latest release, kept in the 'master' branch:
Documentation is also generated from the latest snapshot, taken from the 'develop' branch:
The documentation site is actually a Maven site, and its sources are included in the project. If required it can be generated by using the following Maven command:
mvn verify site
The verify phase is required, otherwise some of the reports won't be generated.
Collaborate
Any kind of help with the project will be well received, and there are two main ways to give such help:
- Reporting errors and asking for extensions through the issues management
- or forking the repository and extending the project
Issues management
Issues are managed at the GitHub project issues tracker, where any Github user may report bugs or ask for new features.
Getting the code
If you wish to fork or modify the code, visit the GitHub project page, where the latest versions are always kept. Check the 'master' branch for the latest release, and the 'develop' for the current, and stable, development version.
License
The project has been released under the MIT License.