摘要: 第一節(jié):?jiǎn)吸c(diǎn)登錄簡(jiǎn)介 第一步:了解單點(diǎn)登錄 SSO主要特點(diǎn)是:
SSO應(yīng)用之間使用Web協(xié)議(如HTTPS) 汤徽,并且只有一個(gè)登錄入口. SSO的體系中有下面三種角色: 1) User(多個(gè)) 2)
Web應(yīng)用(多個(gè)) 3) SSO認(rèn)證中心(一個(gè)) SSO實(shí)現(xiàn)包含以下三個(gè)原則: 1) 所有的登錄都在 SSO 認(rèn)證中心進(jìn)行蚜点。
JEESZ分布式框架單點(diǎn)登錄集成方案
第一節(jié):?jiǎn)吸c(diǎn)登錄簡(jiǎn)介
第一步:了解單點(diǎn)登錄
SSO主要特點(diǎn)是: SSO應(yīng)用之間使用Web協(xié)議(如HTTPS) 搞动,并且只有一個(gè)登錄入口.
SSO的體系中有下面三種角色:
1) User(多個(gè))
2) Web應(yīng)用(多個(gè))
3) SSO認(rèn)證中心(一個(gè))
SSO實(shí)現(xiàn)包含以下三個(gè)原則:
1) 所有的登錄都在 SSO 認(rèn)證中心進(jìn)行怒炸。
2) SSO認(rèn)證中心通過(guò)一些方法來(lái)告訴Web應(yīng)用當(dāng)前訪(fǎng)問(wèn)用戶(hù)究竟是不是通過(guò)認(rèn)證的用戶(hù).
3) SSO認(rèn)證中心和所有的 Web 應(yīng)用建立一種信任關(guān)系.
CAS的基本原理CAS(Central Authentication Service) 是 Yale 耶魯大學(xué)發(fā)起的構(gòu)建Web SSO的Java開(kāi)源項(xiàng)目赌躺。
1.CAS術(shù)語(yǔ)解釋:
SSO-Single Sign On單點(diǎn)登錄
TGT-Ticket Granting Ticket 用戶(hù)身份認(rèn)證憑證
ST-Service Ticket服務(wù)許可憑證
TGC-Ticket Granting Cookie存放用戶(hù)身份認(rèn)證憑證的cookie.
第二步:了解單點(diǎn)登錄體系結(jié)構(gòu)
1)?? ?CAS Server負(fù)責(zé)完成對(duì)用戶(hù)信息的認(rèn)證县忌,需要單獨(dú)部署筷畦,CAS Server會(huì)處理用戶(hù)名/密碼等憑證(Credentials).
2)?? ? CAS Client部署在客戶(hù)端,當(dāng)有對(duì)本地Web應(yīng)用受保護(hù)資源的訪(fǎng)問(wèn)請(qǐng)求黍判,并且需要對(duì)請(qǐng)求方進(jìn)行身份認(rèn)證豫尽,重定向到CAS Server進(jìn)行認(rèn)證.
第三步:?jiǎn)吸c(diǎn)登錄環(huán)境準(zhǔn)備工作
1)?? ?cas-server-3.5.0-release.zip(CAS服務(wù)端)
2)?? ?cas-client-3.3.3-release.zip(CAS客戶(hù)端)
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
第二節(jié):?jiǎn)吸c(diǎn)登錄環(huán)境搭建與部署
第一步:環(huán)境部署
1.?? ?通過(guò)Java JDK生成證書(shū)三部曲
證書(shū)對(duì)于實(shí)現(xiàn)此單點(diǎn)登錄非常之重要,證書(shū)是服務(wù)器端和客戶(hù)端安全通信的憑證顷帖,本教程只是演示美旧,所有用了JDK自帶的證書(shū)生成工具keytool渤滞。
當(dāng)然在實(shí)際項(xiàng)目中你可以到專(zhuān)門(mén)的證書(shū)認(rèn)證中心購(gòu)買(mǎi)證書(shū)。
中文官方網(wǎng)站:http://www.verisign.com/cn/
使用JDK自帶的keytool生成證書(shū)
第一步生成證書(shū):
keytool -genkey -alias mycacerts -keyalg RSA -keystore C:/common/keys/keycard
注意:輸入相關(guān)信息用于生成證書(shū).其中名字與姓氏這一最好寫(xiě)你的 域名榴嗅,如果在單擊測(cè)試你可以在C:\Windows\System32\drivers\etc\hosts文件中映射一個(gè)虛擬域名妄呕,
注意不要寫(xiě)IP。
第二步導(dǎo)出證書(shū):
keytool -export -file C:/common/keys/keycard.crt -alias mycacerts -keystore C:/common/keys/keycard
第三步導(dǎo)入到JDK安裝目錄證書(shū):
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绪励,并復(fù)制到在Tomcat 根目錄的webapps目錄下,
如下圖:
3.?? ?修改host文件(C:\Windows\System32\drivers\etc)hosts文件中添加添加以下配置
127.0.0.1???????? jeesz.cn (配置自己的域名.)
注意:如果想在一臺(tái)PC機(jī)上模擬這個(gè)單點(diǎn)登錄唠粥,就必須域名重定向疏魏,如果是多臺(tái)PC機(jī),可以不配置此項(xiàng)厅贪,下文有用到j(luò)eesz.cn蠢护,可以用相應(yīng)PC機(jī)的IP代替
4.?? ?修改Tomcat文件下的server.xml(apache-tomcat-7.0.40\conf\server.xml) 添加以下內(nèi)容:
在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.啟動(dòng)Tomcat服務(wù),查看信息养涮,(如果有報(bào)錯(cuò)葵硕,可以根據(jù)信息查找錯(cuò)誤),打開(kāi)瀏覽器贯吓,輸入http://jeesz.cn:8080/cas如果出現(xiàn)以下界面懈凹,則代表CAS服務(wù)端配置成功。
注:這個(gè)是最簡(jiǎn)單的CAS服務(wù)悄谐,只要輸入的用戶(hù)名跟密碼一樣介评,就可以正常登陸,在我們實(shí)際開(kāi)發(fā)中爬舰,這個(gè)驗(yàn)證因?yàn)楦鷶?shù)據(jù)庫(kù)作比較们陆,接下來(lái),我們就配置數(shù)據(jù)庫(kù)校驗(yàn)情屹。
第二步:配置數(shù)據(jù)庫(kù)驗(yàn)證
1.在apache-tomcat-7.0.2\webapps\cas\WEB-INF目錄下找到deployerConfigContext.xml文件坪仇,找到如下代碼:
添加下面代碼:
2.增加數(shù)據(jù)源dataSource,
在deployerConfigContext.xml垃你,(跟上面同一個(gè)文件)找到
椅文,在下面添加如下代碼:
com.mysql.jdbc.Driver
jdbc:mysql://127.0.0.1:3306/sso
root
3.數(shù)據(jù)庫(kù)添加用戶(hù)表及數(shù)據(jù)(這里用的mysql),比如在mysql數(shù)據(jù)庫(kù)中有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凌摄,打開(kāi)瀏覽器羡蛾,輸入http://jeesz.cn:8080/,輸入數(shù)據(jù)庫(kù)里的用戶(hù)名和密碼锨亏,如果出現(xiàn)如下界面林说,則配置成功煎殷。
現(xiàn)在我們的CAS服務(wù)端已經(jīng)配置好了,接下來(lái)腿箩,我們配置客戶(hù)端
第三節(jié):配置自己的Web工程(客戶(hù)端)
1.在host文件下,添加如下代碼:
127.0.0.1????????? www.sso1.com
127.0.0.1????????? www.sso2.com
注意:這個(gè)網(wǎng)址最好不要用互聯(lián)網(wǎng)已經(jīng)存在的域名劣摇,否則你將無(wú)法訪(fǎng)問(wèn)該地址珠移。
如果想在一臺(tái)PC機(jī)上模擬這個(gè)單點(diǎn)登錄,就必須域名重定向末融,如果是多臺(tái)PC機(jī)钧惧,可以不配置此項(xiàng),下文有用到www.sso1.com勾习,www.sso2.com浓瞪,可以用相應(yīng)PC機(jī)的IP代替
2.在Tomcat 根目錄下創(chuàng)建一個(gè)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
serverName
useSession
true
exceptionOnValidationFailure
false
redirectAfterValidation
true
CASValidationFilter
/*
CASFilter
org.jasig.cas.client.authentication.AuthenticationFilter
casServerLoginUrl
https://jeesz.cn:8443/cas/login;
serverName
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
serverName
useSession
true
exceptionOnValidationFailure
false
redirectAfterValidation
true
CASValidationFilter
/*
CASFilter
org.jasig.cas.client.authentication.AuthenticationFilter
casServerLoginUrl
https://jeesz.cn:8443/cas/login;
serverName
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頁(yè)面,復(fù)制如下代碼:
sso1 index.jsp:
這個(gè)是www.sso1.com
你好我是sso1頁(yè)面:
<%= request.getRemoteUser()== null ? "null" : request.getRemoteUser() %>
Sso2 index.jsp:
這個(gè)是www.sso2.com
你好我是sso2頁(yè)面:
<%= request.getRemoteUser()== null ? "null" : request.getRemoteUser() %>
7.通過(guò)eclipse發(fā)布到Tomcat服務(wù)器上去诅妹。找到Tomcat,webapps下的sso1,sso2文件夾毅人,分別復(fù)制sso1和sso2下面的所有文件吭狡,找到Tomcat根目錄下的sso1,sso2(就是我們前面步驟新建的目錄),在sso1,sso2下新建ROOT目錄丈莺,把剛剛復(fù)制的文件粘貼划煮。
配置Tomcat 下server.xml文件,加入如下代碼:
8.重啟Tomcat场刑,打開(kāi)瀏覽器輸入網(wǎng)址:www.sso1.com:8080般此,輸入用戶(hù)名與密碼,如果出現(xiàn)以下信息牵现,則成功
在瀏覽器上輸入www.sso1.com:8080铐懊,你會(huì)發(fā)現(xiàn)跳回到登錄頁(yè)面,不要擔(dān)心瞎疼。打開(kāi)ticketGrantingTicketCookieGenerator.xml路徑在apache-tomcat-7.0.40\cas\ROOT\WEB-INF\spring-configuration科乎。找到p:cookieSecure="true",將其修改為p:cookieSecure="false"贼急,重啟Tomcat茅茂,測(cè)試一下捏萍。
注:我們以上步驟返回的只有一個(gè)用戶(hù)名,CAS服務(wù)器默認(rèn)返回該信息空闲。
第是節(jié):修改單點(diǎn)登錄默認(rèn)界面
第一步:找到它自己的頁(yè)面
打開(kāi)cas工程令杈,找到G:\SoftWare\tomcat\apache-tomcat-7.0.2\apache-tomcat-7.0.2\webapps\cas\WEB-INF\view\jsp\default這個(gè)目錄,將其復(fù)制一份重命名放在G:\SoftWare\tomcat\apache-tomcat-7.0.2\apache-tomcat-7.0.2\webapps\cas\WEB-INF\view\jsp\目錄下碴倾,
第二步:修改默認(rèn)登錄頁(yè)面
將其命名為mydefalut如下圖:
然后將apache-tomcat-7.0.2\webapps\cas\WEB-INF\classes
目錄下的default_views.properties復(fù)制一份逗噩,重命名為mydefault_views.properties。修改里面的內(nèi)容跌榔,將所有里面的路徑中的default改成mydefault异雁。然后修改WEB-INF下的cas.properties將里面的cas.viewResolver.basename后面的值修改成mydefault_views即:
cas.viewResolver.basename=mydefault_views
如果要修改登錄界面,只需要修改casLoginView.jsp即可僧须。
第五節(jié):?jiǎn)吸c(diǎn)登出配置
第一步:配置單點(diǎn)登錄監(jiān)聽(tīng)器和過(guò)濾器
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
/*
注意:這些代碼應(yīng)該放在web.xml文件其他過(guò)濾器的最前面。
2.在sso1,sso2的index.jsp頁(yè)面添加以下代碼:
http://jeesz.cn:8080/logout">單點(diǎn)退出
3.重啟Tomcat担平,訪(fǎng)問(wèn)http://jeesz.cn:8080/點(diǎn)擊單點(diǎn)退出示绊,如果成功,就會(huì)出現(xiàn)如下界面:
一般注銷(xiāo)是跳到原項(xiàng)目的登錄頁(yè)面驱闷,所以我們需要對(duì)CAS做如下配置:
1.?? ?修改服務(wù)端cas-servlet.xml配置(apache-tomcat-7.0.40\cas\ROOT\WEB-INF)耻台,找到
增加屬性 p:followServiceRedirects="true"
2.修改客戶(hù)端,sso1,sso2 index.jsp文件將原來(lái)的單點(diǎn)登出的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空另,測(cè)試正常盆耽。
第六節(jié):多項(xiàng)目集成單點(diǎn)登錄配置
第一步:?jiǎn)吸c(diǎn)登錄系統(tǒng)與其他項(xiàng)目集成
在WEB 項(xiàng)目中的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
serverName
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
/*
當(dāng)sso驗(yàn)證完成之后扼菠,客戶(hù)端系統(tǒng)需要接收sso系統(tǒng)返回的結(jié)果時(shí)摄杂,需要定義一個(gè)過(guò)濾器獲取返回結(jié)果,然后針對(duì)返回結(jié)果做相關(guān)處理.
注意:如果不需要做處理時(shí)循榆,此處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;
/**
* 當(dāng)成功登錄SSO系統(tǒng)時(shí)將會(huì)返回登錄的userid根據(jù)此userid建立session會(huì)話(huà);
*@ClassName: SessionFilter
* @Description: TODO(這里用一句話(huà)描述這個(gè)類(lèi)的作用)
*@authorjeesz
*@date2015-10-01
*
*/
public class SSO4InvokeContextFilter implements Filter{
private final static Log log = LogFactory.getLog(SSO4InvokeContextFilter.class);
private WebApplicationContext applicationContext;
public SSO4InvokeContextFilter() {
super();
}
/**
* 過(guò)濾器注銷(xiāo)時(shí)析恢,觸發(fā)此方法;
*/
public void destroy() {
//暫時(shí)不做任何處理;
}
/**
* 根據(jù)用戶(hù)id獲取用戶(hù)信息并且把用戶(hù)信息放入session會(huì)話(huà)中;
*@Title: doFilter
* @Description: TODO(這里用一句話(huà)描述這個(gè)方法的作用)
* @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中獲取登陸用戶(hù);
Object userObject = session.getAttribute(CommonConstants.USER_INFO_SESSION);
if(userObject == null){
//獲取用戶(hù)名;
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);
//根據(jù)用戶(hù)名查詢(xún)出用戶(hù)信息,并放入session中;
log.info("UserName:["+userName +"]登陸成功秧饮,客戶(hù)端IP地址為["+IPUtil.getIpAddr(request)+"]映挂,登陸時(shí)間為["+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);
}
/**
* 設(shè)置公共屬性;
* @Title: setCommonValue
* @Description: TODO(這里用一句話(huà)描述這個(gè)方法的作用)
* @throws
*/
private void setCommonValue(HttpServletRequest request,AbstractEntity entity){
if(request != null){
//獲取當(dāng)前對(duì)象;
UserEntity userEntity = (UserEntity) request.getSession().getAttribute(CommonConstants.USER_INFO_SESSION);
if(entity !=null){
String currUser = userEntity.getUserId();
//設(shè)置創(chuàng)建人、創(chuàng)建日期盗尸、修改人柑船、修改時(shí)間
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;
}
}
歡迎大家一起學(xué)習(xí)研究相關(guān)技術(shù)
愿意了解框架技術(shù)或者源碼的朋友直接求求交流分享技術(shù):2042849237
更多詳細(xì)源碼參考來(lái)源:http://minglisoft.cn/technology