文章目录
- 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 {//令牌存储策略@Beanpublic 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";@ResourceResourceServerTokenServices resourceServerTokenServices;@Beanpublic TokenStore tokenStore() {//放内存return new InMemoryTokenStore();}@Overridepublic void configure(ResourceServerSecurityConfigurer resources) throws Exception {resources.resourceId(RESOURCE_ID) //资源id.tokenStore(tokenStore()) //告诉资源服务token在库里.tokenServices(resourceServerTokenServices).stateless(true);}@Overridepublic 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 {@Beanpublic ResourceServerTokenServices tokenServices() {RemoteTokenServices services = new RemoteTokenServices();services.setCheckTokenEndpointUrl("http://localhost:9009/oauth/check_token");services.setClientId("c1");services.setClientSecret("123");return services;}
}