JEESZ分布式框架单点登录集成方案

第一节：单点登录简介

第一步：了解单点登录

SSO主要特点是: SSO应用之间使用Web协议(如HTTPS) ，并且只有一个登录入口.

SSO的体系中有下面三种角色:

1) User(多个)

2) Web应用(多个)

3) SSO认证中心(一个)

SSO实现包含以下三个原则:

1) 所有的登录都在 SSO 认证中心进行。

2) SSO认证中心通过一些方法来告诉Web应用当前访问用户究竟是不是通过认证的用户.

3) SSO认证中心和所有的 Web 应用建立一种信任关系.

CAS的基本原理CAS(Central Authentication Service) 是 Yale 耶鲁大学发起的构建Web SSO的Java开源项目。

1.CAS术语解释:

SSO－Single Sign On单点登录

TGT－Ticket Granting Ticket 用户身份认证凭证

ST－Service Ticket服务许可凭证

TGC－Ticket Granting Cookie存放用户身份认证凭证的cookie.

第二步：了解单点登录体系结构

1) CAS Server负责完成对用户信息的认证，需要单独部署，CAS Server会处理用户名/密码等凭证(Credentials).

2) CAS Client部署在客户端，当有对本地Web应用受保护资源的访问请求，并且需要对请求方进行身份认证，重定向到CAS Server进行认证.

第三步：单点登录环境准备工作

1) cas-server-3.5.0-release.zip（CAS服务端）

2) cas-client-3.3.3-release.zip（CAS客户端）

3) apache-tomcat-7.0.40

4) cas-client-core-3.2.1.jar

5) cas-server-core-3.5.0.jar

6) cas-server-support-jdbc-3.5.0.jar

第二节：单点登录环境搭建与部署

第一步：环境部署

1. 通过Java JDK生成证书三部曲

证书对于实现此单点登录非常之重要，证书是服务器端和客户端安全通信的凭证，本教程只是演示，所有用了JDK自带的证书生成工具keytool。

当然在实际项目中你可以到专门的证书认证中心购买证书。

中文官方网站：http://www.verisign.com/cn/

使用JDK自带的keytool生成证书

第一步生成证书:

keytool -genkey -alias mycacerts -keyalg RSA -keystore C:/common/keys/keycard

注意：输入相关信息用于生成证书.其中名字与姓氏这一最好写你的 域名，如果在单击测试你可以在C:WindowsSystem32driversetchosts文件中映射一个虚拟域名，

注意不要写IP。

第二步导出证书:

keytool -export -file C:/common/keys/keycard.crt -alias mycacerts -keystore C:/common/keys/keycard

第三步导入到JDK安装目录证书:

keytool -import -keystore C:/"Program Files"/Java/jdk1.6.0_32/jre/lib/security/cacerts -file C:/common/keys/keycard.crt -alias mycacerts

1. 解压cas-server-3.5.0-release.zip文件，

在cas-server-3.5.0-releasecas-server-3.5.0modules目录下找到cas-server-webapp-3.5.0.war文件并命名为cas.war，并复制到在Tomcat 根目录的webapps目录下，

如下图：

1. 修改host文件（C:WindowsSystem32driversetc）hosts文件中添加添加以下配置

127.0.0.1 jeesz.cn (配置自己的域名.)

注意：如果想在一台PC机上模拟这个单点登录，就必须域名重定向，如果是多台ＰＣ机，可以不配置此项，下文有用到jeesz.cn，可以用相应ＰＣ机的ＩＰ代替

1. 修改Tomcat文件下的server.xml(apache-tomcat-7.0.40confserver.xml) 添加以下内容：

在server.xml文件中把

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS" />

修改成如下：

port="8443"

protocol="org.apache.coyote.http11.Http11Protocol"

maxThreads="150"

SSLEnabled="true"

scheme="https"

secure="true"

clientAuth="false"

sslProtocol="TLS"

keystoreFile="C:/common/keys/keycard"

keystorePass="xxxxxx "

ciphers="TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA256,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHA256,TLS_RSA_WITH_AES_256_CBC_SHA"

/>

5.启动Tomcat服务，查看信息，（如果有报错，可以根据信息查找错误），打开浏览器，输入http://jeesz.cn:8080/cas如果出现以下界面，则代表CAS服务端配置成功。

注：这个是最简单的CAS服务，只要输入的用户名跟密码一样，就可以正常登陆，在我们实际开发中，这个验证因为跟数据库作比较，接下来，我们就配置数据库校验。

第二步：配置数据库验证

1.在apache-tomcat-7.0.2webappscasWEB-INF目录下找到deployerConfigContext.xml文件，找到如下代码：

