【积累】一个基于yelu大学CSA认证服务的SSO例子（服务器为tomcat）

此文参考了网上文章，并对其中做了补充。
    参考原文地址一：http://blogger.org.cn/dispbbs.asp?BoardID=41&id=26447&replyID=19949&star=1&skin=0
    参考原文地址二：http://www.diybl.com/course/3_program/java/javashl/2008414/110181.html

    Yale CAS (Central Authentication Service，中央认证服务)是耶鲁大学的一个开源项目。它为耶鲁大学的网络应用提供了一种标准的用户认证服务，从而实现了SSO的功能。
    Yale CAS被设计成为一个独立的网络应用程序，它使用JavaS ervlet技术实现，可以作为用户身份认证模块加入到网络应用中。

    2004 年 12 月正式成为 JA-SIG 的一个项目。CAS 具有以下特点：

    开源的企业级单点登录解决方案。 
    CAS Server 为需要独立部署的 Web 应用。 
    CAS Client 支持非常多的客户端(这里指单点登录系统中的各个 Web 应用)，包括 Java, .Net, PHP, Perl, Apache, uPortal, Ruby 等。
    CAS 原理和协议

    从结构上看，CAS 包含两个部分： CAS Server 和 CAS Client。CAS Server 需要独立部署，主要负责对用户的认证工作；CAS Client 负责处理对客户端受保护资源的访问请求，需要登录时，重定向到 CAS Server。图1 是 CAS 最基本的协议过程：

图 1. CAS 基础协议
 

    CAS Client 与受保护的客户端应用部署在一起，以 Filter 方式保护受保护的资源。对于访问受保护资源的每个 Web 请求，CAS Client 会分析该请求的 Http 请求中是否包含 Service Ticket，如果没有，则说明当前用户尚未登录，于是将请求重定向到指定好的 CAS Server 登录地址，并传递 Service （也就是要访问的目的资源地址），以便登录成功过后转回该地址。用户在第 3 步中输入认证信息，如果登录成功，CAS Server 随机产生一个相当长度、唯一、不可伪造的 Service Ticket，并缓存以待将来验证，之后系统自动重定向到 Service 所在地址，并为客户端浏览器设置一个 Ticket Granted Cookie（TGC），CAS Client 在拿到 Service 和新产生的 Ticket 过后，在第 5，6 步中与 CAS Server 进行身份合适，以确保 Service Ticket 的合法性。

    在该协议中，所有与 CAS 的交互均采用 SSL 协议，确保，ST 和 TGC 的安全性。协议工作过程中会有 2 次重定向的过程，但是 CAS Client 与 CAS Server 之间进行 Ticket 验证的过程对于用户是透明的。

    另外，CAS 协议中还提供了 Proxy （代理）模式，以适应更加高级、复杂的应用场景，具体介绍可以参考 CAS 官方网站上的相关文档。
    下面就来说说该如何配置我们的第一个CAS服务器
     首先需要到官网上下载CAS Server 和 Client，地址分别为：

    http://www.ja-sig.org/downloads/cas/cas-server-3.1.1-release.zip

    http://www.ja-sig.org/downloads/cas-clients/cas-client-java-2.1.1.zip

   1、打开tomcat中的SSL协议
    修改Tomcat配置文件server.xml，去掉对于SSL的注释，即开放8443端口，注意这里需要在connector字段中加入keystorePass="password"参数，password即为上面几步中涉及到的密码，代码如下：
   

1    <!-- Define a SSL HTTP/1.1 Connector on port 8443 -->
2    <!-- -->
3    <Connector port="8443" maxHttpHeaderSize="8192"
4               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
5               enableLookups="false" disableUploadTimeout="true"
6               acceptCount="100" scheme="https" secure="true"
7               clientAuth="false" sslProtocol="TLS" keystorePass="changeit" />

    2、生成安全证书
    如果你的JDK环境是自动安装的话，你需要在系统中加入JAVA_HOME这个环境变量
    然后在DOS环境下（开始-》运行-》cmd-》回车后出现DOS窗口）一次敲入如下的命令
    %java_home%\bin\keytool -genkey -alias tomcat -keyalg RSA
    PS：敲入这个命令后，会提示你输入密码，初始的默认密码为changeit。在证书生成的时候，需要你回答一些问题，其它的你可以随便写，但是姓名这个问题必须填入localhost。
    %java_home%\bin\keytool -export -alias tomcat -file server.crt
    %java_home%\bin\keytool -import -file server.crt -keystore %java_home%/jre/lib/security/cacerts
   

    3、将CAS server3.0.2中target目录中的CAS.war复制到%tomcat_home%\webapps目录下.
    4、将cas-client-java-2.1.1\dist\casclient.jar文件复制到%tomcat_home%\common\lib中
    5、修改tomcat自带的servlet-examples的web.xml, 加入cas的过滤器:

 1<filter> 
 2    <filter-name>CASFilter</filter-name>
 3    <filter-class>edu.yale.its.tp.cas.client.filter.CASFilter</filter-class>
 4    <init-param>
 5        <param-name>edu.yale.its.tp.cas.client.filter.loginUrl</param-name>
 6        <param-value>https://localhost:8443/cas/login</param-value>
 7    </init-param>
 8    <init-param>
 9        <param-name>edu.yale.its.tp.cas.client.filter.validateUrl</param-name>
10        <param-value>https://localhost:8443/cas/proxyValidate</param-value>
11    </init-param>
12    <init-param>
13        <param-name>edu.yale.its.tp.cas.client.filter.serverName</param-name>
14        <param-value>localhost:8080</param-value>
15    </init-param>
16</filter>
17
18<filter-mapping>
19    <filter-name>CASFilter</filter-name>
20    <url-pattern>/servlet/*</url-pattern>
21</filter-mapping>
22<filter-mapping>
23<filter-name>CASFilter</filter-name>
24<url-pattern>/*</url-pattern>
25</filter-mapping>
26

    6、启动tomcat !,CAS.war文件被自动在webapps下释放出CAS目录

    最后，如果配置成功，进入https://localhost:8443/servlets-examples, 被自动转发到CAS的登陆页面，在这个页面上随便填入相同的用户名和密码，进入到了被转发的页面。

    PS：证书的删除命令如下

    %java_home%\bin\keytool -delete -alias tomcat -keyalg RSA

    %java_home%\bin\keytool -delete -keystore %java_home%/jre/lib/security/cacerts