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="登&nbsp;&nbsp;录" 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目录下!

11.CAS 开源单点登陆系统部署配置【have todo list】

11.CAS 开源单点登陆系统部署配置【have todo list】

CAS 开源单点登陆系统部署配置【have todo list】

一、CAS介绍

1). SSO单点登录访问流程

二、CAS服务端部署

1). 部署CAS服务

2). 修改端口配置

3). 去除https认证

4). 设置退出登陆后自动跳转

5). 配置数据源

6). 登陆页面改造

7). 中文错误提示

三、CAS原生客户端配置

1). maven项目结构

2). pom.xml依赖坐标

3). WEB-INF/web.xml配置

4). index.jsp

四、CAS单点登陆+第三方免登陆【TODO】

推荐阅读更多精彩内容

11.CAS 开源单点登陆系统部署配置【*have todo list*】

CAS 开源单点登陆系统部署配置【have todo list】

一、CAS介绍

1). SSO单点登录访问流程

二、CAS服务端部署

1). 部署CAS服务

2). 修改端口配置

3). 去除https认证

4). 设置退出登陆后自动跳转

5). 配置数据源

6). 登陆页面改造

7). 中文错误提示

三、CAS原生客户端配置

1). maven项目结构

2). pom.xml依赖坐标

3). WEB-INF/web.xml配置

4). index.jsp

四、CAS单点登陆+第三方免登陆【TODO】

推荐阅读更多精彩内容

11.CAS 开源单点登陆系统部署配置【have todo list】