OAuth2

ゞ浴缸里的玫瑰 2024-03-26 14:18 69阅读 0赞

## 1.什么是**OAuth2** ##

OAUTH协议为用户资源的授权提供了一个安全的、开放而又简易的标准。同时，任何第三方都可以使用OAUTH认证服务，任何服务提供商都可以实现自身的OAUTH认证服务，因而OAUTH是开放的。业界提供了OAUTH的多种实现如PHP、JavaScript，Java，Ruby等各种语言开发包，大大节约了程序员的时间，因而OAUTH是简易的。互联网很多服务如Open API，很多大公司如Google，Yahoo，Microsoft等都提供了OAUTH认证服务，这些都足以说明OAUTH标准逐渐成为开放资源授权的标准。

## 2.例子分析 ##

下边分析一个Oauth2认证的例子（授权码模式），黑马程序员网站使用微信认证扫码登录的过程：

![c19e049f8a524160ab525eac739573c6.png][]

1、用户点击微信扫码

用户进入黑马程序的登录页面，点击微信的图标开打微信扫码界面。

![171a026580f442dca15ab474fc4689f3.png][]

微信扫码的目的是通过微信认证登录黑马程序员官网，黑马程序员网站需要从微信获取当前用户的身份信息才会让当前用户在黑马网站登录成功。

资源：用户信息，在微信中存储。

资源拥有者：用户是用户信息资源的拥有者。

认证服务：微信负责认证当前用户的身份，负责为客户端颁发令牌。

客户端：客户端会携带令牌请求微信获取用户信息，黑马程序员网站即客户端，黑马网站需要在浏览器打开。

2、用户授权黑马网站访问用户信息

资源拥有者扫描二维码表示资源拥有者请求微信进行认证，微信认证通过向用户手机返回授权页面，如下图：

![36b47b23135f40d48863469116751d51.png][]

询问用户是否授权黑马程序员访问自己在微信的用户信息，用户点击“确认登录”表示同意授权，微信认证服务器会颁发一个授权码给黑马程序员的网站。

只有资源拥有者同意微信才允许黑马网站访问资源。

3、黑马程序员的网站获取到授权码

4、携带授权码请求微信认证服务器申请令牌

此交互过程用户看不到。

5、微信认证服务器向黑马程序员的网站响应令牌

此交互过程用户看不到。

6、黑马程序员网站请求微信资源服务器获取资源即用户信息。

黑马程序员网站携带令牌请求访问微信服务器获取用户的基本信息。

7、资源服务器返回受保护资源即用户信息

8、黑马网站接收到用户信息，此时用户在黑马网站登录成功。

## 3.oauth2.0认证流程 ##

![1b9e34a952734485986a255c3c16101f.png][]

Oauth2包括以下角色：

1、客户端

本身不存储资源，需要通过资源拥有者的授权去请求资源服务器的资源，比如：手机客户端、浏览器等。

上边示例中黑马网站即为客户端，它需要通过浏览器打开。

2、资源拥有者

通常为用户，也可以是应用程序，即该资源的拥有者。

A表示 客户端请求资源拥有者授权。

B表示 资源拥有者授权客户端即黑马网站访问自己的用户信息。

3、授权服务器（也称认证服务器）

认证服务器对资源拥有者进行认证，还会对客户端进行认证并颁发令牌。

C 客户端即黑马网站携带授权码请求认证。

D认证通过颁发令牌。

4、资源服务器

存储资源的服务器。

E表示客户端即黑马网站携带令牌请求资源服务器获取资源。

F表示资源服务器校验令牌通过后提供受保护资源。

## 4.oauth2授权模式 ##

Spring Security支持OAuth2认证，OAuth2提供授权码模式、密码模式、简化模式、客户端模式等四种授权模式，

### **4.1授权码模式** ###

OAuth2的几个授权模式是根据不同的应用场景以不同的方式去获取令牌，最终目的是要获取认证服务颁发的令牌，最终通过令牌去获取资源。

授权码模式简单理解是使用授权码去获取令牌，要想获取令牌先要获取授权码，授权码的获取需要资源拥有者亲自授权同意才可以获取。

下图是授权码模式交互图

![5ce35fde3c8b450d833da6ba73ac2b37.png][]

1、用户打开浏览器。

2、通过浏览器访问客户端即黑马网站。

3、用户通过浏览器向认证服务请求授权，请求授权时会携带客户端的URL，此URL为下发授权码的重定向地址。

4、认证服务向资源拥有者返回授权页面。

5、资源拥有者亲自授权同意。

6、通过浏览器向认证服务发送授权同意。

7、认证服务向客户端地址重定向并携带授权码。

