通用門戶系統(tǒng)技術(shù)方案V11

1、通用門戶系統(tǒng)技術(shù)方案一概述1門戶系統(tǒng)基本建設(shè)內(nèi)容1）實(shí)現(xiàn)統(tǒng)一用戶身份認(rèn)證服務(wù)；2）實(shí)現(xiàn)單點(diǎn)登錄服務(wù)；3）實(shí)現(xiàn)微服務(wù)應(yīng)用集成功能；4）實(shí)現(xiàn)統(tǒng)一權(quán)限管理；5）實(shí)現(xiàn)靈活的門戶自定義功能；6）實(shí)現(xiàn)統(tǒng)一待辦功能；2門戶系統(tǒng)改造建設(shè)的主要目標(biāo)1）提供統(tǒng)一的、便捷的信息入口；2）將不同角色所需要的信息主動(dòng)推送給他們，提高信息傳送的效率；3）結(jié)合統(tǒng)一身份認(rèn)證，實(shí)現(xiàn)單點(diǎn)登錄，并加強(qiáng)權(quán)限控制，提高信息傳送過(guò) 程的安全性；4）以微服務(wù)的形式集成不同應(yīng)用系統(tǒng)的信息、頁(yè)面，并提供良好的擴(kuò)展性， 適應(yīng)未來(lái)的不斷發(fā)展。二系統(tǒng)總體架構(gòu)戶一范門統(tǒng)規(guī)祇憲注研統(tǒng)行護(hù)臺(tái)系運(yùn)維平耕一接二1:整慕嫉A(chǔ)力頁(yè)源* 外字*博時(shí)辦卷戶一范門統(tǒng)規(guī)

2、祇憲注研統(tǒng)行護(hù)臺(tái)系運(yùn)維平耕一接二1:整慕嫉A(chǔ)力頁(yè)源* 外字*博時(shí)辦卷.1服務(wù)提供層服務(wù)提供層是由各業(yè)務(wù)系統(tǒng)按照門戶系統(tǒng)的統(tǒng)一規(guī)范提供的各類微服務(wù)，諸 如信息查詢、信息統(tǒng)計(jì)、待辦事項(xiàng)、單點(diǎn)登錄等等。2統(tǒng)一接口層統(tǒng)一接口層指門戶系統(tǒng)提供的底層接口實(shí)現(xiàn)，包括統(tǒng)一用戶身份認(rèn)證相關(guān)接 口、單點(diǎn)登錄、單點(diǎn)登出、統(tǒng)一待辦接口、統(tǒng)一權(quán)限等。各業(yè)務(wù)系統(tǒng)提供的微服 務(wù)將調(diào)用門戶系統(tǒng)提供的底層接口來(lái)實(shí)現(xiàn)同門戶系統(tǒng)的集成。3服務(wù)管理層對(duì)于所有微服務(wù)進(jìn)行管理，包括服務(wù)的注冊(cè)、服務(wù)銷毀、服務(wù)檢測(cè)、服務(wù)設(shè) 置、服務(wù)發(fā)布等功能。對(duì)于已經(jīng)注冊(cè)、通過(guò)檢測(cè)并已經(jīng)發(fā)布的服務(wù)，才可以提供 給門戶管理層進(jìn)行調(diào)用。4門戶管理層門戶管理層是

3、門戶系統(tǒng)中對(duì)外展現(xiàn)的核心功能，包括門戶管理、頁(yè)面管理、 頁(yè)面布局管理、組件管理、導(dǎo)航管理等內(nèi)容。門戶中各組件的關(guān)系如下圖：5門戶展現(xiàn)層門戶展現(xiàn)層是最終提供給普通用戶使用的門戶系統(tǒng)，根據(jù)用戶權(quán)限展現(xiàn)其可 以進(jìn)入的門戶。6系統(tǒng)運(yùn)行維護(hù)層系統(tǒng)運(yùn)行維護(hù)層是門戶系統(tǒng)基礎(chǔ)的功能，主要包括日志管理、用戶同步、數(shù) 據(jù)源監(jiān)控、數(shù)據(jù)字典、基礎(chǔ)設(shè)置等。7門戶統(tǒng)一規(guī)范門戶系統(tǒng)統(tǒng)一規(guī)范是保障門戶系統(tǒng)可擴(kuò)展性的基礎(chǔ)，未來(lái)需要接入門戶的各 業(yè)務(wù)系統(tǒng)只需要按照統(tǒng)一的規(guī)范將能夠輕松的完成同門戶系統(tǒng)的集成工作。主要 包括：1）單點(diǎn)登錄接口及流程規(guī)范；2）統(tǒng)一用戶認(rèn)證接口及流程規(guī)范；3）微服務(wù)實(shí)現(xiàn)規(guī)范；4）統(tǒng)一消息接口規(guī)范；5）統(tǒng)

