springboot之oauth2

　　一、OAuth2.0是OAuth协议的延续版本，但不向后兼容OAuth 1.0即完全废止了OAuth1.0。 OAuth 2.0关注客户端开发者的简易性。要么通过组织在资源拥有者和HTTP服务商之间的被批准的交互动作代表用户，要么允许第三方应用代表用户获得访问的权限。同时为Web应用，桌面应用和手机，和起居室设备提供专门的认证流程。

　　二、使用场景：

　　1、自己开发应用时，需要获取其他应用的资源。比如：使用QQ登录，然后获取QQ头像等信息

　　2、SSO认证服务器，在自己开发应用时使用统一的认证过程，不需要单独重写重写认证体系

　　三、概念　

　　（1） Third-party application：第三方应用程序，本文中又称"客户端"（client）。

　　（2）HTTP service：HTTP服务提供商，本文中简称"服务提供商"。

　　（3）Resource Owner：资源所有者，本文中又称"用户"（user）。

　　（4）User Agent：用户代理，本文中就是指浏览器。

　　（5）Authorization server：认证服务器，即服务提供商专门用来处理认证的服务器。

　　（6）Resource server：资源服务器，即服务提供商存放用户生成的资源的服务器。它与认证服务器，可以是同一台服务器，也可以是不同的服务器。

　　OAuth在"客户端"与"服务提供商"之间，设置了一个授权层（authorization layer）。"客户端"不能直接登录"服务提供商"，只能登录授权层，以此将用户与客户端区分开来。"客户端"登录授权层所用的令牌（token），与用户的密码不同。用户可以在登录的时候，指定授权层令牌的权限范围和有效期。

　　"客户端"登录授权层以后，"服务提供商"根据令牌的权限范围和有效期，向"客户端"开放用户储存的资料。

　　四、模式运行流程

　　

　　（A）用户打开客户端以后，客户端要求用户给予授权。

　　（B）用户同意给予客户端授权。

　　（C）客户端使用上一步获得的授权，向认证服务器申请令牌。

　　（D）认证服务器对客户端进行认证以后，确认无误，同意发放令牌。

　　（E）客户端使用令牌，向资源服务器申请获取资源。

　　（F）资源服务器确认令牌无误，同意向客户端开放资源。

　　五、授权模式

• 授权码模式（authorization code）
• 简化模式（implicit）
• 密码模式（resource owner password credentials）
• 客户端模式（client credentials）

　　1）授权码模式

　　

　　（A）用户访问客户端，后者将前者导向认证服务器。

　　（B）用户选择是否给予客户端授权。

　　（C）假设用户给予授权，认证服务器将用户导向客户端事先指定的"重定向URI"（redirection URI），同时附上一个授权码。

　　（D）客户端收到授权码，附上早先的"重定向URI"，向认证服务器申请令牌。这一步是在客户端的后台的服务器上完成的，对用户不可见。

　　（E）认证服务器核对了授权码和重定向URI，确认无误后，向客户端发送访问令牌（access token）和更新令牌（refresh token）。

　　2）简化模式

　　　

　　（A）客户端将用户导向认证服务器。

　　（B）用户决定是否给于客户端授权。

　　（C）假设用户给予授权，认证服务器将用户导向客户端指定的"重定向URI"，并在URI的Hash部分包含了访问令牌。

　　（D）浏览器向资源服务器发出请求，其中不包括上一步收到的Hash值。

　　（E）资源服务器返回一个网页，其中包含的代码可以获取Hash值中的令牌。

　　（F）浏览器执行上一步获得的脚本，提取出令牌。

　　（G）浏览器将令牌发给客户端。

　　3）密码模式

　　

　　（A）用户向客户端提供用户名和密码。

　　（B）客户端将用户名和密码发给认证服务器，向后者请求令牌。

　　（C）认证服务器确认无误后，向客户端提供访问令牌。

　　4）客户端模式

　　

