服务端配置
cas是个好东西,很灵活很好用,但是配置起来很麻烦,网上资料比较零碎。不弄个三五天根本不知道其中的原理,终于在多天的奋斗中配置成功,现在将配置的一些过程记录下来供大家参考。
cas官方网站
下载最新的服务端 CAS Server 3.3.3 Final
解压后将modules下面的cas-server-webapp-3.3.3.war部署到web服务器,作为单点登录的服务器。
登录的服务器下面很多配置文件,通过配置可以做一些扩展。
修改点1:验证方式使用我们自己的用户表验证
cas和当前已有的系统做集成的入口
1.修改deployerConfigContext.xml文件
添加数据源配置
- < bean id = "casDataSource" class = "org.apache.commons.dbcp.BasicDataSource" >
- < property name = "driverClassName" >
- < value > com.mysql.jdbc.Driver </ value >
- </ property >
- < property name = "url" >
- < value > jdbc:mysql://192.168.1.100/ires? useUnicode = true & characterEncoding = UTF -8& autoReconnect = true </ value >
- </ property >
- < property name = "username" >
- < value > ires </ value >
- </ property >
- < property name = "password" >
- < value > i709394 </ value >
- </ property >
- </ bean >
定义MD5的加密方式
- < bean id = "passwordEncoder"
- class = "org.jasig.cas.authentication.handler.DefaultPasswordEncoder" autowire = "byName" >
- < constructor-arg value = "MD5" />
- </ bean >
配置authenticationManager下面的authenticationHandlers属性
- < bean class = "org.jasig.cas.adaptors.jdbc.QueryDatabaseAuthenticationHandler" >
- < property name = "dataSource" ref = "casDataSource" />
- < property name = "sql" value = "select community_password from community_user_info where lower(community_user_info.community_user) = lower(?)" />
- < property name = "passwordEncoder" ref = "passwordEncoder" />
- </ bean >
修改点2:获取用户信息保存,方便各个客户端可以统一得到用户信息
1.定义attributeRepository,通过jdbc查询用户的详细信息,可以把用户表或用户的所属组织机构或角色等查询出来。
- < bean id = "attributeRepository" class = "org.jasig.services.persondir.support.jdbc.SingleRowJdbcPersonAttributeDao" >
- < constructor-arg index = "0" ref = "casDataSource" />
- < constructor-arg index = "1" >
- < list >
- < value > username </ value >
- < value > username </ value >
- </ list >
- </ constructor-arg >
- < constructor-arg index = "2" >
- < value >
- select * ,(SELECT orgn_organization.id from orgn_organization left join orgn_member on orgn_member.orgn_id = orgn_organization .id left join community_user_info on community_user_info.id = orgn_member .user_id where community_user_info.community_user = ?) as orgnId from community_user_info where community_user =?
- </ value >
- </ constructor-arg >
- < property name = "columnsToAttributes" >
- < map >
- < entry key = "id" value = "id" />
- < entry key = "community_user" value = "userName" />
- < entry key = "orgnId" value = "orgnId" />
- < entry key = "is_admin" value = "isAdmin" />
- </ map >
- </ property >
- </ bean >
2.配置authenticationManager中credentialsToPrincipalResolvers属性
- < bean class = "org.jasig.cas.authentication.principal.UsernamePasswordCredentialsToPrincipalResolver" >
- < property name = "attributeRepository" ref = "attributeRepository" /> </ bean >
注意:默认cas登录服务器没有把用户信息传到客户端中 ,所以要修改WEB-INF\view\jsp\protocol\2.0\casServiceValidationSuccess.jsp文件,增加
- < c:if test = "${fn:length(assertion.chainedAuthentications[fn:length(assertion.chainedAuthentications)-1].principal.attributes) > 0}" >
- < cas:attributes >
- < c:forEach var = "attr" items = "${assertion.chainedAuthentications[fn:length(assertion.chainedAuthentications)-1].principal.attributes}" >
- < cas: ${fn:escapeXml(attr.key)} > ${fn:escapeXml(attr.value)} </ cas: ${fn:escapeXml(attr.key)} >
- </ c:forEach >
- </ cas:attributes >
- </ c:if >
修改点3:用数据库来保存登录的会话
这样服务器在重新启动的时候不会丢失会话。
1.修改ticketRegistry.xml文件
将默认的ticketRegistry改成
- < bean id = "ticketRegistry" class = "org.jasig.cas.ticket.registry.JpaTicketRegistry" >
- < constructor-arg index = "0" ref = "entityManagerFactory" />
- </ bean >
- < bean id = "entityManagerFactory" class = "org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean" >
- < property name = "dataSource" ref = "dataSource" />
- < property name = "jpaVendorAdapter" >
- < bean class = "org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter" >
- < property name = "generateDdl" value = "true" />
- < property name = "showSql" value = "true" />
- </ bean >
- </ property >
- < property name = "jpaProperties" >
- < props >
- < prop key = "hibernate.dialect" > org.hibernate.dialect.MySQLDialect </ prop >
- < prop key = "hibernate.hbm2ddl.auto" > update </ prop >
- </ props >
- </ property >
- </ bean >
- < bean id = "transactionManager" class = "org.springframework.orm.jpa.JpaTransactionManager"
- p:entityManagerFactory-ref = "entityManagerFactory" />
- < tx:annotation-driven transaction-manager = "transactionManager" />
- < bean
- id = "dataSource"
- class = "org.apache.commons.dbcp.BasicDataSource"
- p:driverClassName = "com.mysql.jdbc.Driver"
- p:url = "jdbc:mysql://192.168.1.100:3306/cas?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true"
- p:password = "709394"
- p:username = "itravel" />
配置完之后还需要一些jar的支持,根据提示那些包缺少到网上找。
修改点4:配置remenber me的功能,可以让客户端永久保存session
1.修改deployerConfigContext.xml文件
authenticationManager增加authenticationMetaDataPopulators属性
- < property name = "authenticationMetaDataPopulators" >
- < list >
- < bean class = "org.jasig.cas.authentication.principal.RememberMeAuthenticationMetaDataPopulator" />
- </ list >
- </ property >
2.修改cas-servlet.xml
修改authenticationViaFormAction配置变成
- < bean id = "authenticationViaFormAction" class = "org.jasig.cas.web.flow.AuthenticationViaFormAction"
- p:centralAuthenticationService-ref = "centralAuthenticationService"
- p:formObjectClass = "org.jasig.cas.authentication.principal.RememberMeUsernamePasswordCredentials"
- p:formObjectName = "credentials"
- p:validator-ref = "UsernamePasswordCredentialsValidator"
- p:warnCookieGenerator-ref = "warnCookieGenerator" />
增加UsernamePasswordCredentialsValidator
- < bean id = "UsernamePasswordCredentialsValidator" class = "org.jasig.cas.validation.UsernamePasswordCredentialsValidator" />
修改ticketExpirationPolicies.xml,grantingTicketExpirationPolicy配置如下,注意时间要加大,不然session很容易过期,达不到remember me的效果。
- < bean id = "grantingTicketExpirationPolicy" class = "org.jasig.cas.ticket.support.RememberMeDelegatingExpirationPolicy" >
- < property name = "sessionExpirationPolicy" >
- < bean class = "org.jasig.cas.ticket.support.TimeoutExpirationPolicy" >
- < constructor-arg index = "0" value = "2592000000" />
- </ bean >
- </ property >
- < property name = "rememberMeExpirationPolicy" >
- < bean class = "org.jasig.cas.ticket.support.TimeoutExpirationPolicy" >
- < constructor-arg index = "0" value = "2592000000" />
- </ bean >
- </ property >
- </ bean >
登录页面要增加隐藏字段rememberMe,值是true,或用一个checkbox来勾选。
修改点5:取消https验证
在网络安全性较好,对系统安全没有那么高的情况下可以取消https验证,使系统更加容易部署。
1.修改ticketGrantingTicketCookieGenerator.xml
- < bean id = "ticketGrantingTicketCookieGenerator" class = "org.jasig.cas.web.support.CookieRetrievingCookieGenerator"
- p:cookieSecure = "false"
- p:cookieMaxAge = "-1"
- p:cookieName = "CASTGC"
- p:cookiePath = "/cas" />
p:cookieSecure改成false,客户端web.xml中单独服务器的链接改成http
使用https协议的配置
1.证书生成和导入
下面是一个生成证书和导入证书的bat脚本,如果web应用和单独登录服务器部署在同一台机可以一起执行
- @echo off
- if "%JAVA_HOME%" == "" goto error
- @echo on
- @echo off
- cls
- rem please set the env JAVA_HOME before run this bat file
- rem delete alia tomcat if it is existed
- keytool - delete -alias tomcatsso -keystore "%JAVA_HOME%/jre/lib/security/cacerts" -storepass changeit
- keytool - delete -alias tomcatsso -storepass changeit
- REM (注释: 清除系统中可能存在的名字为tomcatsso 的同名证书)
- rem list all alias in the cacerts
- keytool -list -keystore "%JAVA_HOME%/jre/lib/security/cacerts" -storepass changeit
- REM (注释: 列出系统证书仓库中存在证书名称列表)
- rem generator a key
- keytool -genkey -keyalg RSA -alias tomcatsso -dname "cn=localhost" -storepass changeit
- REM (注释:指定使用RSA算法,生成别名为tomcatsso的证书,存贮口令为changeit,证书的DN为 "cn=linly" ,这个DN必须同当前主机完整名称一致哦,切记!!!)
- rem export the key
- keytool -export -alias tomcatsso -file "%java_home%/jre/lib/security/tomcatsso.crt" -storepass changeit
- REM (注释: 从keystore中导出别名为tomcatsso的证书,生成文件tomcatsso.crt)
- rem import into trust cacerts
- keytool -import -alias tomcatsso -file "%java_home%/jre/lib/security/tomcatsso.crt" -keystore "%java_home%/jre/lib/security/cacerts" -storepass changeit
- REM (注释:将tomcatsso.crt导入jre的可信任证书仓库。注意,安装JDK是有两个jre目录,一个在jdk底下,一个是独立的jre,这里的目录必须同Tomcat使用的jre目录一致,否则后面Tomcat的HTTPS通讯就找不到证书了)
- rem list all alias in the cacerts
- keytool -list -keystore "%JAVA_HOME%/jre/lib/security/cacerts" -storepass changeit
- pause
- :error
- echo 请先设置JAVA_HOME环境变量
- :end
3.将.keystore文件拷贝到tomcat的conf目录下面,注意.keystore会在证书生成的时候生成到系统的用户文件夹中,如windows会生产到C:\Documents and Settings\[yourusername]\下面
2.配置tomcat,把https协议的8443端口打开,指定证书的位置。
- < Connector port = "8443" maxHttpHeaderSize = "8192"
- maxThreads = "150" minSpareThreads = "25" maxSpareThreads = "75"
- enableLookups = "false" disableUploadTimeout = "true"
- acceptCount = "100" scheme = "https" secure = "true"
- clientAuth = "false" sslProtocol = "TLS"
- keystoreFile = "conf/.keystore" keystorePass = "changeit" truststoreFile = "C:\Program Files\Java\jdk1.5.0_07\jre\lib\security\cacerts" />
客户端配置
cas官方网站上面的客户端下载地址比较隐秘,没有完全公开,具体地址为
http://www.ja-sig.org/downloads/cas-clients/
下载最新的cas-client-3.1.6-release.zip
1.解压后把modules下面的包放到我们的web应用中
2.配置web.xml,注意encodingFilter要提前配置,不然会出现数据插入数据库的时候有乱码。
serverName是我们web应用的地址和端口
- < context-param >
- < param-name > serverName </ param-name >
- < param-value > 192.168.1.145:81 </ param-value >
- </ context-param >
- < filter >
- < filter-name > encodingFilter </ filter-name >
- < filter-class >
- org.springframework.web.filter.CharacterEncodingFilter
- </ filter-class >
- < init-param >
- < param-name > encoding </ param-name >
- < param-value > UTF-8 </ param-value >
- </ init-param >
- < init-param >
- < param-name > forceEncoding </ param-name >
- < param-value > true </ param-value >
- </ init-param >
- </ filter >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.htm </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.ftl </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.xhtml </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.html </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.shtml </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.jsp </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.do </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > encodingFilter </ filter-name >
- < url-pattern > *.vm </ url-pattern >
- </ filter-mapping >
- < 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 >
- < listener >
- < listener-class >
- org.jasig.cas.client.session.SingleSignOutHttpSessionListener
- </ listener-class >
- </ listener >
- < filter >
- < filter-name > CAS Authentication Filter </ filter-name >
- < filter-class >
- org.jasig.cas.client.authentication.AuthenticationFilter
- </ filter-class >
- < init-param >
- < param-name > casServerLoginUrl </ param-name >
- < param-value > http://192.168.1.100/cas/login </ param-value >
- </ init-param >
- </ filter >
- < 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 > http://192.168.1.100/cas </ param-value >
- </ init-param >
- </ filter >
- < filter >
- < filter-name > CAS HttpServletRequest Wrapper Filter </ filter-name >
- < filter-class >
- org.jasig.cas.client.util.HttpServletRequestWrapperFilter
- </ filter-class >
- </ filter >
- < 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 Authentication Filter </ filter-name >
- < url-pattern > /* </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > CAS Validation Filter </ filter-name >
- < url-pattern > /* </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > CAS HttpServletRequest Wrapper Filter </ filter-name >
- < url-pattern > /* </ url-pattern >
- </ filter-mapping >
- < filter-mapping >
- < filter-name > CAS Assertion Thread Local Filter </ filter-name >
- < url-pattern > /* </ url-pattern >
- </ filter-mapping >
3.导入证书,如果不用https的话,这步可以跳过,把tomcatsso.crt 证书拷贝到c盘下面,在jdk的bin目录下面运行下面的语句。
- rem (注释: 清除系统中可能存在的名字为tomcatsso 的同名证书)
- keytool - delete -alias tomcatsso -keystore "%JAVA_HOME%/jre/lib/security/cacerts" -storepass changeit
- keytool - delete -alias tomcatsso -storepass changeit
- rem 在客户端的 JVM 里导入信任的 SERVER 的证书 ( 根据情况有可能需要管理员权限 )
- keytool - import -alias tomcatsso -file "c:/tomcatsso.crt" -keystore "%java_home%/jre/lib/security/cacerts" -storepass changeit
客户端获取登录用户名和用户信息实例
- HttpServletRequest request = ServletActionContext.getRequest();
- AttributePrincipal principal = (AttributePrincipal)request.getUserPrincipal();
- String username = principal.getName();
- Long orgnId = Long.parseLong(principal.getAttributes().get( "orgnId" ).toString());