4、一待辦接口規(guī)范；三技術(shù)路線1微服務(wù)管理：SpringCloud1.1 SpringCloud微服務(wù)管理的系統(tǒng)架構(gòu)1.2服務(wù)注冊(cè)與發(fā)現(xiàn)：Eureka集群1.2服務(wù)注冊(cè)與發(fā)現(xiàn)：Eureka集群MufawKtf目前SpringCloud支持的服務(wù)注冊(cè)有Consul和EurekaConsul需要獨(dú)立部署， 脫離Spring框架；而Eureka天然集成在SpringCloud中，本身就是一個(gè)SpringBoot 項(xiàng)目。Consul在整體功能上比Eureka更加豐富和完備，但同時(shí)也增加了一定的 復(fù)雜性；Eureka相對(duì)來(lái)說(shuō)更加輕量，天然溶于SpringCloud體系，對(duì)于一般性的 微服務(wù)集群來(lái)說(shuō)已經(jīng)足夠。

5、因此，我們采用了 Eureka來(lái)作為服務(wù)發(fā)現(xiàn)與注冊(cè)組 件。1.3統(tǒng)一接入網(wǎng)關(guān)：Zuul統(tǒng)一接入網(wǎng)關(guān)組件作為服務(wù)的統(tǒng)一入口，地位足夠重要。Zuul網(wǎng)關(guān)主要實(shí)現(xiàn) 了請(qǐng)求服務(wù)路由、負(fù)載均衡、統(tǒng)一校驗(yàn)等功能。在服務(wù)路由和負(fù)載均衡方面，和nginx相當(dāng)類似。Zuul通過(guò)自身注冊(cè)到Eureka，通過(guò)url匹配的servicelD配置， 即可實(shí)現(xiàn)服務(wù)路由。1.4服務(wù)RPC調(diào)用:FeignFeign是一種http方式的聲明式調(diào)用，目前SpringCloud默認(rèn)使用java原生 的HttpURLConnection進(jìn)行http調(diào)用，同時(shí)通過(guò)jar包引入還可以支持Apache的 httpclient、OKhttp