　　（A）客户端向认证服务器进行身份认证，并要求一个访问令牌。

　　（B）认证服务器确认无误后，向客户端提供访问令牌。

　　六、授权码模式例子

　　这里说明一下这里主要只通过授权码模式来讲解oauth2的使用过程。

　　授权码模式（authorization code）是功能最完整、流程最严密的授权模式。它的特点就是通过客户端的后台服务器，与"服务提供商"的认证服务器进行互动。

　　简化模式（implicit grant type）不通过第三方应用程序的服务器，直接在浏览器中向认证服务器申请令牌，跳过了"授权码"这个步骤，因此得名。所有步骤在浏览器中完成，令牌对访问者是可见的，且客户端不需要认证。

　　密码模式（Resource Owner Password Credentials Grant）中，用户向客户端提供自己的用户名和密码。客户端使用这些信息，向"服务商提供商"索要授权。

　　客户端模式（Client Credentials Grant）指客户端以自己的名义，而不是以用户的名义，向"服务提供商"进行认证。严格地说，客户端模式并不属于OAuth框架所要解决的问题。在这种模式中，用户直接向客户端注册，客户端以自己的名义要求"服务提供商"提供服务，其实不存在授权问题。

　　相对来说授权码的方式使用上面，是非常严谨的。不存在，其他模式的相对弊病。

　　7、代码部分

　　1）需要的依赖

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.0.RELEASE</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.security.oauth.boot</groupId>
            <artifactId>spring-security-oauth2-autoconfigure</artifactId>
            <version>2.1.2.RELEASE</version>
        </dependency>
    </dependencies>

　　2）认证服务器

　　

　　主要配置：SecurityConfiguration、AuthServerConfiguration

@Configuration
@EnableWebSecurity
public class SecurityConfiguration extends WebSecurityConfigurerAdapter {

    @Autowired
    private BCryptPasswordEncoder passwordEncoder;

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .csrf().disable()
            .exceptionHandling()
        .and()
            .authorizeRequests()
            .anyRequest().authenticated()
        .and()
            .formLogin();
    }

    @Override
    protected void configure(AuthenticationManagerBuilder builder) throws Exception {
        //内存用户不多解释
        builder.inMemoryAuthentication()
                .withUser("admin")
                .password(passwordEncoder.encode("admin"))
                .roles("ADMIN");
    }

    @Override
    @Bean
    public AuthenticationManager authenticationManagerBean() throws Exception {
        return super.authenticationManagerBean();
    }

　　 @Bean
　　 @Override
　　 protected UserDetailsService userDetailsService() {
    　　return super.userDetailsService();
　　 }

}

@Configuration
@EnableAuthorizationServer
public class AuthServerConfiguration extends AuthorizationServerConfigurerAdapter {

    @Autowired
    private BCryptPasswordEncoder passwordEncoder;

    @Autowired
    private AuthenticationManager authenticationManager;

    @Override
    public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
        //这里client使用存在模式，可以实际过程调整为jdbc的方式
        //这里说明一下，redirectUris的连接可以是多个，这里通过access_token都可以访问的
        //简单点，就是授权的过程
        clients.inMemory()
                .withClient("client")
                .secret(passwordEncoder.encode("secret"))
                .authorizedGrantTypes("authorization_code", "refresh_token")
                .scopes("All")
                .autoApprove(true)
                .redirectUris("http://localhost:9001/login", "http://localhost:9002/login", "http://localhost:9003/authorize/login");
    }

    @Override
    public void configure(AuthorizationServerSecurityConfigurer security) throws Exception {
        //权限控制
        security.tokenKeyAccess("permitAll()")
                .checkTokenAccess("isAuthenticated()")
                .allowFormAuthenticationForClients();
    }

    @Override
    public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
        //认证体系使用security的方式
        endpoints.authenticationManager(authenticationManager);　

　　　　　 //允许调用方式