8、客户端即黑马网站收到授权码。

9、客户端携带授权码向认证服务申请令牌。

10、认证服务向客户端颁发令牌。

package com.xuecheng.auth.config;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.http.HttpMethod;
    import org.springframework.security.authentication.AuthenticationManager;
    import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
    import org.springframework.security.oauth2.config.annotation.configurers.ClientDetailsServiceConfigurer;
    import org.springframework.security.oauth2.config.annotation.web.configuration.AuthorizationServerConfigurerAdapter;
    import org.springframework.security.oauth2.config.annotation.web.configuration.EnableAuthorizationServer;
    import org.springframework.security.oauth2.config.annotation.web.configurers.AuthorizationServerEndpointsConfigurer;
    import org.springframework.security.oauth2.config.annotation.web.configurers.AuthorizationServerSecurityConfigurer;
    import org.springframework.security.oauth2.provider.token.AuthorizationServerTokenServices;
    
    import javax.annotation.Resource;
    
    /**
     * @description 授权服务器配置
     * @author Mr.M
     * @date 2022/9/26 22:25
     * @version 1.0
     */
     @Configuration
     @EnableAuthorizationServer
     public class AuthorizationServer extends AuthorizationServerConfigurerAdapter {
    
      @Resource(name="authorizationServerTokenServicesCustom")
      private AuthorizationServerTokenServices authorizationServerTokenServices;
    
     @Autowired
     private AuthenticationManager authenticationManager;
    
      //客户端详情服务
      @Override
      public void configure(ClientDetailsServiceConfigurer clients)
              throws Exception {
            clients.inMemory()// 使用in-memory存储
                    .withClient("XcWebApp")// client_id
                    .secret("XcWebApp")//客户端密钥
    //                .secret(new BCryptPasswordEncoder().encode("XcWebApp"))//客户端密钥
                    .resourceIds("xuecheng-plus")//资源列表
                    .authorizedGrantTypes("authorization_code", "password","client_credentials","implicit","refresh_token")// 该client允许的授权类型authorization_code,password,refresh_token,implicit,client_credentials
                    .scopes("all")// 允许的授权范围
                    .autoApprove(false)//false跳转到授权页面
                    //客户端接收授权码的重定向地址
                    .redirectUris("http://www.xuecheng-plus.com")
       ;
      }
    
    
      //令牌端点的访问配置
      @Override
      public void configure(AuthorizationServerEndpointsConfigurer endpoints) {
       endpoints
               .authenticationManager(authenticationManager)//认证管理器
               .tokenServices(authorizationServerTokenServices)//令牌管理服务
               .allowedTokenEndpointRequestMethods(HttpMethod.POST);
      }
    
      //令牌端点的安全配置
      @Override
      public void configure(AuthorizationServerSecurityConfigurer security){
       security
               .tokenKeyAccess("permitAll()")                    //oauth/token_key是公开
               .checkTokenAccess("permitAll()")                  //oauth/check_token公开
               .allowFormAuthenticationForClients()				//表单认证（申请令牌）
       ;
      }
    
     }

package com.xuecheng.auth.config;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.security.oauth2.provider.token.AuthorizationServerTokenServices;
    import org.springframework.security.oauth2.provider.token.DefaultTokenServices;
    import org.springframework.security.oauth2.provider.token.TokenEnhancerChain;
    import org.springframework.security.oauth2.provider.token.TokenStore;
    import org.springframework.security.oauth2.provider.token.store.InMemoryTokenStore;
    import org.springframework.security.oauth2.provider.token.store.JwtAccessTokenConverter;
    import org.springframework.security.oauth2.provider.token.store.JwtTokenStore;
    
    import java.util.Arrays;
    
    /**
     * @author Administrator
     * @version 1.0
     **/
    @Configuration
    public class TokenConfig {
    
        @Autowired
        TokenStore tokenStore;
    
        @Bean
        public TokenStore tokenStore() {
            //使用内存存储令牌（普通令牌）
            return new InMemoryTokenStore();
        }
    
        @Bean(name="authorizationServerTokenServicesCustom")
        public AuthorizationServerTokenServices tokenService() {
            DefaultTokenServices service=new DefaultTokenServices();
            service.setSupportRefreshToken(true);//支持刷新令牌
            service.setTokenStore(tokenStore);//令牌存储策略
            service.setAccessTokenValiditySeconds(7200); // 令牌默认有效期2小时
            service.setRefreshTokenValiditySeconds(259200); // 刷新令牌默认有效期3天
            return service;
        }
    
    
    
    }

**1****）****ClientDetailsServiceConfigurer**：用来配置客户端详情服务（ClientDetailsService），