6、等。Feign底層依靠Ribbon實(shí)現(xiàn)了調(diào)用各個(gè)實(shí)例的負(fù)載均衡， 從簡(jiǎn)單易用上面來(lái)看絕對(duì)是一個(gè)重要的亮點(diǎn)；而且和自動(dòng)熔斷降級(jí)組件Hystrix 天熱融合，優(yōu)勢(shì)明顯。2用戶統(tǒng)一授權(quán)協(xié)議技術(shù)：Auth2.0OAuth協(xié)議，是一種授權(quán)協(xié)議，目前已經(jīng)逐漸成為單點(diǎn)登錄（SSO）和用戶 授權(quán)的標(biāo)準(zhǔn)。2.1 OAuth的運(yùn)行流程|- -(A;- Authorization Request Resourceowns r Authorization Grant -II二二二二二 (C) Authorion Grant - Author i.zationClientserver Access Token (E)A

7、ccess Token ResourceSet vei-(F)-(F) Protected Resource（A）用戶打開(kāi)客戶端以后，客戶端要求用戶給予授權(quán)。（B）用戶同意給予客戶端授權(quán)。（C）客戶端使用上一步獲得的授權(quán)，向認(rèn)證服務(wù)器申請(qǐng)令牌。（D）認(rèn)證服務(wù)器對(duì)客戶端進(jìn)行認(rèn)證以后，確認(rèn)無(wú)誤，同意發(fā)放令牌。（E）客戶端使用令牌，向資源服務(wù)器申請(qǐng)獲取資源。（F）資源服務(wù)器確認(rèn)令牌無(wú)誤，同意向客戶端開(kāi)放資源。2.2 OAuth的四種授權(quán)模式1）授權(quán)碼模式（a）用戶訪問(wèn)客戶端，后者將前者導(dǎo)向認(rèn)證服務(wù)器，假設(shè)用戶給予授權(quán)， 認(rèn)證服務(wù)器將用戶導(dǎo)向客戶端事先指定的重定向URI（redirection URI

8、）， 同時(shí)附上一個(gè)授權(quán)碼。（b）客戶端收到授權(quán)碼，附上早先的,重定向URI，向認(rèn)證服務(wù)器申請(qǐng)令牌： GET /oauth/token?response_type=code&client_id=test&redirect_uri=M 向頁(yè)面鏈接。請(qǐng)求成功返回code授權(quán)碼，一般有效時(shí)間是10分鐘。（c）認(rèn)證服務(wù)器核對(duì)了授權(quán)碼和重定向URI，確認(rèn)無(wú)誤后，向客戶端發(fā)送 訪 問(wèn) 令牌（access token）和更 新令牌（refresh token）。POST /oauth/token?response_type=authorization_code&code=SplxlOBeZQQYbY S6Wx

9、SbIA&redirect_uri=重定向頁(yè)面鏈接。請(qǐng)求成功返回access Token和 refresh Token。2）簡(jiǎn)化模式適用于公開(kāi)的瀏覽器單頁(yè)應(yīng)用，Access Token直接從授權(quán)服務(wù)器返回（只有前 端渠道），安全性較低，不建議采用。3）用戶名密碼模式使用用戶名密碼登錄的應(yīng)用，登錄成功后從授權(quán)服務(wù)器上獲取access token， 資源擁有者從認(rèn)證服務(wù)器認(rèn)證access token是否有效，確認(rèn)無(wú)誤予以放行。4）客戶端憑證適用于服務(wù)器見(jiàn)通信場(chǎng)景，機(jī)密客戶代表它自己或者一個(gè)用戶，只有后端渠 道，使用客戶憑證獲取一個(gè)access token，因?yàn)榭蛻魬{證可以使用對(duì)稱或者非對(duì) 稱加密，

10、該方式支持共享密碼或者證書。3Portal 及 Portlet 技術(shù)Portal是指門戶應(yīng)用，作為門戶系統(tǒng)的基礎(chǔ)容器，Portal為頁(yè)面提供運(yùn)行環(huán) 境，包括調(diào)用頁(yè)面地址、布局展現(xiàn)、portlet調(diào)用、銷毀等功能。Portlet是在門戶中運(yùn)行的Web頁(yè)面的一部分，從最終用戶的角度看，Portlet 是一個(gè)能夠在Web頁(yè)面顯示出來(lái)的工作區(qū)域。每個(gè)Portlet將管理瀏覽器屏幕 的一小部分，為您執(zhí)行一項(xiàng)服務(wù)。所有的Portlet都將檢索來(lái)自數(shù)據(jù)庫(kù)或其他來(lái) 源的信息、轉(zhuǎn)換這些信息，并將這些信息顯示到瀏覽器屏幕上;從開(kāi)發(fā)者角度看， Portlet是采用J2EE技術(shù)開(kāi)發(fā)的并且運(yùn)行在門戶頁(yè)面中的Portle

11、t容器(Container) 中的插件；Portlet則通過(guò)Portal的應(yīng)用來(lái)調(diào)用。Portlet只有在生成了適合在大頁(yè) 面中顯示的內(nèi)容之后，才會(huì)在Portal環(huán)境中適當(dāng)運(yùn)行，一個(gè)Portal頁(yè)面是一系列 Portlet的集合。模型，為Portlet檢索的數(shù)據(jù)源，該數(shù)據(jù)源可能是本地的也可能是遠(yuǎn)程的， 這些數(shù)據(jù)源可能來(lái)自于其它的數(shù)據(jù)庫(kù)、微服務(wù)，也可能是另外的遠(yuǎn)程Web站點(diǎn)； 將Web信息劃分為頁(yè)面，每個(gè)頁(yè)面包含一系列子頁(yè)面，每個(gè)子條目包括標(biāo)題、 標(biāo)題的描述以及該標(biāo)題文章在的鏈接。視圖，用于顯示Portlet數(shù)據(jù)的圖形顯示機(jī)制；Portlet 一般都支持多種設(shè)備 (瀏覽器)訪問(wèn)，設(shè)備可以是用HT

12、ML來(lái)支持使用桌面瀏覽器的PC。由于Portlet 采用MVC設(shè)計(jì)模式，業(yè)務(wù)邏輯層和表示層分離，一個(gè)業(yè)務(wù)層可以對(duì)應(yīng)多個(gè)視圖； 這樣，控制器可以依據(jù)設(shè)備調(diào)用相應(yīng)的視圖顯示。控制器，它連接選定的視圖到數(shù)據(jù)，并指導(dǎo)Portlet的操作?？刂破鞲鶕?jù)目 標(biāo)設(shè)備或?yàn)g覽器選擇要顯示的視圖，然后將數(shù)據(jù)模型傳遞給視圖。視圖抽取特定 的顯示數(shù)據(jù)，為瀏覽器格式化數(shù)據(jù)，然后將其輸出提供給瀏覽器，作為Portlet輸 出的門戶頁(yè)面聚集的一部分。四系統(tǒng)功能規(guī)劃1門戶管理1.1門戶管理門戶管理功能主要包括新增門戶、修改門戶、門戶設(shè)置、門戶發(fā)布、門戶禁 用、權(quán)限設(shè)置、門戶預(yù)覽等功能。其中門戶設(shè)置主要包括門戶標(biāo)題、門戶主頁(yè)面、