添加下面代码：

2.增加数据源dataSource，

在deployerConfigContext.xml，（跟上面同一个文件）找到

，在下面添加如下代码：

com.mysql.jdbc.Driver

jdbc:mysql://127.0.0.1:3306/sso

root

3.数据库添加用户表及数据（这里用的mysql），比如在mysql数据库中有t_user表

4.增加jar包, cas-client-core-3.2.1.jar、cas-server-core-3.5.0.jar、cas-server-support-jdbc-3.5.0.jar包拷贝到apache-tomcat-7.0.2webappscasWEB-INFlib目录下。

5.重启Tomcat，打开浏览器，输入http://jeesz.cn:8080/，输入数据库里的用户名和密码，如果出现如下界面，则配置成功。

现在我们的CAS服务端已经配置好了，接下来，我们配置客户端

第三节：配置自己的Web工程（客户端）

1.在host文件下，添加如下代码：

127.0.0.1 www.sso1.com

127.0.0.1 www.sso2.com

注意：这个网址最好不要用互联网已经存在的域名，否则你将无法访问该地址。

如果想在一台PC机上模拟这个单点登录，就必须域名重定向，如果是多台ＰＣ机，可以不配置此项，下文有用到www.sso1.com，www.sso2.com，可以用相应ＰＣ机的ＩＰ代替

2.在Tomcat 根目录下创建一个sso1,sso2目录。如下如：

1. 在自己的Web工程里加入cas-client-core.jar，commons-logging-1.1.jar，（解压cas-client-3.2.0-release.zip，在cas-client-3.2.0-release.zipcas-client-3.2.0modules，找到该JAR包）

分别加入到sso1,sso2工程的lib里。

4.修改sso1下的web.xml。添加如下代码：

org.jasig.cas.client.session.SingleSignOutHttpSessionListener

SingleSignOutFilter

org.jasig.cas.client.session.SingleSignOutFilter

SingleSignOutFilter

