【SpringSecurity】十六、OAuth2.0授权服务器、资源服务器的配置（理论部分）

文章目录

0、OAuth2服务端结构
1、授权服务配置
2、授权服务器 ⇒ 配置客户端详情
3、授权服务器 ⇒ 管理令牌配置
4、授权服务器：配置端点访问的安全约束
5、资源服务器配置

相关📕：【OAuth2授权服务器配置完整Demo】

0、OAuth2服务端结构

OAuth2服务的提供端，包括两部分：

授权服务：负责校验接入的客户端、登录的用户账户是否合法，以及颁发token
资源服务：校验token，返回资源信息

在这里插入图片描述
比如创建两个服务，uua服务用来做授权服务，order服务用来做资源服务。

1、授权服务配置

Spring Security Oauth核心依赖：

<dependency>
    <groupId>org.springframework.security.oauth</groupId>
    <artifactId>spring-security-oauth2</artifactId>
    <version>2.4.1</version>
</dependency>

用 @EnableAuthorizationServer 注解并继承AuthorizationServerConfigurerAdapter来配置OAuth2.0 授权服务器。

或者直接去实现AuthorizationServerConfigurer接口都一样

@Configuration
@EnableAuthorizationServer
public class AuthorizationServer extends AuthorizationServerConfigurerAdapter {
	//略...
}

在这里插入图片描述

授权服务器中，需要配置以下三点：

ClientDetailsServiceConfigurer：用来配置客户端详情服务，看支持哪些客户端来请求
AuthorizationServerEndpointsConfigurer：解决两点：客户端来申请令牌了，申请的地址是什么（令牌端点）以及令牌怎么发放
AuthorizationServerSecurityConfigurer：配置令牌端点的安全约束，哪些url开放，哪些需要鉴权

2、授权服务器 ⇒ 配置客户端详情

通过ClientDetailsServiceConfigurer来配置客户端详情。而一个ClientDetails对象则是表示一个客户端的详情，包括客户端的ID、密码、授权范围、授权类型等。相关属性：

clientId：客户端ID
secret：客户端密钥
scope：限制客户端的访问范围
authorizedGrantTypes：授权类型
authorities：客户端可以使用的权限

配置客户端详情可以通过内存和数据库的方式：

方式一：

客户端详情ClientDetails的查询要通过ClientDetailsService，可以直接用框架的JdbcClientDetailsService。也可自己实现ClientDetailsService接口和ClientRegistrationService接口的类，用于加载和增删改客户端详情信息。然后如下设置客户端详情服务

@Override
public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
	clients.withClientDetails(clientDetailsService)
	//...

JdbcClientDetailsService相关源码：

在这里插入图片描述

方式二：

在内存中配置客户端详情服务，硬编码或者使用配置文件+@Value读取实现写活。如下：

/**
 * Oauth2.0客户端角色的信息来源：内存、数据库
 * 这里用内存做测试
 */
@Override
public void configure(ClientDetailsServiceConfigurer clientDetailsServiceConfigurer) throws Exception {
    clientDetailsServiceConfigurer.inMemory() //使用内存
            .withClient("c1")  //client_id
            .secret(new BCryptPasswordEncoder().encode("123321"))   //客户端密钥
            .resourceIds("res1","res2")  //资源列表，一个标识，后面配置资源服务会用到
            .authorizedGrantTypes("authorization_code",
                    "password", "client_credentials", "implicit", "refresh_token")  //支持的授权模式，这里即四种都支持
            .scopes("all")  //允许授权的范围，一个标识
            .autoApprove(false)  //不自动授权，即跳转到授权页面，让用户授权
            .redirectUris("http://your_url");  //验证回调地址，授权码通过302重定向方法，这里要验证回调地址是否被恶意篡改
    //后面继续链式调用and方法可以配置第二个客户端的信息

}

通过以上配置，Spring Security将会在内存中或者数据库中加载客户端详情，并在认证和授权过程中使用这些信息来验证和授权客户端的请求。

3、授权服务器 ⇒ 管理令牌配置

AuthorizationServerTokenServices接口定义了令牌操作方法：

在这里插入图片描述

其实现类是DefaultTokenServices：

在这里插入图片描述

该实现类聚合了TokenStore接口，做持久化令牌（令牌存储策略）。其实现类：

在这里插入图片描述

InMemoryTokenStore：令牌存内存中
JdbcTokenStore：令牌写进数据库
JwtTokenStore：JWT令牌，服务端自行解析

以下演示内存中的，先定义TokenStore：

@Configuration
public class TokenConfig {

	//令牌存储策略
	@Bean
	public TokenStore tokenStore() {
		//放内存
		return new InMemoryTokenStore();
	}
}

定义AuthorizationServerTokenServices，使用其实现类DefaultTokenServices，这里设置token的相关配置：

//注入上面定义的令牌存储策略的Bean
@Autowired
private TokenStore tokenStore;

//注入客户端详情服务（定义下这个Bean，是实现方式：JDBC、内存、自己实现这个接口）
@Autowired
private ClientDetailsService clientDetailsService;


//token令牌管理
@Bean
public AuthorizationServerTokenServices tokenServices() {
    DefaultTokenServices tokenServices = new DefaultTokenServices();
    tokenServices.setClientDetailsService(clientDetailsService);   //客户端信息服务，即向哪个客户端颁发令牌
    tokenServices.setSupportRefreshToken(true);  //支持产生刷新令牌
    tokenServices.setTokenStore(tokenStore);   //令牌的存储策略
    tokenServices.setAccessTokenValiditySeconds(7200);    //令牌默认有效期2小时
    tokenServices.setRefreshTokenValiditySeconds(259200);  //refresh_token默认有效期三天
    return tokenServices;
}