13、 是否必須登錄等等內(nèi)容。1.2頁(yè)面管理頁(yè)面管理主要對(duì)所有添加的頁(yè)面進(jìn)行管理，包括新增、修改、刪除頁(yè)面、頁(yè) 面布局設(shè)置、頁(yè)面組件設(shè)置、頁(yè)面導(dǎo)航設(shè)置、頁(yè)面頭設(shè)置、頁(yè)面底部設(shè)置，色彩 風(fēng)格設(shè)置、頁(yè)面權(quán)限設(shè)置等內(nèi)容。1.2組件管理組件是頁(yè)面構(gòu)成的基本元素，也是門戶系統(tǒng)的核心和基礎(chǔ)。組件管理主要包 括新建組件、編輯組件、組件類型管理、組件關(guān)聯(lián)微服務(wù)設(shè)置、組件個(gè)性化設(shè)置、 組件顯示代碼設(shè)置、組件權(quán)限設(shè)置等內(nèi)容。1.3導(dǎo)航管理導(dǎo)航是一種特殊的組件，主要用于將各個(gè)頁(yè)面鏈接起來(lái)。系統(tǒng)提供2-3種導(dǎo) 航風(fēng)格，用戶可以針對(duì)不同的門戶或頁(yè)面進(jìn)行導(dǎo)航的設(shè)置，以供頁(yè)面調(diào)用。主要 包括導(dǎo)航新增、導(dǎo)航編輯、導(dǎo)航啟用、導(dǎo)航刪除

14、等功能。1.4布局管理布局是針對(duì)頁(yè)面中各個(gè)組件的顯示位置的定義，系統(tǒng)內(nèi)置多套布局模版供用 戶使用。2門戶展現(xiàn)2.1統(tǒng)一登錄頁(yè)面門戶系統(tǒng)將提供一個(gè)統(tǒng)一登錄頁(yè)面，用于登錄門戶系統(tǒng)，之后可從門戶系統(tǒng) 單點(diǎn)登錄至各個(gè)業(yè)務(wù)系統(tǒng)中，各個(gè)業(yè)務(wù)系統(tǒng)無(wú)需再做單點(diǎn)的登錄頁(yè)面。注：各業(yè)務(wù)系統(tǒng)必須按照單點(diǎn)登錄接口規(guī)范實(shí)現(xiàn)單點(diǎn)登錄接口。2.2統(tǒng)一登出功能統(tǒng)一登出功能指用戶從門戶系統(tǒng)中登出，將同時(shí)從各個(gè)業(yè)務(wù)系統(tǒng)中同步登出。注：各業(yè)務(wù)系統(tǒng)必須按照單點(diǎn)登錄接口規(guī)范實(shí)現(xiàn)統(tǒng)一登出接口，才可實(shí)現(xiàn)此 功能。2.3門戶主頁(yè)門戶主頁(yè)是最終展現(xiàn)給用戶的界面。門戶主頁(yè)會(huì)根據(jù)用戶的各種設(shè)置及用戶 權(quán)限來(lái)展示最終的展現(xiàn)效果。3微服務(wù)管理3.1服

