This post is the second part of a 3 post series exploring ways to enable SSO with an OAuth2 provider for Spring Boot 2 based applications. The 3 posts are:

1.Ways to bootstrap an OpenID Connect compliant OAuth2 Authorization Server/OpenID Provider

2. Legacy Spring Boot/Spring 5 approach to integrating with an OAuth2 Authorization Server/OpenID Provider – this post

3. Newer Spring Boot 2/Spring 5 approach to integrating with an OAuth2 Authorization Server/OpenID Connect Provider – coming soon

The post will explore a legacy Spring Boot 2/Spring Security 5 approach to enabling OAuth2 based authentication mechanism for an application, this post assumes that all the
steps in the previous blog post have been followed and UAA is up and running.

A question that probably comes to mind is why I am talking about legacy in the context of Spring Boot 2/Spring Security 5 when this should have been the new way of doing SSO! The reason is, as developers we have been using an approach with Spring Boot 1.5.x that is now considered deprecated, there are features in it however that has not been completely ported over to the new approach(ability to spin up an OAuth2 authorization server and ability to create an OAuth2 resource server are examples), in the interim, Spring Security developers(thanks
Rob Winch & Joe Grandja) provided a bridge to the legacy approach in the form of a spring-security-oauth2-boot project.

Approach

So what does the legacy approach look like – I have detailed it once before here, to recap it works on the basis of an annotation called @EnableOAuth2SSO and a set of properties supporting this annotation, a sample security configuration looks like this –

import org.springframework.boot.autoconfigure.security.oauth2.client.EnableOAuth2Sso;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.builders.WebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@EnableOAuth2Sso
@Configuration
public class OAuth2SecurityConfig extends WebSecurityConfigurerAdapter {
 @Override
 public void configure(WebSecurity web) throws Exception {
 super.configure(web);

 web.ignoring()
 .mvcMatchers("/favicon.ico", "/webjars/**", "/css/**");
 }

 @Override
 protected void configure(HttpSecurity http) throws Exception {
 http.csrf().disable();

 http.authorizeRequests()
 .antMatchers("/secured/**")
 .authenticated()
 .antMatchers("/")
 .permitAll()
 .anyRequest()
 .authenticated();
 }

}

and the set of supporting properties to point to the UAA is the following:

ssoServiceUrl: http://localhost:8080/uaa

security:
 oauth2:
 client:
 client-id: client1
 client-secret: client1
 access-token-uri: ${ssoServiceUrl}/oauth/token
 user-authorization-uri: ${ssoServiceUrl}/oauth/authorize
 resource:
 jwt:
 key-uri: ${ssoServiceUrl}/token_key
 user-info-uri: ${ssoServiceUrl}/userinfo

With the spring-security-oauth2-boot project pulled in as a dependency:

compile 'org.springframework.cloud:spring-cloud-starter-oauth2'
compile("org.springframework.security.oauth.boot:spring-security-oauth2-autoconfigure:2.0.0.BUILD-SNAPSHOT")

these annotations just work for a Spring Boo2 application also. Note however Spring Boot 2 supports two distinct Web Frameworks – Spring Web and Spring Webflux, this approach pulls in Spring Web transitively which forces Spring Web as the default framework.

The sample in its entirety with ways to start it up is available in my github repo here – https://github.com/bijukunjummen/oauth2-boot2

Testing

Any uri starting with “/secured/**” is SSO enabled, if the index page is accessed it is displayed without needing any authentication:

👁 Image

Now, clicking through to a uri starting with “/secured/**” should trigger a OAuth2 Authorization Code flow:

👁 Image

and should present a login screen to the user via UAA:

👁 Image

Logging in with the credentials that were created before – user1/user1 should redirect the user back to the Spring Boot 2 legacy version of the app and should display the secured page:

👁 Image

This completes the legacy approach to SSO with Spring Boot 2. Note that this is just pseudo-authentication, OAuth2 is meant more for authorization to access a users resource than authentication the way it is used here. An article which clarifies this is available here. The next post with native Spring Security 5/Spring Boot2 will provide a cleaner authentication mechanism using OpenID Connect.