/*

CASValidationFilter

org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter

casServerUrlPrefix

https://jeesz.cn:8443/cas;

serverName

http://www.sso1.com;

useSession

true

exceptionOnValidationFailure

false

redirectAfterValidation

true

CASValidationFilter

/*

CASFilter

org.jasig.cas.client.authentication.AuthenticationFilter

casServerLoginUrl

https://jeesz.cn:8443/cas/login;

serverName

http://www.sso1.com;

CASFilter

/*

CASHttpServletRequestWrapperFilter

org.jasig.cas.client.util.HttpServletRequestWrapperFilter

CASHttpServletRequestWrapperFilter

/*

CASAssertionThreadLocalFilter

org.jasig.cas.client.util.AssertionThreadLocalFilter

CASAssertionThreadLocalFilter

/*

SSO4InvokeContextFilter

com.common.core.busi.other.filter.SSO4InvokeContextFilter

SSO4InvokeContextFilter

/*

5.修改sso2下的web.xml。添加如下代码：

org.jasig.cas.client.session.SingleSignOutHttpSessionListener

SingleSignOutFilter

org.jasig.cas.client.session.SingleSignOutFilter

SingleSignOutFilter

/*

CASValidationFilter

org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter

casServerUrlPrefix

https://jeesz.cn:8443/cas;

serverName

http://www.sso2.com;

useSession

true

exceptionOnValidationFailure

false

redirectAfterValidation

true

CASValidationFilter

/*

CASFilter

org.jasig.cas.client.authentication.AuthenticationFilter

casServerLoginUrl

https://jeesz.cn:8443/cas/login;

serverName

http://www.sso2.com;

CASFilter

/*

CASHttpServletRequestWrapperFilter

org.jasig.cas.client.util.HttpServletRequestWrapperFilter

CASHttpServletRequestWrapperFilter

/*

CASAssertionThreadLocalFilter

org.jasig.cas.client.util.AssertionThreadLocalFilter

CASAssertionThreadLocalFilter

/*

SSO4InvokeContextFilter

com.common.web.filter.SSO4InvokeContextFilter

SSO4InvokeContextFilter

/*

6.编辑sso1,sso2 index.jsp页面,复制如下代码：

sso1 index.jsp:

这个是www.sso1.com

你好我是sso1页面:

<%= request.getRemoteUser()== null ? "null" : request.getRemoteUser() %>

Sso2 index.jsp:

这个是www.sso2.com

你好我是sso2页面:

<%= request.getRemoteUser()== null ? "null" : request.getRemoteUser() %>

7.通过eclipse发布到Tomcat服务器上去。找到Tomcat，webapps下的sso1,sso2文件夹，分别复制sso1和sso2下面的所有文件，找到Tomcat根目录下的sso1,sso2(就是我们前面步骤新建的目录)，在sso1,sso2下新建ROOT目录，把刚刚复制的文件粘贴。

配置Tomcat 下server.xml文件，加入如下代码：

8.重启Tomcat，打开浏览器输入网址：www.sso1.com:8080，输入用户名与密码，如果出现以下信息，则成功

在浏览器上输入www.sso1.com:8080，你会发现跳回到登录页面，不要担心。打开ticketGrantingTicketCookieGenerator.xml路径在apache-tomcat-7.0.40casROOTWEB-INFspring-configuration。找到p:cookieSecure="true"，将其修改为p:cookieSecure="false"，重启Tomcat，测试一下。

注：我们以上步骤返回的只有一个用户名，CAS服务器默认返回该信息。

第是节：修改单点登录默认界面

第一步：找到它自己的页面

打开cas工程，找到G:SoftWaretomcatapache-tomcat-7.0.2apache-tomcat-7.0.2webappscasWEB-INFviewjspdefault这个目录，将其复制一份重命名放在G:SoftWaretomcatapache-tomcat-7.0.2apache-tomcat-7.0.2webappscasWEB-INFviewjsp目录下，

第二步：修改默认登录页面

将其命名为mydefalut如下图：

然后将apache-tomcat-7.0.2webappscasWEB-INFclasses

目录下的default_views.properties复制一份，重命名为mydefault_views.properties。修改里面的内容，将所有里面的路径中的default改成mydefault。然后修改WEB-INF下的cas.properties将里面的cas.viewResolver.basename后面的值修改成mydefault_views即：

cas.viewResolver.basename=mydefault_views

如果要修改登录界面，只需要修改casLoginView.jsp即可。

第五节：单点登出配置

第一步：配置单点登录监听器和过滤器

1.Tomcat的sso1,sso2的工程里，在web.xml里分别添加一下代码：

org.jasig.cas.client.session.SingleSignOutHttpSessionListener

CAS Single Sign Out Filter

org.jasig.cas.client.session.SingleSignOutFilter

CAS Single Sign Out Filter

/*

注意：这些代码应该放在web.xml文件其他过滤器的最前面。

2.在sso1,sso2的index.jsp页面添加以下代码：

http://jeesz.cn:8080/logout">单点退出

3.重启Tomcat，访问http://jeesz.cn:8080/点击单点退出，如果成功，就会出现如下界面：

一般注销是跳到原项目的登录页面，所以我们需要对CAS做如下配置：

1. 修改服务端cas-servlet.xml配置（apache-tomcat-7.0.40casROOTWEB-INF），找到

增加属性 p:followServiceRedirects="true"

2.修改客户端，sso1,sso2 index.jsp文件将原来的单点登出的URL修改成：

Sso1:http://jeesz.cn:8080/logout?service=http://www.sso1.com:8080

Sso2:http://jeesz.cn:8080/logout?service=http://www.sso2.com:8080

重启Tomcat，测试正常。

第六节：多项目集成单点登录配置

第一步：单点登录系统与其他项目集成

在WEB 项目中的WEB-INF目录下的web.xml文件，添加以下配置.

org.jasig.cas.client.session.SingleSignOutHttpSessionListener

SingleSignOutFilter

org.jasig.cas.client.session.SingleSignOutFilter

SingleSignOutFilter

/*

CASValidationFilter

org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter

casServerUrlPrefix

https://jeesz.cn:8443/cas;

serverName

http://www.sso3.com:6060;

useSession

true

exceptionOnValidationFailure

false

redirectAfterValidation

true

CASValidationFilter

/*

CASFilter

org.jasig.cas.client.authentication.AuthenticationFilter

casServerLoginUrl

https://jeesz.cn:8443/cas/login;

serverName

http:// www.sso3.com:6060

CASFilter

/*

CASHttpServletRequestWrapperFilter

org.jasig.cas.client.util.HttpServletRequestWrapperFilter

CASHttpServletRequestWrapperFilter

/*

CASAssertionThreadLocalFilter

org.jasig.cas.client.util.AssertionThreadLocalFilter

CASAssertionThreadLocalFilter

/*

SSO4InvokeContextFilter

com.common.web.filter.SSO4InvokeContextFilter

SSO4InvokeContextFilter

/*

当sso验证完成之后，客户端系统需要接收sso系统返回的结果时，需要定义一个过滤器获取返回结果，然后针对返回结果做相关处理.

注意：如果不需要做处理时，此处Filter也可以不用定义.

package com.common.web.filter;

import java.io.IOException;

import java.util.Date;

import javax.servlet.Filter;

import javax.servlet.FilterChain;

import javax.servlet.FilterConfig;

import javax.servlet.ServletException;

import javax.servlet.ServletRequest;

import javax.servlet.ServletResponse;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import javax.servlet.http.HttpSession;

import org.apache.commons.logging.Log;

import org.apache.commons.logging.LogFactory;

import org.jasig.cas.client.util.AssertionHolder;

import org.springframework.web.context.WebApplicationContext;

import org.springframework.web.context.support.WebApplicationContextUtils;

import com.common.base.pbi.CommonConstants;

import com.common.base.util.DateUtil;

import com.common.base.util.IDUtil;

import com.common.base.util.IPUtil;

import com.common.base.util.UserUtil;

import com.common.core.busi.historylogin.manager.HistoryLoginManager;

import com.common.core.busi.login.manager.LoginManager;

import com.common.entity.common.AbstractEntity;

import com.common.entity.historylogin.HistoryLoginEntity;

import com.common.entity.user.UserEntity;

/**

• 当成功登录SSO系统时将会返回登录的userid根据此userid建立session会话;
• @ClassName: SessionFilter
• @Description: TODO(这里用一句话描述这个类的作用)

*@authorjeesz

*@date2015-10-01

*

*/

