本文目录:html
1、概述java
此文的目的就是为了帮助初步接触SSO和CAS 的人员提供一个入门指南,一步一步演示如何实现基于CAS的单点登陆。web
CAS的官网:http://www.jasig.org/casapache
2、演示环境windows
本文演示过程在同一个机器上的(也能够在三台实体机器或者三个的虚拟机上),环境以下:浏览器
127.0.0.1 demo.micmiu.com 127.0.0.1 app1.micmiu.com 127.0.0.1 app2.micmiu.com
3、JDK安装配置tomcat
这个详细过程就不在描述,若是是免安装版的,确保环境变量配置正确。安全
本机环境变量:JAVA_HOME=D:\jdk,若是看到如下信息则表示安装成功:session
4、安全证书配置app
有关keytool工具的详细运用见:http://www.micmiu.com/lang/java/keytool-start-guide/
4.1. 生成证书:
1 |
keytool -genkey - alias ssodemo -keyalg RSA -keysize 1024 -keypass michaelpwd -validity 365 -keystore g:\sso\ssodemo.keystore -storepass michaelpwd |
ps:
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:该命令中输入的密码和上面输入的不是同一个密码;若是是多台机器演示,须要在每一台客户端导入该证书。
5、部署CAS-Server相关的Tomcat
5.1. 配置HTTPS
解压apache-tomcat-6.0.29.tar.gz并重命名后的路径为 G:\sso\tomcat-cas,在文件 conf/server.xml文件找到:
1 |
<!-- |
2 |
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" |
3 |
maxThreads="150" scheme="https" secure="true" |
4 |
clientAuth="false" sslProtocol="TLS" /> |
5 |
--> |
修改为以下:
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" |
参数说明:
5.2. 验证HTTPS配置
其余按照默认配置不做修改,双击%TOMCAT_HOME%\bin\startup.bat 启动tomcat-cas 验证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已经部署成功。
6、部署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" |
3 |
redirectPort = "8443" /> |
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 文件中增长以下内容:
<!--======================== 单点登陆开始 ======================== --> <!--用于单点退出,该过滤器用于实现单点登出功能,可选配置--> <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>CAS Filter</filter-name> <filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class> <init-param> <param-name>casServerLoginUrl</param-name> <param-value>https://demo.<span style="font-size: 13px; line-height: 19.5px; white-space: pre-wrap; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">micmiu</span><span style="white-space: pre-wrap; line-height: 1.8em; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">.com:8443/cas/login</param-value></span> </init-param> <init-param> <param-name>serverName</param-name> <param-value>http://app1.<span style="font-size: 13px; line-height: 19.5px; white-space: pre-wrap; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">micmiu</span><span style="white-space: pre-wrap; line-height: 1.8em; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">.com:18080</param-value></span> </init-param> </filter> <filter-mapping> <filter-name>CAS Filter</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> <param-name>casServerUrlPrefix</param-name> <param-value>https://demo.<span style="font-size: 13px; line-height: 19.5px; white-space: pre-wrap; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">micmiu</span><span style="white-space: pre-wrap; line-height: 1.8em; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">.com:8443/cas</param-value></span> </init-param> <init-param> <param-name>serverName</param-name> <param-value>http://app1.<span style="font-size: 13px; line-height: 19.5px; white-space: pre-wrap; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">micmiu</span><span style="white-space: pre-wrap; line-height: 1.8em; font-family: Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;">.com:18080</param-value></span> </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> <!--======================== 单点登陆结束 ======================== -->
启动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 文件中增长以下内容:
1 |
<!-- ======================== 单点登陆开始 ======================== --> |
2 |
<!-- 用于单点退出,该过滤器用于实现单点登出功能,可选配置--> |
3 |
< listener > |
4 |
< listener-class >org.jasig.cas.client.session.SingleSignOutHttpSessionListener</ listener-class > |
5 |
</ listener > |
6 |
7 |
<!-- 该过滤器用于实现单点登出功能,可选配置。 --> |
8 |
< filter > |
9 |
< filter-name >CAS Single Sign Out Filter</ filter-name > |
10 |
< filter-class >org.jasig.cas.client.session.SingleSignOutFilter</ filter-class > |
11 |
</ filter > |
12 |
< filter-mapping > |
13 |
< filter-name >CAS Single Sign Out Filter</ filter-name > |
14 |
< url-pattern >/*</ url-pattern > |
15 |
</ filter-mapping > |
16 |
17 |
< filter > |
18 |
< filter-name >CAS Filter</ filter-name > |
19 |
< filter-class >org.jasig.cas.client.authentication.AuthenticationFilter</ filter-class > |
20 |
< init-param > |
21 |
< param-name >casServerLoginUrl</ param-name > |
22 |
< param-value >https://demo.micmiu.com:8443/cas/login</ param-value > |
23 |
</ init-param > |
24 |
< init-param > |
25 |
< param-name >serverName</ param-name > |
26 |
< param-value >http://app2.micmiu.com:28080</ param-value > |
27 |
</ init-param > |
28 |
</ filter > |
29 |
< filter-mapping > |
30 |
< filter-name >CAS Filter</ filter-name > |
31 |
< url-pattern >/*</ url-pattern > |
32 |
</ filter-mapping > |
33 |
<!-- 该过滤器负责对Ticket的校验工做,必须启用它 --> |
34 |
< filter > |
35 |
< filter-name >CAS Validation Filter</ filter-name > |
36 |
< filter-class > |
37 |
org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</ filter-class > |
38 |
< init-param > |
39 |
< param-name >casServerUrlPrefix</ param-name > |
40 |
< param-value >https://demo.micmiu.com:8443/cas</ param-value > |
41 |
</ init-param > |
42 |
< init-param > |
43 |
< param-name >serverName</ param-name > |
44 |
< param-value >http://app2.micmiu.com:28080</ param-value > |
45 |
</ init-param > |
46 |
</ filter > |
47 |
< filter-mapping > |
48 |
< filter-name >CAS Validation Filter</ filter-name > |
49 |
< url-pattern >/*</ url-pattern > |
50 |
</ filter-mapping > |
51 |
52 |
<!-- |
53 |
该过滤器负责实现HttpServletRequest请求的包裹, |
54 |
好比容许开发者经过HttpServletRequest的getRemoteUser()方法得到SSO登陆用户的登陆名,可选配置。 |
55 |
--> |
56 |
< filter > |
57 |
< filter-name >CAS HttpServletRequest Wrapper Filter</ filter-name > |
58 |
< filter-class > |
59 |
org.jasig.cas.client.util.HttpServletRequestWrapperFilter</ filter-class > |
60 |
</ filter > |
61 |
< filter-mapping > |
62 |
< filter-name >CAS HttpServletRequest Wrapper Filter</ filter-name > |
63 |
< url-pattern >/*</ url-pattern > |
64 |
</ filter-mapping > |
65 |
66 |
<!-- |
67 |
该过滤器使得开发者能够经过org.jasig.cas.client.util.AssertionHolder来获取用户的登陆名。 |
68 |
好比AssertionHolder.getAssertion().getPrincipal().getName()。 |
69 |
--> |
70 |
< filter > |
71 |
< filter-name >CAS Assertion Thread Local Filter</ filter-name > |
72 |
< filter-class >org.jasig.cas.client.util.AssertionThreadLocalFilter</ filter-class > |
73 |
</ filter > |
74 |
< filter-mapping > |
75 |
< filter-name >CAS Assertion Thread Local Filter</ filter-name > |
76 |
< url-pattern >/*</ url-pattern > |
77 |
</ filter-mapping > |
78 |
79 |
<!-- ======================== 单点登陆结束 ======================== --> |
7、 测试验证SSO
启动以前配置好的三个tomcat分别为:tomcat-cas、tomcat-app一、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,回车:
地址栏中输入: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 获取登陆用户的信息
修改HelloWorldExample.java,从新编译替换webapps\examples\WEB-INF\classes\HelloWorldExample.class文件,修改后的HelloWorldExample.java代码以下:
1 |
import java.io.*; |
2 |
import java.util.*; |
3 |
import java.util.Map.Entry; |
4 |
5 |
import javax.servlet.*; |
6 |
import javax.servlet.http.*; |
7 |
8 |
import org.jasig.cas.client.authentication.AttributePrincipal; |
9 |
import org.jasig.cas.client.util.AbstractCasFilter; |
10 |
import org.jasig.cas.client.validation.Assertion; |
11 |
12 |
/** |
13 |
* The simplest possible servlet. |
14 |
* |
15 |
* @author James Duncan Davidson |
16 |
*/ |
17 |
18 |
public class HelloWorldExample extends HttpServlet { |
19 |
20 |
public void doGet(HttpServletRequest request, HttpServletResponse response) |
21 |
throws IOException, ServletException { |
22 |
ResourceBundle rb = ResourceBundle.getBundle( "LocalStrings" , request |
23 |
.getLocale()); |
24 |
response.setContentType( "text/html" ); |
25 |
PrintWriter out = response.getWriter(); |
26 |
27 |
out.println( "<html>" ); |
28 |
out.println( "<head>" ); |
29 |
30 |
String title = rb.getString( "helloworld.title" ); |
31 |
32 |
out.println( "<title>" + title + "</title>" ); |
33 |
out.println( "</head>" ); |
34 |
out.println( "<body bgcolor=\"white\">" ); |
35 |
36 |
out.println( "<a href=\"../helloworld.html\">" ); |
37 |
out.println( "<img src=\"../images/code.gif\" height=24 " |
38 |
+ "width=24 align=right border=0 alt=\"view code\"></a>" ); |
39 |
out.println( "<a href=\"../index.html\">" ); |
40 |
out.println( "<img src=\"../images/return.gif\" height=24 " |
41 |
+ "width=24 align=right border=0 alt=\"return\"></a>" ); |
42 |
out.println( "<h1>" + title + "</h1>" ); |
43 |
44 |
Assertion assertion = (Assertion) request.getSession().getAttribute( |
45 |
AbstractCasFilter.CONST_CAS_ASSERTION); |
46 |
47 |
if ( null != assertion) { |
48 |
out.println( " Log | ValidFromDate =:" |
49 |
+ assertion.getValidFromDate() + "<br>" ); |
50 |
out.println( " Log | ValidUntilDate =:" |
51 |
+ assertion.getValidUntilDate() + "<br>" ); |
52 |
Map<Object, Object> attMap = assertion.getAttributes(); |
53 |
out.println( " Log | getAttributes Map size = " + attMap.size() |
54 |
+ "<br>" ); |
55 |
for (Entry<Object, Object> entry : attMap.entrySet()) { |
56 |
out.println( " | " + entry.getKey() + "=:" |
57 |
+ entry.getValue() + "<br>" ); |
58 |
} |
59 |
60 |
} |
61 |
AttributePrincipal principal = assertion.getPrincipal(); |
62 |
63 |
// AttributePrincipal principal = (AttributePrincipal) request |
64 |
// .getUserPrincipal(); |
65 |
66 |
String username = null ; |
67 |
out.print( " Log | UserName:" ); |
68 |
if ( null != principal) { |
69 |
username = principal.getName(); |
70 |
out.println( "<span style='color:red;'>" + username + "</span><br>" ); |
71 |
} |
72 |
73 |
out.println( "</body>" ); |
74 |
out.println( "</html>" ); |
75 |
} |
76 |
} |
再进行上述测试显示结果以下:
http://app1.micmiu.com:18080/examples/servlets/servlet/HelloWorldExample :
http://app2.micmiu.com:28080/examples/servlets/servlet/HelloWorldExample
从上述页面能够看到经过认证的用户名。
到此已经所有完成了CAS单点登陆实例演示。
原文出处:http://www.cnblogs.com/adolfmc/archive/2012/07/16/2593291.html