　　　　 endpoints.allowedTokenEndpointRequestMethods(HttpMethod.GET, HttpMethod.POST);
　　　　 endpoints.userDetailsService(userDetailsService);

    }

　　说明：这里我为了更好的区分，把认证服务器和资源服务器分开的，实际上可以使用认证服务器作为资源服务器

　　yaml配置

server:
  port: 9000
  servlet:
    context-path: /auth #这里一定要加上contextPath，这个坑自己体会吧

　　3）资源服务器

　　

　　主要配置：ResourceServerConfiguration、application.yaml

/**
 * 资源服务器的配置也很简单
 * 主要是EnableResourceServer，以及资源的控制
 */
@Configuration
@EnableResourceServer
public class ResourceServerConfiguration extends ResourceServerConfigurerAdapter {

    @Override
    public void configure(HttpSecurity http) throws Exception {
        http
            .csrf().disable()
            .exceptionHandling()
        .and()
            .authorizeRequests()
            .anyRequest().authenticated();
    }
}

server:
  port: 9002
security:
  oauth2:
    client:
      client-id: client
      client-secret: secret
      access-token-uri: http://localhost:9000/auth/oauth/token
      user-authorization-uri: http://localhost:9000/auth/oauth/authorize
    resource:
      token-info-uri: http://localhost:9000/auth/oauth/check_token

　　说明：资源服务器主要用于资源拦截，需要获取授权码才能访问

　　4）sso客户端

　　

　　主要配置：SecurityConfiguration、application.yaml

/**
 * 这里使用的是sso的方式，可以用于单点登录
 * 构造方式也很简单，主要是sso的配置
 */
@Configuration
@EnableOAuth2Sso
public class SecurityConfiguration extends WebSecurityConfigurerAdapter {

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

server:
  port: 9001
security:
  oauth2:
    client:
      client-id: client
      client-secret: secret
      access-token-uri: http://localhost:9000/auth/oauth/token
      user-authorization-uri: http://localhost:9000/auth/oauth/authorize
    resource:
      token-info-uri: http://localhost:9000/auth/oauth/check_token
      #user-info-uri: http://localhost:9002/user/me
      #这里两种获取用户的方式，都可以。但是只能存在一种

　　5）客户端：当然浏览器可以为一种客户端，自己开发的应用也可以为客户端

　　浏览器：

　　a、获取授权码

oauth/authorize?response_type=code&client_id=&redirect_uri=

　　本文中：

http://localhost:9000/auth/oauth/authorize?response_type=code&client_id=client&redirect_uri=http://localhost:9002/login

　　这里我们就获取到了code值

　　b、通过code获取令牌

oauth/token?client_id=&client_secret=&grant_type=authorization_code&redirect_uri=&code=

　　本文中：

http://localhost:9000/auth/oauth/token?client_id=client&client_secret=secret&grant_type=authorization_code&redirect_uri=http://localhost:9002/login&code=jrbBZS

　　获取的对应值

{
    "access_token": "06c1db9b-aac3-4a9a-acaf-56f5a5d0ea21",
    "token_type": "bearer",
    "refresh_token": "046d3fe7-52c4-43e5-902a-673ab2b0d3d4",
    "expires_in": 42981,
    "scope": "All"
}

• access_token：表示访问令牌，必选项。
• token_type：表示令牌类型，该值大小写不敏感，必选项，可以是bearer类型或mac类型。
• expires_in：表示过期时间，单位为秒。如果省略该参数，必须其他方式设置过期时间。
• refresh_token：表示更新令牌，用来获取下一次的访问令牌，可选项。
• scope：表示权限范围，如果与客户端申请的范围一致，此项可省略。

　　c、更新令牌

oauth/token?grant_type=refresh_token&refresh_token=

　　本文：

http://localhost:9000/auth/oauth/token?grant_type=refresh_token&refresh_token=046d3fe7-52c4-43e5-902a-673ab2b0d3d4

　　注意：在使用refresh_token刷新令牌的时候，需要在认证服务器上面设置

　　

　　SecurityConfiguration加入UserDetailsService

