An open API service indexing awesome lists of open source software.

https://github.com/bernardo-mg/spring-ws-jwt-security-example

Example for JWT Security with Spring
https://github.com/bernardo-mg/spring-ws-jwt-security-example

example jwt spring-security spring-ws

Last synced: 11 months ago
JSON representation

Example for JWT Security with Spring

Awesome Lists containing this project

README

          

# Spring WS JWT Security Example

Example for setting up JWT HTTP Security on a web service with Spring Boot.

## Usage

Start the Docker image:

```
docker-compose -f docker/docker-compose.yml --project-name spring-ws-jwt-security-example up
```

And the web service be available at [http://localhost:8080/](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](https://spring.io/)
- JWT security
- Basic Spring Boot security auditing

## Documentation

The documentation site is actually a Maven site, its sources are included in the project. 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 built.

## 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][issues], 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][scm], 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][license].

[issues]: https://github.com/bernardo-mg/spring-ws-jwt-security-example/issues
[license]: https://www.opensource.org/licenses/mit-license.php
[scm]: https://github.com/bernardo-mg/spring-ws-jwt-security-example