CAS实现单点登录方案（SSO完整版）

一、简介

                1、cas是由耶鲁大学研发的单点登录服务器

                 2、本教材所用环境

• Tomcat7.2
• JDK1.7
• CAS Service 版本    cas-server-3.4.8-release
• CAS Client版本      cas-client-3.2.1-release                                

二、生成证书

    证书对于实现此单点登录非常之重要，证书是服务器端和客户端安全通信的凭证，本教程只是演示，所以用了JDK自带的证书生成工具keytool。当然在实际项目中你可以到专门的证书认证中心购买证书。

中文官方网站：http://www.verisign.com/cn/

1、用JDK自带的keytool生成证书

keytool -genkey -alias  smalllove -keyalg RSA -keystore D:/keys/smallkey

此命令是生成一个证书，其中 smalllove 是证书别名

此命令的执行如图所示：

其中名字与姓氏这一最好写你的 域名，如果在单击测试你可以在C:\Windows\System32\drivers\etc\hosts文件中映射一个虚拟域名， 注意不要写IP。

2、导出证书

C:\>keytool -export -file d:/keys/small.crt -alias smalllove -keystore d:/keys/smallkey

如图：

密码为上步设置的密码。

3、把证书导入到客户端JDK中

假设你的jdk安装在C:\jdk1.5这个目录， 开始 >> 运行 >> 输入cmd 进入dos命令行 >> 再用cd进入到C:\jdk1.5\jre\lib\security这个目录下

敲入如下命令回车执行:

keytool -import -alias smalllove -keystore smalllove -file D:/keys/small.crt -trustcacerts

此时命令行会提示你输入cacerts证书库的密码，你敲入changeit就行了，这是java中cacerts证书库的默认密码，你自已也可以修改的。 ok,大功告成！ 

到此证书导入成功。

三、配置服务端

1、 下载CAS的服务端，解压，把解压后的文件中modules文件夹中的cas-server-webapp-3.4.8.war文件拷贝到%TOMCAT_HOME%\webapps下，并修改文件名为：cas.war。

源码下载地址：https://github.com/Jasig/cas/releases

CSDN全部下载地址:http://download.csdn.net/detail/zhu_r_d/5487373#comment

百度网盘下载:http://pan.baidu.com/s/1hrswn1U

2、修改%TOMCAT_HOME%\conf\server.xml文件,去掉此文件83到93行之间的注释，修改为：

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
               maxThreads="150" scheme="https" secure="true"
               clientAuth="false" sslProtocol="TLS" 
               keystoreFile="D:/keys/smallkey"  <!--在2.1中生成的证书的位置-->
               keystorePass="smalllove"/>       <!--在2.1中设置的密码-->

3、以上配置完成访问https://yourhost:8443/cas出现一下页面

点击继续浏览会出现

输入用户名admin和密码admin登录则会出现

登录成功。至此，说明服务端配置成功。

  四、配置客户端

1、添加客户端到你的项目中

手动下载下载cas-client，地址：http://downloads.jasig.org/cas-clients/，然后解压cas-client-3.1.12.zip，在modules文件夹中有需要的jar包，                         请根据自己的项目情况选择使用，把相应的jar包放到你项目WEB-INF/lib下。

使用maven

 

<!-- cas -->
<dependency>
    <groupId>org.jasig.cas.client</groupId>
    <artifactId>cas-client-core</artifactId>
    <version>3.1.12</version>
</dependency>

2、在客户端项目的web.xml配置过滤器

<!-- ======================== 单点登录开始 ======================== -->
    <!-- 用于单点退出，该过滤器用于实现单点登出功能，可选配置 -->
    <listener>
        <listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class>
    </listener>

    <!-- 该过滤器用于实现单点登出功能，可选配置。 -->
    <filter>
        <filter-name>CAS Single Sign Out Filter</filter-name>
        <filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>CAS Single Sign Out Filter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- 该过滤器负责用户的认证工作，必须启用它 -->
    <filter>
        <filter-name>CASFilter</filter-name>
        <filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>
        <init-param>
            <!-- CAS服务器端登录地址 -->
            <param-name>casServerLoginUrl</param-name>
            <param-value>https://uic.sinopec.com:443/cas/login</param-value>
            <!--这里的server是服务端的IP -->
        </init-param>
        <init-param>
            <!-- 客户端应用URL -->
            <param-name>serverName</param-name>
            <param-value>http://client.sinopec.com:8080</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>CASFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- 该过滤器负责对Ticket的校验工作，必须启用它 -->
    <filter>
        <filter-name>CAS Validation Filter</filter-name>
        <filter-class>
            org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>
        <init-param>
            <!-- CAS服务器端URL -->
            <param-name>casServerUrlPrefix</param-name>
            <param-value>https://uic.sinopec.com:443/cas</param-value>
        </init-param>
        <init-param>
            <!-- 客户端应用URL -->
            <param-name>serverName</param-name>
            <param-value>http://client.sinopec.com:8080</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>CAS Validation Filter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- 该过滤器负责实现HttpServletRequest请求的包裹， 比如允许开发者通过HttpServletRequest的getRemoteUser()方法获得SSO登录用户的登录名，可选配置。 -->
    <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>

    <!-- 该过滤器使得开发者可以通过org.jasig.cas.client.util.AssertionHolder来获取用户的登录名。 比如AssertionHolder.getAssertion().getPrincipal().getName()。 -->
    <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>

    <!-- ======================== 单点登录结束 ======================== -->

五、常见问题说明

错误一、

若出现以上错原因是：你在客户端的web.xml中①，②的配置有误。

错误二、

javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: 
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: 
unable to find valid certification path to requested target

 若出现次错误是有与你客户端的证书有问题。重新导入你证书。

 在代码里面忽略证书问题的解决方案请参考我的博文:

http://www.cnblogs.com/longshiyVip/p/5067489.html