15、務(wù)列表展示已經(jīng)注冊(cè)到門戶系統(tǒng)中的所有微服務(wù)信息，包括所屬業(yè)務(wù)系統(tǒng)、服務(wù)地 址、服務(wù)狀態(tài)、服務(wù)說(shuō)明、是否被使用等信息。主要包括服務(wù)注冊(cè)、服務(wù)發(fā)布、 服務(wù)詳細(xì)信息查看、服務(wù)銷毀等功能。3.2服務(wù)注冊(cè)對(duì)業(yè)務(wù)系統(tǒng)提供的微服務(wù)，需要在門戶系統(tǒng)中進(jìn)行注冊(cè)，以便頁(yè)面中的組件 進(jìn)行調(diào)用。服務(wù)注冊(cè)的主要內(nèi)容包括，服務(wù)標(biāo)題、詳細(xì)說(shuō)明、接口地址、輸入?yún)?數(shù)及輸出參數(shù)說(shuō)明、服務(wù)類型（頁(yè)面展示服務(wù)、數(shù)據(jù)查詢服務(wù)、事務(wù)提交服務(wù)等）。服務(wù)注冊(cè)之后，系統(tǒng)會(huì)自動(dòng)對(duì)服務(wù)進(jìn)行可用性檢測(cè)，如未通過(guò)檢測(cè)，服務(wù)的 狀態(tài)將自動(dòng)變更為不可用狀態(tài)，否則為可用狀態(tài)。注：各業(yè)務(wù)系統(tǒng)需要安裝門戶系統(tǒng)的微服務(wù)實(shí)現(xiàn)規(guī)范進(jìn)行代碼編寫，以便和 門戶系統(tǒng)打通

16、用戶認(rèn)證、數(shù)據(jù)傳遞的問(wèn)題。3.3服務(wù)監(jiān)控服務(wù)監(jiān)控可以看各個(gè)注冊(cè)的微服務(wù)實(shí)例的運(yùn)行全貌，包括是否在運(yùn)行、jvm 狀態(tài)、調(diào)用次數(shù)和耗時(shí)等等情況。3.4服務(wù)銷毀對(duì)于不再使用的微服務(wù)，可以通過(guò)服務(wù)銷毀功能，從服務(wù)中心中刪除對(duì)應(yīng)的 服務(wù)。在服務(wù)銷毀時(shí)，系統(tǒng)自動(dòng)判斷是否有組件在使用該服務(wù)，如有組件使用， 則不能銷毀。4統(tǒng)一接口4.1統(tǒng)一用戶統(tǒng)一用戶包括組織架構(gòu)信息和用戶信息，數(shù)據(jù)來(lái)源為人力資源系統(tǒng)，門戶系 統(tǒng)將每日同人力資源系統(tǒng)通過(guò)接口的方式進(jìn)行數(shù)據(jù)同步。4.2統(tǒng)一身份驗(yàn)證統(tǒng)一身份驗(yàn)證包括用戶名密碼驗(yàn)證接口和令牌驗(yàn)證接口。門戶系統(tǒng)提供統(tǒng)一 身份驗(yàn)證接口接口及規(guī)范，以供業(yè)務(wù)系統(tǒng)對(duì)單點(diǎn)登錄的用戶的身份進(jìn)行校驗(yàn)。4.3單點(diǎn)登錄接口門戶系統(tǒng)提供單點(diǎn)登錄接口規(guī)范，各個(gè)業(yè)務(wù)系統(tǒng)按照接口規(guī)范進(jìn)行改造，即 可實(shí)現(xiàn)同門戶系統(tǒng)的單點(diǎn)登錄功能。4.4統(tǒng)一待辦接口門戶系統(tǒng)提供統(tǒng)一的待辦事項(xiàng)接口，業(yè)務(wù)系統(tǒng)在有待辦事項(xiàng)時(shí)，同時(shí)調(diào)用門 戶平臺(tái)的待辦接口，將待辦事項(xiàng)推送給門戶系統(tǒng)，以便更及時(shí)的為用戶傳遞。5系統(tǒng)運(yùn)維5.1組織架構(gòu)管理對(duì)門戶系統(tǒng)中的組織架構(gòu)進(jìn)行展現(xiàn)及查