---
title: "CAS实现单点登录（SSO）经典完整教程(转)"
author: "javaEEdevelop"
date: "2012-11-29T14:30:04Z"
tags: []
categories: ["开源软件"]
slug: "cas-sso"
draft: false
lastmod: "2012-11-29T16:41:57Z"
id: 1738259
url: "https://javaeedevelop.iteye.com/blog/1738259"
---

原址(http://blog.csdn.net/small\_love/article/details/6664831)

 

 

cas下载地址http://downloads.jasig.org/cas/

cas-server-3.1-release.zip

http://downloads.jasig.org/cas-clients/

cas-client-3.1-release.zip

 

## 一、简介

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

                 2、本教材所用环境

 

- Tomcat7.2
- JDK6
- CAS Service 版本   cas-server-3.1-release.zip
- CAS Client版本      cas-client-3.1-release.zip

 

## []()    二、生成证书

                            证书对于实现此单点登录非常之重要，证书是服务器端和客户端安全通信的凭证，本教程只是演示，所有用了

                    JDK自带的证书生成工具keytool。当然在实际项目中你可以到专门的证书认证中心购买证书。

                            中文官方网站：[http://www.verisign.com/cn/](http://www.verisign.com/cn/)

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

 

**\[plain]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

1. 命令：keytool -genkey -alias  smalllove -keyalg RSA -keystore D:/keys/smallkey

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

 

     此命令的执行如图所示：

                    ![](http://hi.csdn.net/attachment/201108/6/0_1312600844rK4z.gif)

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

              注意不要写IP。

           2、导出证书

                

**\[plain]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

1. 命令：C:\\&gt;keytool -export -file d:/keys/small.crt -alias smalllove -keystore d:/keys/smallkey

                如图：

 

                      ![](http://hi.csdn.net/attachment/201108/6/0_1312601748wuzb.gif)

               密码为上步设置的密码。

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

                

**\[plain]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

1. 命令：keytool -import -keystore C:\\Java\\jdk1.6.0\_21\\lib\\security\\cacerts -file D:/keys/small.crt -alias smalllove

           此命令是把证书导入到JDK中。

 

           如图：

            ![](http://hi.csdn.net/attachment/201108/6/0_13126022079IlR.gif)

          到此证书导入成功。

           注意：在此步有可能出现如下错误

     

**\[plain]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

1. C:\\&gt;keytool -import -keystore C:\\Java\\jdk1.6.0\_21\\lib\\security\\cacerts -file D:/keys/small.crt -alias smalllove
2. 输入keystore密码：
3. keytool错误： java.io.IOException: Keystore was tampered with, or password was incorrect

                     次错误的解决方法是，把%JAVA\_HOME%\\lib\\security下的cacerts文件删除掉，在执行。

 

                 

## []()    三、配置服务端

                      1、 下载CAS的服务端，解压，把解压后的文件中modules文件夹中的cas-server-webapp-3.4.8.war文件拷贝的%TOMCAT\_HOME%\\webapps

               下，并修改文件名为：cas.war。

                      2、修改%TOMCAT\_HOME%\\conf\\server.xml文件

                               去掉此文件83到93行之间的注释，修改为：

 

**\[html]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

1. &lt;Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
2. maxThreads="150" scheme="https" secure="true"
3. clientAuth="false" sslProtocol="TLS"
4. keystoreFile="D:/keys/smallkey"  &lt;!--在2.1中生成的证书的位置--&gt;
5. keystorePass="smalllove"/&gt;       &lt;!--在2.1中设置的密码--&gt;

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

 

                                   ![](http://hi.csdn.net/attachment/201108/6/0_1312603278ye5m.gif)

                          点击继续浏览会出现

                                         ![](http://hi.csdn.net/attachment/201108/6/0_1312603386RBdr.gif)

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

                                      ![](http://hi.csdn.net/attachment/201108/6/0_13126034475hyh.gif)

                         登录成功。

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

## []()   四、配置客户端

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

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

                   ·使用maven

                              

**\[html]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

1. &lt;!-- cas --&gt;
2. &lt;dependency&gt;
3. &lt;groupId&gt;org.jasig.cas.client&lt;/groupId&gt;
4. &lt;artifactId&gt;cas-client-core&lt;/artifactId&gt;
5. &lt;version&gt;3.1.12&lt;/version&gt;
6. &lt;/dependency&gt;

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

 

**\[html]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

01. &lt;!-- ======================== 单点登录开始 ======================== --&gt;
02. &lt;!-- 用于单点退出，该过滤器用于实现单点登出功能，可选配置 --&gt;
03. &lt;listener&gt;
04. &lt;listener-class&gt;org.jasig.cas.client.session.SingleSignOutHttpSessionListener&lt;/listener-class&gt;
05. &lt;/listener&gt;
06. &lt;!-- 该过滤器用于实现单点登出功能，可选配置。 --&gt;
07. &lt;filter&gt;
08. &lt;filter-name&gt;CAS Single Sign Out Filter&lt;/filter-name&gt;
09. &lt;filter-class&gt;org.jasig.cas.client.session.SingleSignOutFilter&lt;/filter-class&gt;
10. &lt;/filter&gt;
11. &lt;filter-mapping&gt;
12. &lt;filter-name&gt;CAS Single Sign Out Filter&lt;/filter-name&gt;
13. &lt;url-pattern&gt;/\*&lt;/url-pattern&gt;
14. &lt;/filter-mapping&gt;
15. &lt;!-- 该过滤器负责用户的认证工作，必须启用它 --&gt;
16. &lt;filter&gt;
17. &lt;filter-name&gt;CASFilter&lt;/filter-name&gt;
18. &lt;filter-class&gt;org.jasig.cas.client.authentication.AuthenticationFilter&lt;/filter-class&gt;
19. &lt;init-param&gt;
20. &lt;param-name&gt;casServerLoginUrl&lt;/param-name&gt;
21. &lt;param-value&gt;https://www.travel.com:8443/cas/login&lt;/param-value&gt;
22. &lt;!--这里的server是服务端的IP --&gt;
23. &lt;/init-param&gt;
24. &lt;init-param&gt;
25. &lt;param-name&gt;serverName&lt;/param-name&gt;
26. &lt;param-value&gt;http://www.travel.com:8080&lt;/param-value&gt;&lt;span style="color:#FF0000;"&gt; ①&lt;/span&gt;
27. &lt;/init-param&gt;
28. &lt;/filter&gt;
29. &lt;filter-mapping&gt;
30. &lt;filter-name&gt;CASFilter&lt;/filter-name&gt;
31. &lt;url-pattern&gt;/\*&lt;/url-pattern&gt;
32. &lt;/filter-mapping&gt;
33. &lt;!-- 该过滤器负责对Ticket的校验工作，必须启用它 --&gt;
34. &lt;filter&gt;
35. &lt;filter-name&gt;CAS Validation Filter&lt;/filter-name&gt;
36. &lt;filter-class&gt;
37. org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter&lt;/filter-class&gt;
38. &lt;init-param&gt;
39. &lt;param-name&gt;casServerUrlPrefix&lt;/param-name&gt;
40. &lt;param-value&gt;https://www.travel.com:8443/cas&lt;/param-value&gt;
41. &lt;/init-param&gt;
42. &lt;init-param&gt;
43. &lt;param-name&gt;serverName&lt;/param-name&gt;
44. &lt;param-value&gt;http://www.travel.com:8080&lt;/param-value&gt;  &lt;span style="color:#FF0000;"&gt;②&lt;/span&gt;
45. &lt;/init-param&gt;
46. &lt;/filter&gt;
47. &lt;filter-mapping&gt;
48. &lt;filter-name&gt;CAS Validation Filter&lt;/filter-name&gt;
49. &lt;url-pattern&gt;/\*&lt;/url-pattern&gt;
50. &lt;/filter-mapping&gt;
51. &lt;!-- 该过滤器负责实现HttpServletRequest请求的包裹， 比如允许开发者通过HttpServletRequest的getRemoteUser()方法获得SSO登录用户的登录名，可选配置。 --&gt;
52. &lt;filter&gt;
53. &lt;filter-name&gt;CAS HttpServletRequest Wrapper Filter&lt;/filter-name&gt;
54. &lt;filter-class&gt;
55. org.jasig.cas.client.util.HttpServletRequestWrapperFilter&lt;/filter-class&gt;
56. &lt;/filter&gt;
57. &lt;filter-mapping&gt;
58. &lt;filter-name&gt;CAS HttpServletRequest Wrapper Filter&lt;/filter-name&gt;
59. &lt;url-pattern&gt;/\*&lt;/url-pattern&gt;
60. &lt;/filter-mapping&gt;
61. &lt;!-- 该过滤器使得开发者可以通过org.jasig.cas.client.util.AssertionHolder来获取用户的登录名。 比如AssertionHolder.getAssertion().getPrincipal().getName()。 --&gt;
62. &lt;filter&gt;
63. &lt;filter-name&gt;CAS Assertion Thread Local Filter&lt;/filter-name&gt;
64. &lt;filter-class&gt;org.jasig.cas.client.util.AssertionThreadLocalFilter&lt;/filter-class&gt;
65. &lt;/filter&gt;
66. &lt;filter-mapping&gt;
67. &lt;filter-name&gt;CAS Assertion Thread Local Filter&lt;/filter-name&gt;
68. &lt;url-pattern&gt;/\*&lt;/url-pattern&gt;
69. &lt;/filter-mapping&gt;
70. &lt;!-- ======================== 单点登录结束 ======================== --&gt;

             

 

 

## []()   五、常见问题说明

                  错误一、

                           ![](http://hi.csdn.net/attachment/201108/6/0_1312609552q7Uf.gif)

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

             错误二、

 

**\[plain]** [view plain](http://blog.csdn.net/small_love/article/details/6664831 "view plain")[copy](http://blog.csdn.net/small_love/article/details/6664831 "copy")

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

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