    @Bean
    @Override
    protected UserDetailsService userDetailsService() {
        return super.userDetailsService();
    }

　　AuthServerConfiguration也加入UserDetailsService

    @Autowired
    private UserDetailsService userDetailsService;

    @Override
    public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
        //认证体系使用security的方式
        endpoints.authenticationManager(authenticationManager);
        endpoints.allowedTokenEndpointRequestMethods(HttpMethod.GET, HttpMethod.POST);
        endpoints.userDetailsService(userDetailsService);
    }

　　否者报错：

Handling error: IllegalStateException, UserDetailsService is required.

　　

　　d、访问资源

url?access_token=06c1db9b-aac3-4a9a-acaf-56f5a5d0ea21

　　应用：

　　a、默认方式获取code

http://localhost:9000/auth/oauth/authorize?response_type=code&client_id=client&redirect_uri=http://localhost:9003/authorize/login

　　

　　第一步基本上都是通过浏览器进行登录的。

　　b、程序获取令牌

　　　　　　　LinkedMultiValueMap<String, Object> valueMap = new LinkedMultiValueMap<>();
            valueMap.add("client_id", authorizationCodeResourceDetails.getClientId());
            valueMap.add("client_secret", authorizationCodeResourceDetails.getClientSecret());
            valueMap.add("grant_type", authorizationCodeResourceDetails.getGrantType());
            valueMap.add("redirect_uri", authorizationCodeResourceDetails.getPreEstablishedRedirectUri());
            valueMap.add("code", code);
            Map<String, String> map = HttpUtils.doFrom(authorizationCodeResourceDetails.getAccessTokenUri(), valueMap, Map.class);

　　c、单点登录

　　　　　　  //获取用户信息，说明这里主要目的就是通过资源服务器去获取用户信息
            Map principal = HttpUtils.doGet(resourceServerProperties.getUserInfoUri() + "?access_token=" + map.get("access_token"), Map.class);

            //这里通过本地登录单点登录
            String username = principal.get("name").toString();
            //如果用户存在则不添加，这里如果生产应用中，可以更具规则修改
            if (userRepository.findByUsername(username) == null) {
                Role role = roleRepository.findByRoleType(Role.RoleType.USER);
                User newUser = new User();
                newUser.setUsername(username);
                newUser.setPassword(passwordEncoder.encode(username));
                newUser.getRoles().add(role);
                userRepository.save(newUser);
            }

            //这里通过本地登录的方式来获取会话
            HttpHeaders httpHeaders = new HttpHeaders();
            httpHeaders.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
            LinkedMultiValueMap<String, Object> params = new LinkedMultiValueMap<>();
            params.add("username", username);
            params.add("password", username);
            HttpEntity<LinkedMultiValueMap<String, ? extends Object>> httpEntity = new HttpEntity(params, httpHeaders);
            String url = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + "/login";
            ResponseEntity<Object> exchange = restTemplate.exchange(url, HttpMethod.POST, httpEntity, Object.class);
            //将登录后的header原本的给浏览器，这就是当前浏览器的会话
            HttpHeaders headers = exchange.getHeaders();
            for (Map.Entry<String, List<String>> entry : headers.entrySet()) {
                entry.getValue().stream().forEach(value -> response.addHeader(entry.getKey(), value));
            }
            //这个状态是根据security的返回数据设定的
            response.setStatus(exchange.getStatusCode().value());

　　d、登录的实现过程

@RestController
@RequestMapping("/authorize")
public class AuthorizedResource {

    @Autowired
    private AuthorizationCodeResourceDetails authorizationCodeResourceDetails;

    @Autowired
    private ResourceServerProperties resourceServerProperties;

    @Autowired
    private RestTemplate restTemplate;

    @Autowired
    private BCryptPasswordEncoder passwordEncoder;

    @Autowired
    private UserRepository userRepository;

