一、概述
今天开始写CAS相关的第一篇文章,这篇文章主要是关于CAS环境的搭配,提供给刚刚接触CAS的一个入门指南,并演示一个CAS的最简单的实例
二、环境要求
博主的环境如下:
- win8.1 64 bit
- JDK1.7 下载地址点我
- Tomcat-8.0.15 下载地址点我
- cas-server-4.0.0 、cas-client-3.3.3 下载地址点我 (官网速度比较慢,提供百度网盘)
tomcat服务器需要部署三个,我分别命名为 apache-tomcat-8.0.15-app1、apache-tomcat-8.0.15-app2、apache-tomcat-8.0.15-cas
分别的用途如下:
序号 | 服务器名称 | 用途 |
1 | tomcat-app1 | 客户端服务器1:用户部署应用app1 |
2 | tomcat-app2 | 客户端服务器2:用户部署应用app2 |
3 | tomcat-cas | cas服务器:用来部署CAS server |
三、特别说明
CAS 默认认证方式使用的是HTTPS协议,一般对安全性不高的话建议取消改成HTTP方式。因为,开启的话会经常提示证书过期、需要用户确认等,对客户的感知不好,当前有需要的可以开启。
如果需要HTTPS协议的话,有关证书的生成可以参考这篇文章 : CAS单点登录证书导入
取消HTTPS协议的方法,第四点会具体介绍,大家可以接着往下看!
四、实例讲解
第一步、Tomcat修改
- 解压下载的 Tomcat-8.0.15.zip,并按照第二点的约定复制三个并命名
修改tomcat的相关启动等端口,使机器可以运行多个tomcat。我的访问端口对应如下:
序号 | 服务器名称 | 访问端口 |
1 | tomcat-app1 | 8081 |
2 | tomcat-app2 | 8082 |
3 | tomcat-cas | 18080 |
端口的修改方法:打开 x:\tomcat-app1\conf\server.xml 文件, 找到
第一个:修改Shutdown端口(默认为8005端口)
<Server port="8005" shutdown="SHUTDOWN">
第二个: 修改http访问端口(默认为8080端口) <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
第三个:修改8009端口
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
修改成自己需要的端口即可。
第二步、CAS-SERVER 服务端的部署
-
- 解压下载的 cas-server-4.0.0-release.zip 压缩包
- 找到 X:\cas-server-4.0.0\modules\cas-server-webapp-4.0.0.war 文件
- 解压到 tomcat-cas\webapps\ 下
- 取消HTTPS协议:
1)打开 cas-server\WEB-INF\deployerConfigContext.xml 文件 ,找到如下配置:
<!-- Required for proxy ticket mechanism. --> <bean id="proxyAuthenticationHandler"
class="org.jasig.cas.authentication.handler.support.HttpBasedServiceCredentialsAuthenticationHandler" p:httpClient-ref="httpClient" /> 增加参数p:requireSecure="false",是否需要安全验证,即HTTPS,false为不采用。修改后为: <bean id="proxyAuthenticationHandler"
class="org.jasig.cas.authentication.handler.support.HttpBasedServiceCredentialsAuthenticationHandler" p:httpClient-ref="httpClient" p:requireSecure="false" />
2)打开 cas-server\WEB-INF\spring-configuration\ticketGrantingTicketCookieGenerator.xml ,找到如下配置:
<bean id="ticketGrantingTicketCookieGenerator" class="org.jasig.cas.web.support.CookieRetrievingCookieGenerator" p:cookieSecure="true" p:cookieMaxAge="-1" p:cookieName="CASTGC" p:cookiePath="/cas" /> 修改 p:cookieSecure="true" 为 p:cookieSecure="false" 即不开启https验证
3) 打开 cas-server\WEB-INF\spring-configuration\warnCookieGenerator.xml ,找到如下配置:
<bean id="warnCookieGenerator" class="org.jasig.cas.web.support.CookieRetrievingCookieGenerator" p:cookieSecure="true" p:cookieMaxAge="-1" p:cookieName="CASPRIVACY" p:cookiePath="/cas" />
修改 p:cookieSecure="true" 为 p:cookieSecure="false" 即不开启https验证
5.启动 tomcat-cas ,访问 http://localhost:18080/cas-server ,可以看到如下界面
注意:cas-server4.0之前的默认验证规则:只要用户名和密码相同就认证通过
4.0 之后规则改了,默认是配置在 deployerConfigContext.xml 配置文件中,可以看到用户名密码为 casuser/Mellon。
<bean id="primaryAuthenticationHandler" class="org.jasig.cas.authentication.AcceptUsersAuthenticationHandler"> <property name="users"> <map> <entry key="casuser" value="Mellon"/> </map> </property> </bean>
第三步、客户端(cas-client)的配置
注:我们直接用tomcat自带的examples工程作为客户端例子
- 解压我们下载的cas-client-3.3.3-release.zip 包,复制cas-client-3.3.3\modules\cas-client-core-3.3.3.jar 包
- 放到 tomcat-app1\webapps\examples\WEB-INF\lib 下(两个client tomcat都需要放,这边只列出其中一个)
- 修改examples\WEB-INF\web.xml 文件,增加下面的内容:
<!-- ========================单点登录开始 ======================== --> <!--用于单点退出,该过滤器用于实现单点登出功能,可选配置 --> <listener> <listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class> </listener> <!--该过滤器用于实现单点登出功能,可选配置。 --> <filter> <filter-name>CASSingle Sign OutFilter</filter-name> <filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class> </filter> <filter-mapping> <filter-name>CASSingle Sign OutFilter</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> <param-name>casServerLoginUrl</param-name> <param-value>http://localhost:18080/cas-server/login</param-value> </init-param> <init-param> <param-name>serverName</param-name> <param-value>http://localhost:8081</param-value> </init-param> </filter> <filter-mapping> <filter-name>CASFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!--该过滤器负责对Ticket的校验工作,必须启用它 --> <filter> <filter-name>CASValidationFilter</filter-name> <filter-class> org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter </filter-class> <init-param> <param-name>casServerUrlPrefix</param-name> <param-value>http://localhost:18080/cas-server</param-value> </init-param> <init-param> <param-name>serverName</param-name> <param-value>http://localhost:8081</param-value> </init-param> </filter> <filter-mapping> <filter-name>CASValidationFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- 该过滤器负责实现HttpServletRequest请求的包裹, 比如允许开发者通过HttpServletRequest的getRemoteUser()方法获得SSO登录用户的登录名,可选配置。 --> <filter> <filter-name>CASHttpServletRequest WrapperFilter</filter-name> <filter-class> org.jasig.cas.client.util.HttpServletRequestWrapperFilter </filter-class> </filter> <filter-mapping> <filter-name>CASHttpServletRequest WrapperFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- 该过滤器使得开发者可以通过org.jasig.cas.client.util.AssertionHolder来获取用户的登录名。 比如AssertionHolder.getAssertion().getPrincipal().getName()。 --> <filter> <filter-name>CASAssertion Thread LocalFilter</filter-name> <filter-class>org.jasig.cas.client.util.AssertionThreadLocalFilter</filter-class> </filter> <filter-mapping> <filter-name>CASAssertion Thread LocalFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- ========================单点登录结束 ======================== -->
4.启动 tomcat-app1 ,然后访问 http://localhost:8081/examples ,页面会跳到
http://localhost:18080/cas-server/login?service=http%3A%2F%2Flocalhost%3A8081%2Fexamples%2F
说明单点成功
同样的 tomcat-app2 我这边就不演示了,
我把修改完的两个web.xml 上传上来
tomcat-app1 : web.xml
tomcat-app2 : web.xml
第四步、 单点流程演示
我们首先依次把三个tomcat都启动后 ,我们先单独访问两个客户端看看效果
1. 访问 http://localhost:8081/examples ==》 跳到 http://localhost:18080/cas-server/login?service=http%3A%2F%2Flocalhost%3A8081%2Fexamples%2F
2. 访问 http://localhost:8082/examples ==》 跳到 http://localhost:18080/cas-server/login?service=http%3A%2F%2Flocalhost%3A8082%2Fexamples%2F
说明两个客户端第一次访问时都需要跳转到cas-server进行认证
接下来:我们登录其中一个客户端 http://localhost:8081/examples ,账号密码 casuser/Mellon
登录成功后 显示下面的界面
然后我们在打开一个新选项卡 ,直接访问 http://localhost:8082/examples
可以看到 不会跳转到cas-server登录界面 直接显示下面的界面
说明 两个客户端单点登录成功,登录了其中一个,另一个不需要登陆即可进行访问。
总结、
单点登录(Single Sign On , 简称 SSO )是目前比较流行的服务于企业业务整合的解决方案之一, SSO 使得在多个应用系统中,用户只需要登录一次就可以访问所有相互信任的应用系统。
上文只是介绍了最简单的单点登录例子,在实际开发中是不能使用的。如果需要应用到项目中,还需要许多个性化的订制,比如登陆页的美化、通过数据库认证、服务端与客户端用户信息的交互等。这些都会在后面的文章中介绍到。