CAS源码追踪系列二：AuthenticationFilter对于请求的处理

Posted 2021-01-15 xuxiaojian

上一篇我们说了在web项目中了和spring整合之后，如何进行对应Filter的初始化，如果你还没看过，请点击 《CAS源码追踪系列一：Filter的初始化》。 本篇我们来看看在初始化完成以后，cas-client是如何处理请求的。

源码地址：https://github.com/apereo/java-cas-client

如何你还不太清楚sso的原理，你可以看看这篇文章《单点登录原理与简单实现》。
当访问系统受保护的资源时，cas的过滤器AuthenticationFilter会对它进行拦截，发现用户没有登录（系统中没有对应的session信息），就会跳转到统一登录页面。否则调用FilterChain中下一个Filter。

来看AuthenticationFilter的

doFilter(final ServletRequest servletRequest, final ServletResponse servletResponse,final FilterChain filterChain)
if (isRequestUrlExcluded(request)) {
logger.debug("Request is ignored.");
filterChain.doFilter(request, response);
return;
}
判断请求是否是不需要被拦截，是，则进行直接调用FilterChain中下一个Filter，否则向下执行
来看看isRequestUrlExcluded方法

private boolean isRequestUrlExcluded(final HttpServletRequest request) {
/
是否有忽略url匹配类，
在AuthenticationFilter的initInternal(final FilterConfig filterConfig)进行初始化
*/
if (this.ignoreUrlPatternMatcherStrategyClass == null) {
return false;
}

    final StringBuffer urlBuffer = request.getRequestURL();
    if (request.getQueryString() != null) {
        urlBuffer.append("?").append(request.getQueryString());//拼装url
    }
    final String requestUri = urlBuffer.toString();
    /*
    *匹配url是不是不用被拦截，拦截规则需要用户在配置文件配置，
    *在AuthenticationFilter的initInternal(final FilterConfig *filterConfig)加载到ignoreUrlPatternMatcherStrategyClass
    */
    return this.ignoreUrlPatternMatcherStrategyClass.matches(requestUri);
}

final HttpSession session = request.getSession(false);//获取用户session，注意到参数是false，表示session没有的话不新建一个session
final Assertion assertion = session != null ? (Assertion) session.getAttribute(CONST_CAS_ASSERTION) : null;//如果有session，则从CONST_CAS_ASSERTION属性值获取断言
如果session不存在或者session中CONST_CAS_ASSERTION为空则代表用户还未登录，则需要继续向下执行，否则执行下一个Filter。
final String serviceUrl = constructServiceUrl(request, response);//解析请求地址
该方法最终调用

CommonUtils.constructServiceUrl(final HttpServletRequest request, final HttpServletResponse response,
final String service, final String serverNames, final String serviceParameterName,
final String artifactParameterName, final boolean encode);
@param service： 服务地址或者说是你要请求的地址，该方法更乐意你提供这个参数（可在配置文件配置）
@param serverName：服务名，如http://localhost:8080

if (CommonUtils.isNotBlank(service)) {
return encode ? response.encodeURL(service) : service;
}
代码一开始先对server参数进行校验，如何不为空，直接返回。这也就是为什么为什么期望你配置这个参数，逻辑简单啊。 如果不为空，则需要对请求的url进行解析。

final String serverName = findMatchingServerName(request, serverNames);
final URIBuilder originalRequestUrl = new URIBuilder(request.getRequestURL().toString(), encode);
originalRequestUrl.setParameters(request.getQueryString());

    final URIBuilder builder;
    if (!serverName.startsWith("https://") && !serverName.startsWith("http://")) {
        String scheme = request.isSecure() ? "https://" : "http://";
        builder = new URIBuilder(scheme + serverName, encode);
    } else {
        builder = new URIBuilder(serverName, encode);
    }

    if (builder.getPort() == -1 && !requestIsOnStandardPort(request)) {
        builder.setPort(request.getServerPort());
    }

    builder.setEncodedPath(builder.getEncodedPath() + request.getRequestURI());

根据url获取请求参数（request.getQueryString()）时，会判断有没有携带ticket参数且必须在第一个位置（location==0），如果是就直接返回之前拼装的url，否则继续拼装参数 。

final List

final String ticket = retrieveTicketFromRequest(request);//获取请求中的ticket
然后判断如果有ticket而且设置了网关，就直接调用下一个Filter，否则继续向下执行。

final String urlToRedirectTo = CommonUtils.constructRedirectUrl(this.casServerLoginUrl,
getProtocol().getServiceParameterName(), modifiedServiceUrl, this.renew, this.gateway);
根据已有的数据构造一个重定向url，也就是对于请求认证失败的时候跳转的地址，类似于https://localhost:8443/cas/login?service=https%3A%2F%2Flocalhost%3A8443%2Ftest%3Ftest%3D12456%26sss%3D111。“？”前面部分为认证中心登录页面，后面则为登录成功之后要跳转的地址。

最后一步就是执行重定向。

总结

这一片我们简单分析了cas-client如何处理请求，对于认证成功的继续执行下一个Filter，失败的则跳转到登录页面。下一篇我们会讲cas-server端是如何处理登录的。

平时的学习过程记录一下，没有那么高深，希望能帮到大家，与君共同进步。我是敲代码的小鲁班，喜欢的话给个推荐，点赞，关注吧。