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. 到這里客戶端的配置就完成了~~