spring-security/samples/boot/saml2login
Joe Grandja 86ca6b013c Unlock dependencies
This reverts commit 206960cf44.
2020-05-06 17:27:35 -04:00
..
src Update SAML2 errors in integration tests 2020-05-06 11:46:54 -04:00
README.adoc Polish SAML 2.0 Login Sample 2020-03-20 16:50:48 -06:00
spring-security-samples-boot-saml2login.gradle HttpSecurity.saml2login() - MVP Core Code 2019-09-05 14:40:08 -07:00

README.adoc

= OAuth 2.0 Login Sample

This guide provides instructions on setting up this SAML 2.0 Login sample application.

The sample application uses Spring Boot and the `spring-security-saml2-service-provider`
module which is new in Spring Security 5.2.

== Goals

`saml2Login()` provides a very simple implementation of a Service Provider that can receive a SAML 2.0 Response via the HTTP-POST and HTTP-REDIRECT bindings against the SimpleSAMLphp SAML 2.0 reference implementation.

The following features are implemented in the MVP:

1. Receive and validate a SAML 2.0 Response containing an assertion, and create a corresponding authentication in Spring Security
2. Send a SAML 2.0 AuthNRequest to an Identity Provider
3. Provide a framework for components used in SAML 2.0 authentication that can be swapped by configuration
4. Work against the SimpleSAMLphp reference implementation

== Run the Sample

=== Start up the Sample Boot Application
```
 ./gradlew :spring-security-samples-boot-saml2login:bootRun
```

=== Open a Browser

http://localhost:8080/

You will be redirect to the SimpleSAMLphp IDP

=== Type in your credentials

```
User: user
Password: password
```