    @Autowired
    private RoleRepository roleRepository;

    @RequestMapping("/login")
    public void login(String code, HttpServletRequest request, HttpServletResponse response) throws Exception {
        if (!StringUtils.isEmpty(code)) {
            LinkedMultiValueMap<String, Object> valueMap = new LinkedMultiValueMap<>();
            valueMap.add("client_id", authorizationCodeResourceDetails.getClientId());
            valueMap.add("client_secret", authorizationCodeResourceDetails.getClientSecret());
            valueMap.add("grant_type", authorizationCodeResourceDetails.getGrantType());
            valueMap.add("redirect_uri", authorizationCodeResourceDetails.getPreEstablishedRedirectUri());
            valueMap.add("code", code);
            Map<String, String> map = HttpUtils.doFrom(authorizationCodeResourceDetails.getAccessTokenUri(), valueMap, Map.class);
            System.out.println(map);

            //获取用户信息，说明这里主要目的就是通过资源服务器去获取用户信息
            Map principal = HttpUtils.doGet(resourceServerProperties.getUserInfoUri() + "?access_token=" + map.get("access_token"), Map.class);

            //这里通过本地登录单点登录
            String username = principal.get("name").toString();
            //如果用户存在则不添加，这里如果生产应用中，可以更具规则修改
            if (userRepository.findByUsername(username) == null) {
                Role role = roleRepository.findByRoleType(Role.RoleType.USER);
                User newUser = new User();
                newUser.setUsername(username);
                newUser.setPassword(passwordEncoder.encode(username));
                newUser.getRoles().add(role);
                userRepository.save(newUser);
            }

            //这里通过本地登录的方式来获取会话
            HttpHeaders httpHeaders = new HttpHeaders();
            httpHeaders.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
            LinkedMultiValueMap<String, Object> params = new LinkedMultiValueMap<>();
            params.add("username", username);
            params.add("password", username);
            HttpEntity<LinkedMultiValueMap<String, ? extends Object>> httpEntity = new HttpEntity(params, httpHeaders);
            String url = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + "/login";
            ResponseEntity<Object> exchange = restTemplate.exchange(url, HttpMethod.POST, httpEntity, Object.class);
            //将登录后的header原本的给浏览器，这就是当前浏览器的会话
            HttpHeaders headers = exchange.getHeaders();
            for (Map.Entry<String, List<String>> entry : headers.entrySet()) {
                entry.getValue().stream().forEach(value -> response.addHeader(entry.getKey(), value));
            }
            //这个状态是根据security的返回数据设定的
            response.setStatus(exchange.getStatusCode().value());
        }
    }
}

　　说明：这里这是简单的应用，实际用户名等可以和密码都可以绑定现有账号，或者深度加密！

　　e、其他没有什么大的配置

　　application.yaml

server:
  port: 9003
  servlet:
    session:
      cookie:
        name: ACCESS_SESSION
security:
  oauth2:
    client:
      client-id: client
      client-secret: secret
      grant-type: authorization_code
      access-token-uri: http://localhost:9000/auth/oauth/token
      user-authorization-uri: http://localhost:9000/auth/oauth/authorize
      pre-established-redirect-uri: http://localhost:9003/authorize/login
    resource:
      user-info-uri: http://localhost:9002/user/me
    sso:
      login-path: /authorize/login
spring:
  datasource:
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/model?useUnicode=true&characterEncoding=utf-8&useSSL=false&allowMultiQueries=true
    username: root
    password:
  jpa:
    hibernate:
      ddl-auto: update
      naming:
        physical-strategy: org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy
        implicit-strategy: org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy
    show-sql: true
    database-platform: org.hibernate.dialect.MySQL5InnoDBDialect
    database: mysql

　　6）sso客户端

　　说明：个人还是很喜欢sso的模式的，简单方便高效

　　八、源码：https://github.com/lilin409546297/security-oauth2-sso

　　九、此博客借鉴阮一峰的理解OAuth 2.0