CAS 开源单点登陆系统部署配置【have todo list】
单点登录（Single Sign On），简称为 SSO，是目前比较流行的企业业务整合的解决方案之一。SSO的定义是在多个应用系统中，用户只需要登录一次就可以访问所有相互信任的应用系统。
SSO概念.png
一、CAS介绍
CAS 是 Yale 大学发起的一个开源项目，旨在为 Web 应用系统提供一种可靠的单点登录方法，CAS 在2004年12月正式成为JA-SIG的一个项目。有如下特点：①开源的企业级单点登录解决方案；②CAS Server为需要独立部署的Web应用(Spring框架开发项目)；③CAS Client 支持非常多的客户端(这里指单点登录系统中的各个 Web 应用)，包括 Java, .Net, PHP, Perl, Apache, uPortal, Ruby 等；从结构上看，CAS 包含两个部分： CAS Server 和 CAS Client。CAS Server 需要独立部署，主要负责对用户的认证工作；CAS Client 负责处理对客户端受保护资源的访问请求，需要登录时，重定向到 CAS Server。下图是 CAS 最基本的协议过程：
1). SSO单点登录访问流程
CAS.png
- 访问服务：SSO客户端发送请求访问应用系统提供的服务资源。
- 定向认证：SSO客户端会重定向用户请求到SSO服务器。
- 用户认证：用户身份认证。
- 发放票据：SSO服务器会产生一个随机的Service Ticket。
- 验证票据：SSO服务器验证票据Service Ticket的合法性，验证通过后，允许客户端访问服务。
- 传输用户信息：SSO服务器验证票据通过后，传输用户认证结果信息给客户端。
二、CAS服务端部署
以Windown10环境为例，Linux环境配置如初一折，ip需要换换(Java跨平台的好处)；源码包后期补上
1). 部署CAS服务
以Tomcat8.5Web容器为例；在资源
\cas\source\cas-server-4.0.0-release\cas-server-4.0.0\modules目录下cas-server-webapp-4.0.0.war将其改名为cas.war放入tomcat目录下的webapps下。启动tomcat自动解压war包。浏览器输入ip:端口/cas/login，可看到登录页面！
- 用户名：
casuser - 密码：
Mellon
2). 修改端口配置
- 【可选】修改tomcat8.5容器端口,打开tomcat目录
conf\server.xml, 使用vim命令编辑
<Connector port="9100" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
- 【与第一步保持一致】修改
webapps/cas的WEB-INF/cas.properties的服务器地址
server.name=http://localhost:9100
3). 去除https认证
cas默认使用https协议，需要申请SSL证书，开发测试阶段使用http协议即可！
- 修改cas的
WEB-INF/deployerConfigContext.xml添加参数p:requireSecure="false"(requireSecure默认true，使用https协议)
<bean id="proxyAuthenticationHandler"
class="org.jasig.cas.authentication.handler.support.HttpBasedServiceCredentialsAuthenticationHandler"
p:httpClient-ref="httpClient"
p:requireSecure="false" />
- 修改cas的
/WEB-INF/spring-configuration/ticketGrantingTicketCookieGenerator.xml- cookieSecure: HTTPS验证相关
- cookieMaxAge: COOKIE的最大生命周期; -1 为无生命周期(页面关闭及失效)； 正整数表示秒；3600 为3600秒
<bean id="ticketGrantingTicketCookieGenerator" class="org.jasig.cas.web.support.CookieRetrievingCookieGenerator"
p:cookieSecure="false"
p:cookieMaxAge="3600"
p:cookieName="CASTGC"
p:cookiePath="/cas" />
- 修改cas的
WEB-INF/spring-configuration/warnCookieGenerator.xml
<bean id="warnCookieGenerator" class="org.jasig.cas.web.support.CookieRetrievingCookieGenerator"
p:cookieSecure="false"
p:cookieMaxAge="3600"
p:cookieName="CASPRIVACY"
p:cookiePath="/cas" />
4). 设置退出登陆后自动跳转
例如：http://localhost:9100/cas/logout?service=https://www.jianshu.com/u/532e2353a353
- 修改cas系统的配置文件
cas-servlet.xml,如下面值为true的部分
<bean id="logoutAction" class="org.jasig.cas.web.flow.LogoutAction"
p:servicesManager-ref="servicesManager"
p:followServiceRedirects="${cas.logout.followServiceRedirects:true}"/>
5). 配置数据源
根据实际业务场景进行配置
- 修改cas服务端中web-inf下
deployerConfigContext.xml，【添加】 如下配置
这里以C3p0数据库连接池技术为例，当然可以使用阿里巴巴的Drud技术；密码加密方式使用MD5(根据不同技术配置即可)
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
<!-- ~~~~~~~~~~~配置数据源~~~~~~~~~~~ -->
<!-- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -->
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"
p:driverClass="com.mysql.jdbc.Driver"
p:jdbcUrl="jdbc:mysql://127.0.0.1:3306/pinyougoudb?characterEncoding=utf8"
p:user="root"
p:password="abc123" />
<bean id="passwordEncoder"
class="org.jasig.cas.authentication.handler.DefaultPasswordEncoder"
c:encodingAlgorithm="MD5"
p:characterEncoding="UTF-8" />
<bean id="dbAuthHandler"
class="org.jasig.cas.adaptors.jdbc.QueryDatabaseAuthenticationHandler"
p:dataSource-ref="dataSource"
p:sql="select password from tb_user where username = ?"
p:passwordEncoder-ref="passwordEncoder"/>
- 找到 beand的id为"authenticationManager" 的配置
<bean id="authenticationManager" class="org.jasig.cas.authentication.PolicyBasedAuthenticationManager">
<constructor-arg>
<map>
<entry key-ref="proxyAuthenticationHandler" value-ref="proxyPrincipalResolver" />
<!-- 默认配置用户名密码配置，需要注释掉 -->
<!--<entry key-ref="primaryAuthenticationHandler" value-ref="primaryPrincipalResolver" />-->
<!-- 配置数据库中的数据源, 将上面配置的bean id="dbAuthHandler" -->
<entry key-ref="dbAuthHandler" value-ref="primaryPrincipalResolver" />
</map>
</constructor-arg>
<property name="authenticationPolicy">
<bean class="org.jasig.cas.authentication.AnyAuthenticationPolicy" />
</property>
</bean>
- 将数据库连接的jar包放入
webapps\cas\WEB-INF\lib下
可自行百度下载
c3p0-0.9.1.2.jar
cas-server-support-jdbc-4.0.0.jar
mysql-connector-java-5.1.32.jar
6). 登陆页面改造
- 将css、js等文件夹拷贝到 cas目录下
- 定制登陆页xxx.html拷贝到cas系统下
WEB-INF\view\jsp\default\ui目录下 - 将
WEB-INF\view\jsp\default\ui目录下的casLoginView.jsp更名为casLoginView.jsp.html - 根据
casLoginView.jsp.html修改xxx.html并重命名为casLoginView.jsp修改模板如下
<%@ page pageEncoding="UTF-8" %>
<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="spring" uri="http://www.springframework.org/tags" %>
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8"><title>欢迎登录</title><style>.errors{color: red;}</style>
</head>
<body>
<form:form method="post" id="fm1" commandName="${commandName}" htmlEscape="true" class="sui-form">
<form:input id="username" tabindex="1"
accesskey="${userNameAccessKey}" path="username" autocomplete="off" htmlEscape="true"
placeholder="邮箱/用户名/手机号" />
<form:password id="password" tabindex="2" path="password"
accesskey="${passwordAccessKey}" htmlEscape="true" autocomplete="off"
placeholder="请输入密码"/>
<%-- 错误提示信息 --%>
<form:errors path="*" id="msg" cssClass="errors" element="div" htmlEscape="false" />
<div class="logined">
<input type="hidden" name="lt" value="${loginTicket}" />
<input type="hidden" name="execution" value="${flowExecutionKey}" />
<input type="hidden" name="_eventId" value="submit" />
<input class="sui-btn btn-block btn-xlarge btn-danger" accesskey="l" value="登 录" type="submit" />
</div>
</form:form>
</body>
</html>
7). 中文错误提示
- 设置国际化为zn_CN ,修改
WEB-INF\cas-servlet.xml
默认使用
WEB-INF\classes\messages.properties文件；这里修改为使用messages_zh_CN.properties文件
<bean id="localeResolver" class="org.springframework.web.servlet.i18n.CookieLocaleResolver" p:defaultLocale="zh_CN" />
- 修改
WEB-INF\classes\messages_zh_CN.properties文件- 第一个是用户名不存在时的错误提示
- 第二个是密码错误的提示
已经进行了转码处理！Unique
authenticationFailure.AccountNotFoundException=\u7528\u6237\u4E0D\u5B58\u5728
authenticationFailure.FailedLoginException=\u5BC6\u7801\u9519\u8BEF
三、CAS原生客户端配置
1). maven项目结构
打包方式为war包；在webapp下新建一个index.jsp用于演示
2). pom.xml依赖坐标
<packaging>war</packaging>
<dependencies>
<!-- cas坐标 -->
<dependency>
<groupId>org.jasig.cas.client</groupId>
<artifactId>cas-client-core</artifactId>
<version>3.3.3</version>
</dependency>
<!-- 案例中需要使用到原生的api -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.3.2</version>
<configuration>
<source>1.7</source>
<target>1.7</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<configuration>
<!-- 指定端口 -->
<port>9001</port>
<!-- 请求路径 -->
<path>/</path>
</configuration>
</plugin>
</plugins>
</build>
3). WEB-INF/web.xml配置
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5">
<!-- 用于单点退出，该过滤器用于实现单点登出功能，可选配置 -->
<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>CASFilter</filter-name>
<filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>
<init-param>
<param-name>casServerLoginUrl</param-name>
<param-value>http://localhost:9100/cas/login</param-value>
<!--这里的server是服务端的IP -->
</init-param>
<init-param>
<param-name>serverName</param-name>
<param-value>http://localhost:9001</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>CASFilter</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>http://localhost:9100/cas</param-value>
</init-param>
<init-param>
<param-name>serverName</param-name>
<param-value>http://localhost:9001</param-value>
</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>
</web-app>
4). index.jsp
<%--
Created by IntelliJ IDEA.
User: lc
Date: 2019/3/18
Time: 15:09
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
CAS~~客户端~~程序~~NO.1 <br>
<%= request.getRemoteUser() %> <br>
<a href="http://localhost:9100/cas/logout?service=http://www.baidu.com">退出登陆，实现跳转</a>
</body>
</html>
四、CAS单点登陆+第三方免登陆【TODO】
http://moguhu.com/article/detail?articleId=83
自定义的Controller【xml配置的方式，非注解】估计是打成jar包丢到lib目录下!