随便一个客户端都可以随便接入到它的认证服务吗？答案是否定的，服务提供商会给批准接入的客户端一个身份，用于接入时的凭据，有客户端标识和客户端秘钥，在这里配置批准接入的客户端的详细信息。

**2****）****AuthorizationServerEndpointsConfigurer**：用来配置令牌（token）的访问端点和令牌服务(token services)。

**3****）****AuthorizationServerSecurityConfigurer**：用来配置令牌端点的安全约束.

**2****、****TokenConfig****为令牌策略配置类**

#### 测试 ####

重启认证服务

1、get请求获取授权码

地址: /oauth/authorize?client\_id=XcWebApp&response\_type=code&scope=all&redirect\_uri=http://www.xuecheng-plus.com

参数列表如下：

*  client\_id：客户端准入标识。

*  response\_type：授权码模式固定为code。

*  scope：客户端权限。

*  redirect\_uri：跳转uri，当授权码申请成功后会跳转到此地址，并在后边带上code参数（授权码）。

输入账号zhangsan、密码123登录成功，输入/oauth/authorize?client\_id=XcWebApp&response\_type=code&scope=all&redirect\_uri=http://www.xuecheng-plus.com

显示授权页面![90b1735b33424d599acf48bdd18db271.png][]

授权“XcWebApp”访问自己的受保护资源?

选择同意。

2、请求成功，重定向至http://www.xuecheng-plus.com/?code=授权码，比如：http://www.xuecheng-plus.com/?code=Wqjb5H

3、使用httpclient工具post申请令牌

/oauth/token?client\_id=XcWebApp&client\_secret=XcWebApp&grant\_type=authorization\_code&code=授权码&redirect\_uri=http://www.xuecheng-plus.com/

参数列表如下

*  client\_id：客户端准入标识。

*  client\_secret：客户端秘钥。

*  grant\_type：授权类型，填写authorization\_code，表示授权码模式

*  code：授权码，就是刚刚获取的授权码，注意：授权码只使用一次就无效了，需要重新申请。

*  redirect\_uri：申请授权码时的跳转url，一定和申请授权码时用的redirect\_uri一致。

使用postman访问：（code部分要换成浏览器本次提供的授权码）

授权码的有效期只有一次！

localhost:63070/auth/oauth/token?client_id=XcWebApp&client_secret=XcWebApp&grant_type=authorization_code&code=4M16wW&redirect_uri=http://www.xuecheng-plus.com

![de90ba75c1f446bbb3822036ac9455cb.png][]

1、access\_token，访问令牌，用于访问资源使用。

2、token\_type，bearer是在RFC6750中定义的一种token类型，在携带令牌访问资源时需要在head中加入bearer 空格 令牌内容

3、refresh\_token，当令牌快过期时使用刷新令牌可以再次生成令牌。

4、expires\_in：过期时间（秒）

5、scope，令牌的权限范围，服务端可以根据令牌的权限范围去对令牌授权。

### 4.2**密码模式** ###

一般用于同一个公司内部的应用之间，密码模式相对授权码模式简单，授权码模式需要借助浏览器供用户亲自授权，密码模式不用借助浏览器，如下图：

![038aba30b4b34cbda046d32e0013dd5c.png][]

1、资源拥有者提供账号和密码

2、客户端向认证服务申请令牌，请求中携带账号和密码

3、认证服务校验账号和密码正确颁发令牌。

#### 测试 ####

localhost:63070/auth/oauth/token?client_id=XcWebApp&client_secret=XcWebApp&grant_type=password&username=zhangsan&password=123

![baeb6d640c7d4ec8a30d8d1fd10eca60.png][]

[c19e049f8a524160ab525eac739573c6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/ddf3844c1c9f45ba8bb4b17abd256479.png
[171a026580f442dca15ab474fc4689f3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/8af8ff577de5488ca167693559b0b412.png
[36b47b23135f40d48863469116751d51.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/6431658401fd42a99e73b951b5a94fd2.png
[1b9e34a952734485986a255c3c16101f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/6769bd8962a44197915560d76e532aaf.png
[5ce35fde3c8b450d833da6ba73ac2b37.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/aa3981972c1b4ed1b78e237e5d9bc192.png
[90b1735b33424d599acf48bdd18db271.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/ca3a12e5357645a086a9d2dd3d8bae87.png
[de90ba75c1f446bbb3822036ac9455cb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/29253285f3b64978b1893d139f546913.png
[038aba30b4b34cbda046d32e0013dd5c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/4c705a8f22c84769a66036936cc7febc.png
[baeb6d640c7d4ec8a30d8d1fd10eca60.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/236aba1af0d34c5f804b37bf4ff40ccc.png