public class SSO4InvokeContextFilter implements Filter{

private final static Log log = LogFactory.getLog(SSO4InvokeContextFilter.class);

private WebApplicationContext applicationContext;

public SSO4InvokeContextFilter() {

super();

}

/**

• 过滤器注销时，触发此方法;

*/

public void destroy() {

//暂时不做任何处理;

}

/**

• 根据用户id获取用户信息并且把用户信息放入session会话中;

*@Title: doFilter

• @Description: TODO(这里用一句话描述这个方法的作用)
• @Params
• @throws

*/

public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException {

HttpServletRequest request = (HttpServletRequest)req;

HttpServletResponse response = (HttpServletResponse)res;

HttpSession session = request.getSession();

//从session中获取登陆用户;

Object userObject = session.getAttribute(CommonConstants.USER_INFO_SESSION);

if(userObject == null){

//获取用户名;

String userName = AssertionHolder.getAssertion().getPrincipal().getName();

LoginManager loginManager = applicationContext.getBean(LoginManager.class);

UserEntity userEntity = loginManager.loginByUserName(userName);

session.setAttribute(CommonConstants.USER_INFO_SESSION,userEntity);

session.setAttribute(CommonConstants.IS_SYSTEM_ADMIN,userEntity.getUserType()==1?true:false);

UserUtil.setLoginUserInfo(userEntity);

//根据用户名查询出用户信息，并放入session中;

log.info("UserName:["+userName +"]登陆成功，客户端IP地址为["+IPUtil.getIpAddr(request)+"]，登陆时间为["+DateUtil.dateToString(new Date())+"]");

//添加登录记录;

HistoryLoginEntity historyLoginEntity = new HistoryLoginEntity();

historyLoginEntity.setUserId(userName);

historyLoginEntity.setHid(IDUtil.generateId());

historyLoginEntity.setLoginCount("1");

setCommonValue(request,historyLoginEntity);

boolean hlBol = applicationContext.getBean(HistoryLoginManager.class).addLoginRecord(historyLoginEntity);

log.debug("登录历史记录["+(hlBol?"成功":"失败")+"].");

}

chain.doFilter(request, response);

}

/**

• 设置公共属性;
• @Title: setCommonValue
• @Description: TODO(这里用一句话描述这个方法的作用)
• @throws

*/

private void setCommonValue(HttpServletRequest request,AbstractEntity entity){

if(request != null){

//获取当前对象;

UserEntity userEntity = (UserEntity) request.getSession().getAttribute(CommonConstants.USER_INFO_SESSION);

if(entity !=null){

String currUser = userEntity.getUserId();

//设置创建人、创建日期、修改人、修改时间

entity.setCreatedBy(currUser);

entity.setModifiedBy(currUser);

entity.setCreationDate(DateUtil.getNowDate());

entity.setModifiedDate(DateUtil.getNowDate());

}

}

}

/**

• 初始化Spring上下文;

*/

@Override

public void init(FilterConfig filterConfig) throws ServletException {

WebApplicationContext applicationContext = WebApplicationContextUtils.getWebApplicationContext(filterConfig.getServletContext());

this.applicationContext = applicationContext;

}

}