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

An example showing how to set up web security with Spring MVC.
https://github.com/bernardo-mg/spring-mvc-security-example

example spring-mvc spring-security

Last synced: 2 months ago
JSON representation

An example showing how to set up web security with Spring MVC.

• Host: GitHub
• URL: https://github.com/bernardo-mg/spring-mvc-security-example
• Owner: Bernardo-MG
• License: mit
• Created: 2017-08-21T19:30:35.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-05-12T23:44:54.000Z (over 1 year ago)
• Last Synced: 2024-04-15T15:48:46.560Z (10 months ago)
• Topics: example, spring-mvc, spring-security
• Language: Java
• Homepage:
• Size: 783 KB
• Stars: 6
• Watchers: 3
• Forks: 0
• Open Issues: 15
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Spring MVC Security Example

Sample [Spring MVC][spring-mvc] project with web security.

Handles user authentication, and access restrictions.

Currently it only supports authenticating through the application itself, and not through external services.

As this is a Spring Boot app it may be run with Maven or through your preferred IDE.

```

mvn spring-boot:run

```

Once running it will be accessible at [http://localhost:8080/](http://localhost:8080/).

[![Release docs](https://img.shields.io/badge/docs-release-blue.svg)][site-release]

[![Development docs](https://img.shields.io/badge/docs-develop-blue.svg)][site-develop]

[![Release javadocs](https://img.shields.io/badge/javadocs-release-blue.svg)][javadoc-release]

[![Development javadocs](https://img.shields.io/badge/javadocs-develop-blue.svg)][javadoc-develop]

## Features

The project by default comes with a useful series of features:

* Login form handling

* Encrypted passwords

* Roles and privileges model

* User status (enabled/expired/locked)

* CSRF token

* Remember-me support

* Security annotations

* OAuth authentication

## Documentation

Documentation is always generated for the latest release, kept in the 'master' branch:

- The [latest release documentation page][site-release].

- The [latest release Javadoc site][javadoc-release].

Documentation is also generated from the latest snapshot, taken from the 'develop' branch:

- The [the latest snapshot documentation page][site-develop].

- The [latest snapshot Javadoc site][javadoc-develop].

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][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-mvc-security-example/issues

[javadoc-develop]: https://docs.bernardomg.com/development/maven/spring-mvc-security-example/apidocs

[javadoc-release]: https://docs.bernardomg.com/maven/spring-mvc-security-example/apidocs

[license]: http://www.opensource.org/licenses/mit-license.php

[scm]: https://github.com/bernardo-mg/spring-mvc-security-example

[site-develop]: https://docs.bernardomg.com/development/maven/spring-mvc-security-example

[site-release]: https://docs.bernardomg.com/maven/spring-mvc-security-example

[spring-mvc]: https://spring.io