OAuth2 Token 一定要放在请求头中吗？

Token 一定要放在请求头中吗？ 答案肯定是否定的，本文将从源码的角度来分享一下 spring security oauth2 的解析过程，及其扩展点的应用场景。

Token 解析过程说明

当我们使用 spring security oauth2 时, 一般情况下需要把认证中心申请的 token 放在请求头中请求目标接口，如下图 ①

spring security oauth2 通过拦截器获取此 token 完成令牌到当前用户信息（UserDetails）的转换。

• OAuth2AuthenticationProcessingFilter.doFilter

  public class OAuth2AuthenticationProcessingFilter{ public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { try { // 1. 根据用户请求解析令牌，组装预登陆对象 Authentication authentication = tokenExtractor.extract(request); if (authentication == null) { // 若是预登陆状态为空，把无状态登录清空 if (stateless && isAuthenticated()) { SecurityContextHolder.clearContext(); } } else { // 2. 根据token 来做真正的认证登录 Provier Authentication authResult = authenticationManager.authenticate(authentication);

  1			// 3. 登录成功逻辑
  2			eventPublisher.publishAuthenticationSuccess(authResult);
  3			SecurityContextHolder.getContext().setAuthentication(authResult);
  4		}
  5	}
  6	catch (OAuth2Exception failed) {
  7        // 异常通知逻辑  Spring Event
  8		...
  9		return;
  10	}
  11	chain.doFilter(request, response);
  12}
  

  }

我们主要来关注第一步 根据用户请求解析令牌，组装预登陆对象

来看默认实现 BearerTokenExtractor

1public class BearerTokenExtractor implements TokenExtractor {
2	@Override
3	public Authentication extract(HttpServletRequest request) {
4		// 1. 解析token
5		String tokenValue = extractToken(request);
6		if (tokenValue != null) {
7			// 2. 创建一个authentication 返回
8			PreAuthenticatedAuthenticationToken authentication = new PreAuthenticatedAuthenticationToken(tokenValue, "");
9			return authentication;
10		}
11		return null;
12	}
13
14	protected String extractToken(HttpServletRequest request) {
15		// 1.1 优先从请求header 获取token
16		String token = extractHeaderToken(request);
17		// 1.2 若是请求token 中没有，则获取请求参数中的 access_token 参数
18		if (token == null) {
19			token = request.getParameter(OAuth2AccessToken.ACCESS_TOKEN);
20		}
21		return token;
22	}
23}

扩展点

• 1. 丰富获取 token 渠道，个性化处理.例如掘金的 X-Legacy-Token 而非必须是 Authorization

• 2. 请求参数中携带 access_token 参数也能被正确解析处理

• 3. 重写 BearerTokenExtractor 解决，若请求携带 token 无论接口是否被设置 permitAll 都会被拦截判断的问题

以上源码参考： 基于 Spring Boot 2.3.0、 Spring Cloud Hoxton & Alibaba、 OAuth2 的 RBAC 权限管理系统 PigBearerTokenExtractor 部分扩展

项目推荐: Spring Cloud 、Spring Security OAuth2的RBAC权限管理系统 欢迎关注