定义好这令牌存储和令牌配置的两个Bean，下面重写第二个configure方法：

@Override
public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
    //你的逻辑
}

这个方法AuthorizationServerEndpointsConfigurer类型的形参，可以配置授权服务器支持的授权类型：

authenticationManager：配置认证管理器，以支持密码模式
userDetailsService：配置这个说明有自己的UserDetailsService接口实现，此后refresh_token获取新令牌，框架会去检查当前账户是否有效（如是否被禁用）
authorizationCodeServices：配置授权码服务，以支持授权码模式
implicitGrantService：隐式授权模式需要
tokenGranter：配置这个，说明要自定义授权逻辑

示例：

/**
 * 授权信息保存策略
 */
@Bean
public ApprovalStore approvalStore(){
    return new InMemoryApprovalStore();
}

//AuthenticationManager对象在Oauth2认证服务中要使用，提取放到IOC容器中，实现WebSecurityConfigurerAdapter的安全配置类中配置
@Override
@Bean
public AuthenticationManager authenticationManagerBean() throws Exception {
    return super.authenticationManagerBean();
}

//设置授权码模式下，授权码如何存储
@Bean(name = "jdbcAuthorizationCodeServices")
public AuthorizationCodeServices authorizationCodeServices(){
    return new InMemoryAuthorizationCodeServices();
}

/**
 * 令牌端点访问和令牌服务（令牌怎么生成、怎么存储等）
 */
@Override
public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
    endpoints.authenticationManager(authenticationManager)  //设置认证管理器，密码模式需要
            .authorizationCodeServices(authorizationCodeServices)  //授权码模式需要
            .approvalStore(approvalStore)
            .tokenServices(tokenServices())  //token管理服务
            .allowedTokenEndpointRequestMethods(HttpMethod.POST);  //允许Post方式访问
}

最后，配置授权端点的URL，框架默认URL为：

/oauth/authorize：授权端点

/oauth/token：令牌端点

/oauth/confirm_access：用户确认授权提交端点

/oauth/error：授权服务错误信息端点

/oauth/check_token：用于资源服务访问的令牌解析端点

/oauth/token_key：提供公有密匙的端点，如果你使用JWT令牌的话

AuthorizationServerEndpointsConfigurer的pathMapping方法可以把这些默认的URL替换成自己定义的URL，形参1为默认链接，形参2为新的自定义的URL链接

4、授权服务器：配置端点访问的安全约束

在这里配置框架提供的端点（url），哪些是可以对外公开的，比如下面即check/token接口对外公开

/**
 * token令牌端点访问的安全策略
 * （不是所有人都可以来访问框架提供的这些令牌端点的）
 */
@Override
public void configure(AuthorizationServerSecurityConfigurer authorizationServerSecurityConfigurer) throws Exception {
    authorizationServerSecurityConfigurer.tokenKeyAccess("permitAll()")   //oauth/token_key这个端点（url）是公开的，不用登录可调
            .checkTokenAccess("permitAll()")   // oauth/check_token这个端点是公开的
            .allowFormAuthenticationForClients();  //允许客户端表单认证，申请令牌
}

5、资源服务器配置

Spring Security Oauth核心依赖：

<dependency>
    <groupId>org.springframework.security.oauth</groupId>
    <artifactId>spring-security-oauth2</artifactId>
    <version>2.4.1</version>
</dependency>

在资源服务做token校验，合法且权限匹配，则返回数据资源。配置方式：

用 @EnableResourceServer注解并继承 ResourceServerConfigurerAdapter（或实现ResourceServerConfigurer）来配置OAuth2.0 授权服务器。

@Configuration
@EnableResourceServer
@EnableGlobalMethodSecurity(securedEnabled = true)
public class OAuthSourceConfig extends ResourceServerConfigurerAdapter {

    public static final String RESOURCE_ID = "res1";

    @Resource
    ResourceServerTokenServices resourceServerTokenServices;

    @Bean
	public TokenStore tokenStore() {
		//放内存
		return new InMemoryTokenStore();
	}


    @Override
    public void configure(ResourceServerSecurityConfigurer resources) throws Exception {
        resources.resourceId(RESOURCE_ID)   //资源id
                .tokenStore(tokenStore())   //告诉资源服务token在库里
                .tokenServices(resourceServerTokenServices)
                .stateless(true);
    }

    @Override
    public void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
                //这就是给客户端发token时的scope，这里会校验scope标识
                .antMatchers("/**").access("#oauth2.hasAnyScope('all')")
                .and()
                .csrf().disable()
                .sessionManagement()
                .sessionCreationPolicy(SessionCreationPolicy.STATELESS);
    }
}

通过ResourceServerSecurityConfigurer对象配置：

resourceId：资源ID，对应授权服务器里的资源ID标识
tokenServices：ResourceServerTokenServices 类的实例
tokenStore：指定令牌在哪儿，如何访问

关于ResourceServerTokenServices，其用来验证token。如何授权服务和资源服务在一个应用上，可用DefaultTokenServices，使用/oauth/check_token这个端点去校验令牌。反之需要使用远程token服务RemoteTokenServices，指定授权服务器校验token的地址。以及自己的密钥和客户端ID：

@Configuration
public class BeanConfig {

    @Bean
    public ResourceServerTokenServices tokenServices() {
        RemoteTokenServices services = new RemoteTokenServices();
        services.setCheckTokenEndpointUrl("http://localhost:9009/oauth/check_token");
        services.setClientId("c1");
        services.setClientSecret("123");
        return services;
    }
}