本文目录:
- 一、概述
- 二、演示环境
- 三、JDK安装配置
- 四、安全证书配置
- 五、部署CAS-Server相关的Tomcat
- 六、部署CAS-Client相关的Tomcat
- 七、 测试验证SSO
一、概述
此文的目的就是为了帮助初步接触SSO和CAS 的人员提供一个入门指南,一步一步演示如何实现基于CAS的单点登录。
CAS的官网:http://www.jasig.org/cas
二、演示环境
本文演示过程在同一个机器上的(也可以在三台实体机器或者三个的虚拟机上),环境如下:
- windows7 64位,主机名称:michael-pc
- JDK 1.6.0_18
- Tomcat 6.0.29
- CAS-server-3.4.11、CAS-client-3.2.1
根据演示需求,
用修改hosts 文件的方法添加域名最简单方便(这个非常重要),在文件 C:\Windows\System32\drivers\etc\hosts 文件中添加三条
127.0.0.1 demo.micmiu.com
127.0.0.1 app1.micmiu.com
127.0.0.1 app2.micmiu.com
- demo.micmiu.com =>> 对应部署cas server的tomcat,这个虚拟域名还用于证书生成
- app1.micmiu.com =>> 对应部署app1 的tomcat
- app2.micmiu.com =>> 对应部署app2 的tomcat
三、JDK安装配置
这个详细过程就不在描述,如果是免安装版的,确保环境变量配置正确。
本机环境变量:JAVA_HOME=D:\jdk,如果看到以下信息则表示安装成功:
四、安全证书配置
有关keytool工具的详细运用见:http://www.micmiu.com/lang/java/keytool-start-guide/
4.1. 生成证书:
ps:
- 截图中需要输入的姓名和上面hosts文件中配置的一致;
- keypass 和 storepass 两个密码要一致,否则下面tomcat 配置https 访问失败;
4.2.导出证书:
1 | keytool - export - alias ssodemo -keystore g:\sso\ssodemo.keystore - file g:\sso\ssodemo.crt -storepass michaelpwd |
4.3.客户端导入证书:
1 | keytool - import -keystore %JAVA_HOME%\jre\lib\security\cacerts - file g:\sso\ssodemo.crt - alias ssodemo |
ps:该命令中输入的密码和上面输入的不是同一个密码;如果是多台机器演示,需要在每一台客户端导入该证书。
五、部署CAS-Server相关的Tomcat
5.1. 配置HTTPS
解压apache-tomcat-6.0.29.tar.gz并重命名后的路径为 G:\sso\tomcat-cas,在文件 conf/server.xml文件找到:
修改成如下:
1 | <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" |
2 | maxThreads="150" scheme="https" secure="true" |
3 | keystoreFile="g:/sso/ssodemo.keystore" keystorePass="michaelpwd" |
4 | clientAuth="false" sslProtocol="TLS" URIEncoding="UTF-8" |
参数说明:
- keystoreFile 就是4.1中创建证书的路径
- keystorePass 就是4.1中创建证书的密码
5.2. 验证HTTPS配置
其他按照默认配置不作修改,双击%TOMCAT_HOME%\bin\startup.bat 启动tomcat-cas 验证https访问配置:
如果看到上述界面表示https 访问配置成功。
5.3 部署CAS-Server
CAS-Server 下载地址:http://www.jasig.org/cas/download
本文以cas-server-3.4.11-release.zip 为例,解压提取cas-server-3.4.11/modules/cas-server-webapp-3.4.11.war文件,把改文件copy到 G:\sso\tomcat-cas\webapps\ 目下,并重命名为:cas.war.
启动tomcat-cas,在浏览器地址栏输入:https://demo.micmiu.com:8443/cas/login ,回车
CAS-server的默认验证规则:只要用户名和密码相同就认证通过(仅仅用于测试,生成环境需要根据实际情况修改),输入admin/admin 点击登录,就可以看到登录成功的页面:
看到上述页面表示CAS-Server已经部署成功。
六、部署CAS-Client相关的Tomcat
6.1Cas-Client 下载
CAS-Client 下载地址:http://downloads.jasig.org/cas-clients/
以cas-client-3.2.1-release.zip 为例,解压提取cas-client-3.2.1/modules/cas-client-core-3.2.1.jar
借以tomcat默认自带的 webapps\examples 作为演示的简单web项目
6.2 安装配置 tomcat-app1
解压apache-tomcat-6.0.29.tar.gz并重命名后的路径为 G:\sso\tomcat-app1,修改tomcat的启动端口,在文件 conf/server.xml文件找到如下内容:
1 | < Connector port = "8080" protocol = "HTTP/1.1" |
2 | connectionTimeout = "20000" |
4 | < Connector port = "8009" protocol = "AJP/1.3" redirectPort = "8443" /> |
修改成如下:
1 | < Connector port = "18080" protocol = "HTTP/1.1" |
2 | connectionTimeout = "20000" |
3 | redirectPort = "18443" /> |
4 | < Connector port = "18009" protocol = "AJP/1.3" redirectPort = "18443" /> |
启动tomcat-app1,浏览器输入 http://app1.micmiu.com:18080/examples/servlets/ 回车:
看到上述界面表示tomcat-app1的基本安装配置已经成功。
接下来复制 client的lib包cas-client-core-3.2.1.jar到 tomcat-app1\webapps\examples\WEB-INF\lib\目录下, 在tomcat-app1\webapps\examples\WEB-INF\web.xml 文件中增加如下内容:
4 | < listener-class >org.jasig.cas.client.session.SingleSignOutHttpSessionListener</ listener-class > |
9 | < filter-name >CAS Single Sign Out Filter</ filter-name > |
10 | < filter-class >org.jasig.cas.client.session.SingleSignOutFilter</ filter-class > |
13 | < filter-name >CAS Single Sign Out Filter</ filter-name > |
14 | < url-pattern >/*</ url-pattern > |
18 | < filter-name >CAS Filter</ filter-name > |
19 | < filter-class >org.jasig.cas.client.authentication.AuthenticationFilter</ filter-class > |
21 | < param-name >casServerLoginUrl</ param-name > |
25 | < param-name >serverName</ param-name > |
30 | < filter-name >CAS Filter</ filter-name > |
31 | < url-pattern >/*</ url-pattern > |
35 | < filter-name >CAS Validation Filter</ filter-name > |
37 | org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</ filter-class > |
39 | < param-name >casServerUrlPrefix</ param-name > |
43 | < param-name >serverName</ param-name > |
48 | < filter-name >CAS Validation Filter</ filter-name > |
49 | < url-pattern >/*</ url-pattern > |
57 | < filter-name >CAS HttpServletRequest Wrapper Filter</ filter-name > |
59 | org.jasig.cas.client.util.HttpServletRequestWrapperFilter</ filter-class > |
62 | < filter-name >CAS HttpServletRequest Wrapper Filter</ filter-name > |
63 | < url-pattern >/*</ url-pattern > |
71 | < filter-name >CAS Assertion Thread Local Filter</ filter-name > |
72 | < filter-class >org.jasig.cas.client.util.AssertionThreadLocalFilter</ filter-class > |
75 | < filter-name >CAS Assertion Thread Local Filter</ filter-name > |
76 | < url-pattern >/*</ url-pattern > |
有关cas-client的web.xml修改的详细说明见官网介绍:
https://wiki.jasig.org/display/CASC/Configuring+the+Jasig+CAS+Client+for+Java+in+the+web.xml
6.3 安装配置 tomcat-app2
解压apache-tomcat-6.0.29.tar.gz并重命名后的路径为 G:\sso\tomcat-app2,修改tomcat的启动端口,在文件 conf/server.xml文件找到如下内容:
1 | < Connector port = "8080" protocol = "HTTP/1.1" |
2 | connectionTimeout = "20000" |
4 | < Connector port = "8009" protocol = "AJP/1.3" redirectPort = "8443" /> |
修改成如下:
1 | < Connector port = "28080" protocol = "HTTP/1.1" |
2 | connectionTimeout = "20000" |
3 | redirectPort = "28443" /> |
4 | < Connector port = "28009" protocol = "AJP/1.3" redirectPort = "28443" /> |
启动tomcat-app2,浏览器输入 http://app2.micmiu.com:28080/examples/servlets/ 回车,按照上述6.2中的方法验证是否成功。
同6.2中的复制 client的lib包cas-client-core-3.2.1.jar到 tomcat-app2\webapps\examples\WEB-INF\lib\目录下, 在tomcat-app2\webapps\examples\WEB-INF\web.xml 文件中增加如下内容:
4 | < listener-class >org.jasig.cas.client.session.SingleSignOutHttpSessionListener</ listener-class > |
9 | < filter-name >CAS Single Sign Out Filter</ filter-name > |
10 | < filter-class >org.jasig.cas.client.session.SingleSignOutFilter</ filter-class > |
13 | < filter-name >CAS Single Sign Out Filter</ filter-name > |
14 | < url-pattern >/*</ url-pattern > |
18 | < filter-name >CAS Filter</ filter-name > |
19 | < filter-class >org.jasig.cas.client.authentication.AuthenticationFilter</ filter-class > |
21 | < param-name >casServerLoginUrl</ param-name > |
25 | < param-name >serverName</ param-name > |
30 | < filter-name >CAS Filter</ filter-name > |
31 | < url-pattern >/*</ url-pattern > |
35 | < filter-name >CAS Validation Filter</ filter-name > |
37 | org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</ filter-class > |
39 | < param-name >casServerUrlPrefix</ param-name > |
43 | < param-name >serverName</ param-name > |
48 | < filter-name >CAS Validation Filter</ filter-name > |
49 | < url-pattern >/*</ url-pattern > |
57 | < filter-name >CAS HttpServletRequest Wrapper Filter</ filter-name > |
59 | org.jasig.cas.client.util.HttpServletRequestWrapperFilter</ filter-class > |
62 | < filter-name >CAS HttpServletRequest Wrapper Filter</ filter-name > |
63 | < url-pattern >/*</ url-pattern > |
71 | < filter-name >CAS Assertion Thread Local Filter</ filter-name > |
72 | < filter-class >org.jasig.cas.client.util.AssertionThreadLocalFilter</ filter-class > |
75 | < filter-name >CAS Assertion Thread Local Filter</ filter-name > |
76 | < url-pattern >/*</ url-pattern > |
七、 测试验证SSO
启动之前配置好的三个tomcat分别为:tomcat-cas、tomcat-app1、tomcat-app2.
7.1 基本的测试
预期流程: 打开app1 url —-> 跳转cas server 验证 —-> 显示app1的应用 —-> 打开app2 url —-> 显示app2 应用 —-> 注销cas server —-> 打开app1/app2 url —-> 重新跳转到cas server 验证.
打开浏览器地址栏中输入:http://app1.micmiu.com:18080/examples/servlets/servlet/HelloWorldExample,回车:
跳转到验证页面:
验证通过后显示如下:
此时访问app2就不再需要验证:
地址栏中输入:https://demo.micmiu.com:8443/cas/logout,回车显示:
上述表示 认证注销成功,此时如果再访问 : http://app1.micmiu.com:18080/examples/servlets/servlet/HelloWorldExample 或 http://app2.micmiu.com:28080/examples/servlets/servlet/HelloWorldExample 需要重新进行认证。
7.2 获取登录用户的信息
修改类:webapps\examples\WEB-INF\classes\HelloWorldExample.java 后重新编译并替换 webapps\examples\WEB-INF\classes\HelloWorldExample.class文件。
HelloWorldExample.java 修改后的代码如下:
3 | import java.util.Map.Entry; |
6 | import javax.servlet.http.*; |
8 | import org.jasig.cas.client.authentication.AttributePrincipal; |
9 | import org.jasig.cas.client.util.AbstractCasFilter; |
10 | import org.jasig.cas.client.validation.Assertion; |
18 | public class HelloWorldExample extends HttpServlet { |
20 | private static final long serialVersionUID = -6593274907821061823L; |
22 | @SuppressWarnings ( "unchecked" ) |
23 | public void doGet(HttpServletRequest request, HttpServletResponse response) |
24 | throws IOException, ServletException { |
25 | ResourceBundle rb = ResourceBundle.getBundle( "LocalStrings" , |
27 | response.setContentType( "text/html" ); |
28 | PrintWriter out = response.getWriter(); |
30 | out.println( "<html>" ); |
31 | out.println( "<head>" ); |
33 | String title = rb.getString( "helloworld.title" ); |
35 | out.println( "<title>" + title + "</title>" ); |
36 | out.println( "</head>" ); |
37 | out.println( "<body bgcolor=\"white\">" ); |
39 | out.println( "<a href=\"../helloworld.html\">" ); |
40 | out.println( "<img src=\"../images/code.gif\" height=24 " |
41 | + "width=24 align=right border=0 alt=\"view code\"></a>" ); |
42 | out.println( "<a href=\"../index.html\">" ); |
43 | out.println( "<img src=\"../images/return.gif\" height=24 " |
44 | + "width=24 align=right border=0 alt=\"return\"></a>" ); |
45 | out.println( "<h1>" + title + "</h1>" ); |
47 | Assertion assertion = (Assertion) request.getSession().getAttribute( |
48 | AbstractCasFilter.CONST_CAS_ASSERTION); |
50 | if ( null != assertion) { |
51 | out.println( " Log | ValidFromDate =:" |
52 | + assertion.getValidFromDate() + "<br>" ); |
53 | out.println( " Log | ValidUntilDate =:" |
54 | + assertion.getValidUntilDate() + "<br>" ); |
55 | Map<Object, Object> attMap = assertion.getAttributes(); |
56 | out.println( " Log | getAttributes Map size = " + attMap.size() |
58 | for (Entry<Object, Object> entry : attMap.entrySet()) { |
59 | out.println( " | " + entry.getKey() + "=:" |
60 | + entry.getValue() + "<br>" ); |
62 | AttributePrincipal principal = assertion.getPrincipal(); |
67 | String username = null ; |
68 | out.print( " Log | UserName:" ); |
69 | if ( null != principal) { |
70 | username = principal.getName(); |
71 | out.println( "<span style='color:red;'>" + username |
77 | out.println( "</body>" ); |
78 | out.println( "</html>" ); |
再进行上述测试显示结果如下:
http://app1.micmiu.com:18080/examples/servlets/servlet/HelloWorldExample :
http://app2.micmiu.com:28080/examples/servlets/servlet/HelloWorldExample