CAS单点登录学习（二）：客户端配置

1. 下载jar包
   因为cas的源码修改变动很大，所以客户端引入的jar包根据服务端的war包而定。之前搭建的cas服务端用的版本是3.5.2，经过测试，可以使用cas-client-core的3.2.1版本。使用maven添加依赖

    <!-- https://mvnrepository.com/artifact/org.jasig.cas.client/cas-client-core -->
    <dependency>
        <groupId>org.jasig.cas.client</groupId>
        <artifactId>cas-client-core</artifactId>
        <version>3.2.1</version>
    </dependency>

   不用maven的话可以用上面的地址去手动下载jar包。

2. web.xml配置
   引入jar包后，只要在客户端的web.xml里配置相应的过滤器即可。根据添加的过滤器的位置顺序一一介绍：

   2.1 Cas20ProxyReceivingTicketValidationFilter（必需）
     该过滤器负责对ticket的校验工作，这个过滤器要放在第一个位置。casServerUrlPrefix：cas服务器访问地址，serverName：客户端域名和端口。这里也可以配置成ip，但是最好还是配置成域名。
     还有就是cas服务端我取消了https，这里路径注意一下。

      <!-- 该过滤器配置负责对Ticket的校验工作-->
      <filter>
        <filter-name>CAS Validation Filter</filter-name>
        <filter-class>org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>
        <init-param>
          <param-name>casServerUrlPrefix</param-name>
          <param-value>http://www.mycas.com:8088/cas-server-webapp-3.5.2</param-value>
        </init-param>
        <init-param>
          <param-name>serverName</param-name>
          <param-value>http://127.0.0.1:80/</param-value>
        </init-param>
        <init-param>
          <param-name>renew</param-name>
          <param-value>false</param-value>
        </init-param>
        <init-param>
          <param-name>gateway</param-name>
          <param-value>false</param-value>
        </init-param>
        <init-param>
          <param-name>encoding</param-name>
          <param-value>UTF-8</param-value>
        </init-param>
      </filter>
      <filter-mapping>
        <filter-name>CAS Validation Filter</filter-name>
        <url-pattern>/*</url-pattern>
      </filter-mapping>

   2.2 AuthenticationFilter（必需）
     该过滤器负责用户的认证工作，casServerLoginUrl：cas服务端登录地址（注意这里比上面的多了'/login'），serverName：同上

      <!--该过滤器负责用户的认证工作-->
      <filter>
        <filter-name>CASFilter</filter-name>
        <filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>
        <init-param>
          <param-name>casServerLoginUrl</param-name>
          <param-value>http://www.mycas.com:8088/cas-server-webapp-3.5.2/login</param-value>
        </init-param>
        <init-param>
          <param-name>serverName</param-name>
          <param-value>http://127.0.0.1:80/</param-value>
        </init-param>
      </filter>
      <filter-mapping>
        <filter-name>CASFilter</filter-name>
        <url-pattern>/*</url-pattern>
      </filter-mapping>

   2.3 HttpServletRequestWrapperFilter （可选）与 AssertionThreadLocalFilter（可选）

    <!--HttpServletRequestWrapperFilter-->
    <filter>
        <filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
        <filter-class>org.jasig.cas.client.util.HttpServletRequestWrapperFilter</filter-class>
      </filter>
      <filter-mapping>
        <filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
        <url-pattern>/*</url-pattern>
      </filter-mapping>  
   
      <!--AssertionThreadLocalFilter-->
      <filter>
        <filter-name>CAS Assertion Thread Local Filter</filter-name>
        <filter-class>org.jasig.cas.client.util.AssertionThreadLocalFilter</filter-class>
      </filter>
      <filter-mapping>
        <filter-name>CAS Assertion Thread Local Filter</filter-name>
        <url-pattern>/*</url-pattern>
      </filter-mapping>

   这2个过滤器的功能是一样的，所以放到一起来讲，当我们登录成功后，需要获取登录的用户信息（只能获取到用户名），就需要配置上面2个过滤器的其中一个。获取方式如下：
   HttpServletRequestWrapperFilter ：

    HttpServletRequest request2 = (HttpServletRequest) request;
    // 从Cas服务器获取登录账户的用户名（2种方式）
    String username1 = request2.getUserPrincipal().toString();
    String username2 = request2.getRemoteUser();

   AssertionThreadLocalFilter：

    Assertion assertion = AssertionHolder.getAssertion();
    String username3 = assertion.getPrincipal().getName();

3. 到这里客户端的配置就完成了~~