JEESZ分布式框架--單點登錄集成方案

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:\Windows\System32\drivers\etc\hosts文件中映射一個虛擬域名，

注意不要寫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

2.?? ?解壓cas-server-3.5.0-release.zip文件，

在cas-server-3.5.0-release\cas-server-3.5.0\modules目錄下找到cas-server-webapp-3.5.0.war文件并命名為cas.war，并復制到在Tomcat 根目錄的webapps目錄下，


如下圖：

3.?? ?修改host文件（C:\Windows\System32\drivers\etc）hosts文件中添加添加以下配置

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

注意：如果想在一臺PC機上模擬這個單點登錄，就必須域名重定向，如果是多臺ＰＣ機，可以不配置此項，下文有用到jeesz.cn，可以用相應ＰＣ機的ＩＰ代替

4.?? ?修改Tomcat文件下的server.xml(apache-tomcat-7.0.40\conf\server.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.2\webapps\cas\WEB-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.2\webapps\cas\WEB-INF\lib目錄下。

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目錄。如下如：


3. 在自己的Web工程里加入cas-client-core.jar，commons-logging-1.1.jar，（解壓cas-client-3.2.0-release.zip，在cas-client-3.2.0-release.zip\cas-client-3.2.0\modules，找到該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.40\cas\ROOT\WEB-INF\spring-configuration。找到p:cookieSecure="true"，將其修改為p:cookieSecure="false"，重啟Tomcat，測試一下。

注：我們以上步驟返回的只有一個用戶名，CAS服務器默認返回該信息。

第是節：修改單點登錄默認界面

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

打開cas工程，找到G:\SoftWare\tomcat\apache-tomcat-7.0.2\apache-tomcat-7.0.2\webapps\cas\WEB-INF\view\jsp\default這個目錄，將其復制一份重命名放在G:\SoftWare\tomcat\apache-tomcat-7.0.2\apache-tomcat-7.0.2\webapps\cas\WEB-INF\view\jsp\目錄下，

第二步：修改默認登錄頁面

將其命名為mydefalut如下圖：


然后將apache-tomcat-7.0.2\webapps\cas\WEB-INF\classes

目錄下的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.40\cas\ROOT\WEB-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;

}

}

歡迎大家一起學習研究相關技術

愿意了解框架技術或者源碼的朋友直接求求交流分享技術：2042849237

更多詳細源碼參考來源：http://minglisoft.cn/technology

最后編輯于 ：
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發布，文章內容僅代表作者本人觀點，簡書系信息發布平臺，僅提供信息存儲服務。

推薦閱讀更多精彩內容