/**
* @see CAS客户端配置
* @see ------------------------------------------------------------------------------------------------------------------------
* @see 这里用的是cas-client-core-3.4.0.jar(这是2015-07-21发布的)
* @see 下载地址http://mvnrepository.com/artifact/org.jasig.cas.client/cas-client-core/3.4.0
* @see 另外为了使客户端在HTTP协议下单点成功,可以修改以下两处配置使其不开启HTTPS验证
* @see 1.\WEB-INF\deployerConfigContext.xml
* @see 添加p:requireSecure="false"
* @see 2.\WEB-INF\spring-configuration\ticketGrantingTicketCookieGenerator.xml和\WEB-INF\spring-configuration\warnCookieGenerator.xml
* @see p:cookieSecure="true"改为p:cookieSecure="false"
* @see 下面介绍两种配置方法,一种是纯web.xml配置,一种是借助Spring来配置,相关的官方文档如下所示
* @see https://wiki.jasig.org/display/CASC/Configuring+the+Jasig+CAS+Client+for+Java+in+the+web.xml
* @see https://wiki.jasig.org/display/CASC/Configuring+the+JA-SIG+CAS+Client+for+Java+using+Spring
* @see ------------------------------------------------------------------------------------------------------------------------
* @see 纯web.xml
* @see web.xml中需配置四个顺序固定的Filter,而且出于认证考虑,最好配置在其他Filter之前,它们的先后顺序如下
* @see AuthenticationFilter
* @see TicketValidationFilter(或其它AbstractTicketValidationFilter实现,比如Cas20ProxyReceivingTicketValidationFilter)
* @see HttpServletRequestWrapperFilter
* @see AssertionThreadLocalFilter
* @see 另外各个Filter的优先级都比要高,通常用来配置公用的参数
* @see 1.AuthenticationFilter
* @see 用来拦截请求,判断是否需要CASServer认证,需要则跳转到CASServer登录页,否则放行请求
* @see 有两个必须参数,一个是指定CASServer登录地址的casServerLoginUrl,另一个是指定认证成功后跳转地址的serverName或service
* @see service和serverName设置一个即可,二者都设置时service的优先级更高,即会以service为准
* @see service指的是一个确切的URL,而serverName是用来指定客户端的主机名的,格式为{protocol}:{hostName}:{port}
* @see 指定serverName时,该Filter会把它附加上当前请求的URI及对应的查询参数来构造一个确切的URL作为认证成功后的跳转地址
* @see 比如serverName为"http://gg.cn",当前请求的URI为"/oa",查询参数为"aa=bb",则认证成功后跳转地址为http://gg.cn/oa?aa=bb
* @see casServerLoginUrl--去哪登录,serverName--我是谁
* @see 2.TicketValidationFilter
* @see 请求通过AuthenticationFilter认证后,若请求中携带了ticket参数,则会由该类Filter对携带的ticket进行校验
* @see 验证ticket的时候,要访问CAS服务的/serviceValidate接口,使用的url就是${casServerUrlPrefix}/serviceValidate
* @see 所以它也有两个参数是必须指定的,casServerUrlPrefix(CASServer对应URL地址的前缀)和serverName或service
* @see 实际上,TicketValidationFilter只是对验证ticket的这一类Filter的统称,其并不对应CASClient中的具体类型
* @see CASClient中有多种验证ticket的Filter,都继承自AbstractTicketValidationFilter
* @see 常见的有Cas10TicketValidationFilter/Cas20ProxyReceivingTicketValidationFilter/Saml11TicketValidationFilter
* @see 它们的验证逻辑都是一致的,都有AbstractTicketValidationFilter实现,只是使用的TicketValidator不一样而已
* @see 如果要从服务器获取用户名之外的更多信息应该采用CAS20这个2.0协议的代理
* @see 3.HttpServletRequestWrapperFilter
* @see 用于封装每个请求的HttpServletRequest为其内部定义的CasHttpServletRequestWrapper
* @see 它会将保存在Session或request中的Assertion对象重写HttpServletRequest的getUserPrincipal()、getRemoteUser()、isUserInRole()
* @see 这样在我们的应用中就可以非常方便的从HttpServletRequest中获取到用户的相关信息
* @see 4.AssertionThreadLocalFilter
* @see 为了方便用户在应用的其它地方获取Assertion对象,其会将当前的Assertion对象存放到当前的线程变量中
* @see 以后用户在程序的任何地方都可以从线程变量中获取当前的Assertion,而无需从Session或request中解析
* @see 该线程变量是由AssertionHolder持有的,我们在获取当前的Assertion时也只需Assertion assertion = AssertionHolder.getAssertion()
* @see ------------------------------------------------------------------------------------------------------------------------
* @see 借助Spring
* @see 与上述web.xml配置四个Filter方式不同的是,可以使用Spring的四个DelegatingFilterProxy来代理需要配置的四个Filter
* @see 此时这四个Filter就应该配置为Spring的Bean对象,并且web.xml中的就应该对应SpringBean名称
* @see 但是SingleSignOutFilter/HttpServletRequestWrapperFilter/AssertionThreadLocalFilter等Filter不含配置参数
* @see 所以实际上只需要配置AuthenticationFilter和Cas20ProxyReceivingTicketValidationFilter两个Filter交由Spring代理就可以了
* @see ------------------------------------------------------------------------------------------------------------------------
* @see 注意
* @see 1.CAS1.0提供的接口有/validate,CAS2.0提供的接口有/serviceValidate,/proxyValidate,/proxy
* @see 2.四个Filter太多了,有时间的话考虑参考org.springframework.web.filter.CompositeFilter写一个Filter来实现
* @see 3.web.xml的好处是可以配置匿名访问的资源,配置参数参考AuthenticationFilter中的ignoreUrlPatternMatcherStrategyClass
* @see 起码cas-client-core-3.4.0.jar中的Spring配置还不支持ignorePattern(该参数默认正则验证,此外还有contains和equals验证)
* @see 4.javax.net.ssl.SSLHandshakeException: java.security.cert.CertificateException: No name matching casserver found
* @see 这是由于创建证书的域名和应用中配置的CAS服务域名不一致导致出错(说白了就是指客户端导入的CRT证书与CAS服务端的域名不同)
* @see ------------------------------------------------------------------------------------------------------------------------
* @create 2015-7-26 下午1:00:14
* @author 玄玉
*/
下面是web.xml的配置
contextConfigLocation
classpath:applicationContext.xml
org.springframework.web.context.ContextLoaderListener
SpringMVC
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:applicationContext.xml
SpringMVC
/
CharacterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceEncoding
true
CharacterEncodingFilter
/*
casAuthenticationFilter
org.springframework.web.filter.DelegatingFilterProxy
casAuthenticationFilter
/*
casTicketValidationFilter
org.springframework.web.filter.DelegatingFilterProxy
casTicketValidationFilter
/*
casHttpServletRequestWrapperFilter
org.jasig.cas.client.util.HttpServletRequestWrapperFilter
casHttpServletRequestWrapperFilter
/*
casAssertionThreadLocalFilter
org.jasig.cas.client.util.AssertionThreadLocalFilter
casAssertionThreadLocalFilter
/*
下面是//src//applicationContext.xml
classpath:config.properties
下面是//src//config.properties
#<>
#where to login
casServerLoginUrl=http://sso.jadyer.com:8080/cas-server-web/login
#login server root
casServerUrlPrefix=http://sso.jadyer.com:8080/cas-server-web
#who am i
#casClientServerName=http://boss.jadyer.com:8180
casClientServerName=http://risk.jadyer.com:8280
最后是//WebRoot//index.jsp
<%@ page pageEncoding="UTF-8"%>
<%@ page import="java.util.Map"%>
<%@ page import="java.net.URLDecoder"%>
<%@ page import="org.jasig.cas.client.util.AssertionHolder"%>
<%@ page import="org.jasig.cas.client.authentication.AttributePrincipal"%>
客户端登录成功
<%
AttributePrincipal principal = (AttributePrincipal)request.getUserPrincipal();
Map attributes = principal.getAttributes();
out.print("principal.getName()=" + principal.getName() + "
");
out.print("request.getRemoteUser()=" + request.getRemoteUser() + "
");
out.print("登录用户:" + attributes.get("userId") + "
");
out.print("登录时间:" + AssertionHolder.getAssertion().getAuthenticationDate() + "
");
out.print("-----------------------------------------------------------------------
");
for(Map.Entry entry : attributes.entrySet()){
//服务端返回中文时需要encode,客户端接收显示中文时需要decode,否则会乱码
out.print(entry.getKey() + "=" + URLDecoder.decode(entry.getValue().toString(), "UTF-8") + "
");
}
out.print("-----------------------------------------------------------------------
");
Map attributes22 = AssertionHolder.getAssertion().getAttributes();
for(Map.Entry entry : attributes22.entrySet()){
out.print(entry.getKey() + "=" + entry.getValue() + "
");
}
out.print("-----------------------------------------------------------------------
");
Map attributes33 = AssertionHolder.getAssertion().getPrincipal().getAttributes();
for(Map.Entry entry : attributes33.entrySet()){
out.print(entry.getKey() + "=" + entry.getValue() + "
");
}
%>
接下来就可以测试了,测试之前先修改几处配置,模拟单点环境
/**
* @see ------------------------------------------------------------------------------------------------------------------------
* @see 测试时在C:\Windows\System32\drivers\etc\hosts中添加以下三个配置
* @see 127.0.0.1 sso.jadyer.com
* @see 127.0.0.1 boss.jadyer.com
* @see 127.0.0.1 risk.jadyer.com
* @see ------------------------------------------------------------------------------------------------------------------------
* @see 然后拷贝三个Tomcat,分别用作sso服务器和两个sso客户端
* @see 修改两个sso客户端的\Tomcat\conf\server.xml的以下三个端口,保证启动监听端口不重复
* @see
* @see
* @see
* @see
* @see
* @see
* @see ------------------------------------------------------------------------------------------------------------------------
* @see 最后修改两个sso客户端的\Tomcat\webapps\cas-client\WEB-INF\classes\config.properties的casClientServerName值
* @see casClientServerName=http://boss.jadyer.com:8180
* @see casClientServerName=http://risk.jadyer.com:8280
* @see ------------------------------------------------------------------------------------------------------------------------
* @create 2015-7-26 下午1:08:35
* @author 玄玉
*/
先访问http://boss.jadyer.com:8180/cas-client,发现没登录会自动跳转到单点登录页
输入密码后登录成功
再访问http://risk.jadyer.com:8280/cas-client,会发现自动登录成功,不用再登录了