搭建基於OAuth2和SSO的開放平臺

原創文章，轉載或摘錄請說明文章來源，謝謝！

http://heartlifes.com/%E6%90%AD%E5%BB%BA%E5%9F%BA%E4%BA%8Eoauth2%E5%92%8Csso%E7%9A%84%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0/

原創文章，轉載或摘錄請說明文章來源，謝謝！

http://heartlifes.com/%E6%90%AD%E5%BB%BA%E5%9F%BA%E4%BA%8Eoauth2%E5%92%8Csso%E7%9A%84%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0/

原創文章，轉載或摘錄請說明文章來源，謝謝！

http://heartlifes.com/%E6%90%AD%E5%BB%BA%E5%9F%BA%E4%BA%8Eoauth2%E5%92%8Csso%E7%9A%84%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0/

開放平臺介紹

什麼是開放平臺

開放平臺在百科中的定義：
開放平臺（Open Platform） 在軟件行業和網絡中，開放平臺是指軟件系統經過公開其應用程序編程接口（API）或函數（function)來使外部的程序能夠增長該軟件系統的功能或使用該軟件系統的資源，而不須要更改該軟件系統的源代碼。

通俗或者說應景點的說法，開放平臺，就是互聯網企業，將其內部的資源(通常是數據)，好比用戶數據，平臺業務數據，以技術的手段(通常是RESTFul接口API)，開放給受控的第三方合做夥伴，活公司內部的其它一些產品，造成一個安全受控的資源暴露平臺。

爲何要搭建開放平臺

搭建開放平臺的意義，通常在於：
1.搭建基於API的生態體系
2.利用開放平臺，搭建基於計費的API數據平臺
3.爲APP端提供統一接口管控平臺，相似於網關的概念
4.爲第三方合做夥伴的業務對接提供授信可控的技術對接平臺

開放平臺體系結構圖

開放平臺核心模塊

一個典型的開放平臺，至少包含如下幾個核心模塊：
1.平臺門戶
平臺門戶負責向第三方展現用於進行業務及技術集成的管理界面，至少包含如下幾個功能：
1.服務商入住(第三方合做夥伴入住)
2.應用配置(第三方應用管理)
3.權限申請(通常包括接口權限和字段權限)
4.運維中心(開放平臺當前服務器、接口狀態，服務商接口告警等)
5.幫助中心(入住流程說明，快速接入說明，API文檔等)

2.鑑權服務
鑑權服務負責整個平臺的安全性
1.接口調用鑑權(第三方合做夥伴是否有權限調用某接口)
2.用戶受權管理(用戶對某個第三方應用獲取改用戶信息的權限管理)
3.用戶鑑權(平臺用戶的鑑權)
4.應用鑑權(第三方合做夥伴的應用是否有權調用該平臺)

3.開放接口
開放接口用於將平臺數據暴露給合做夥伴
1.平臺用戶接口(用於獲取公司APP生態鏈中的用戶信息)
2.平臺數據接口(平臺中的一些開放數據)
3.其它業務接口(平臺開放的一些業務數據)

4.運營系統
運營系統是整個平臺的後臺業務管理系統，負責對第三方合做夥伴提出的各類申請進行審覈操做，對當前應用的操做進行審計工做，對當前業務健康度進行監控等
1.服務商管理(對第三方合做夥伴的資質進行審覈、操做)
2.應用管理(對第三方應用進行審覈、上下線管理)
3.權限管理（對合做夥伴申請的資源進行審覈、操做）
4.統計分析(監控平臺當前運行狀態，統計平臺業務數據)

OAuth2介紹

什麼是OAuth2

百科：OAUTH協議爲用戶資源的受權提供了一個安全的、開放而又簡易的標準。與以往的受權方式不一樣之處是OAUTH的受權不會使第三方觸及到用戶的賬號信息（如用戶名與密碼），即第三方無需使用用戶的用戶名與密碼就能夠申請得到該用戶資源的受權，所以OAUTH是安全的。oAuth是Open Authorization的簡寫。

簡單來講：OAuth2協議，定義了一套用戶、第三方服務和存儲着用戶數據的平臺之間的交互規則，可使得用戶無需將本身的用戶名和密碼暴露給第三方，便可使第三方應用獲取用戶在該平臺上的數據，最多見的場景即是如今互聯網上的各類使用XXX帳號登陸。

OAuth2協議中角色介紹

OAuth2協議中，共有四個參與方(角色)：
1.resource owner：資源擁有者
即用戶
2.resource server：資源服務器
即存儲用戶數據的服務器，通常對外都以RESTFul API的形式暴露用戶數據，client使用access token訪問resource server申請被保護起來的用戶數據
3.client：客戶端
即第三方應用
4.authorization server：受權服務器
用來鑑權第三方應用合法性，並對用戶登陸、是否受權第三方應用獲取數據進行響應，並根據用戶操做，想第三應用頒發用戶token或者告知受權失敗

OAuth2經常使用協議介紹

OAUTH2標準業務協議，以下圖所示

A.第三方應用向用戶請求受權，但願獲取用戶數據
B.用戶贊成受權
C.第三方應用拿着用戶受權，向平臺索要用戶access token
D.平臺校驗第三應用合法性及用戶受權真實性後，向平臺發放用戶access token
E.第三方應用拿着用戶access token向平臺索要用戶數據
F.平臺在校驗用戶access token真實性後，返回用戶數據

OAuth2使用場景介紹

目前，OAuth2協議使用最多的場景仍是用以給第三方應用獲取用戶信息，業務流程以下圖所示

1.在瀏覽器中，用戶點擊第三方應用按鈕，由第三方應用發起請求，向平臺發起受權請求。
2.平臺在接收到第三方應用請求後，瀏覽器跳轉用戶登陸界面，請求用戶進行登陸。
3.用戶在平臺登陸界面輸入用戶名、密碼進行登陸
4.平臺判斷用戶合法性，校驗失敗，在瀏覽器中提示錯誤緣由
5.平臺判斷用戶是否須要對該第三方應用進行受權。(不須要受權的狀況有兩種：a.平臺信任該第三方應用，如公司內部應用，無需用戶進行受權，默認給予用戶數據。b.該用戶以前已經給該應用授予過權限，而且仍在有效期內)
6.如需受權，平臺跳轉瀏覽器界面至受權界面，告知用戶將授予哪一個第三方哪些數據權限
7.用戶受權後，將用戶受權碼回調給第三方url
8.第三方在獲取用戶受權碼後，帶着用戶受權碼訪問平臺鑑權接口，請求用戶token
9.平臺在收到第三方請求後，校驗受權碼真實性，並返回用戶token
10.第三方使用用戶token向平臺請求用戶接口
11.平臺接口判斷用戶token真實性，並向第三方返回用戶數據

OAuth2核心功能說明

1.應用註冊
應用註冊後，OAuth2會下發應用app_id和app_secret，用以標記該應用的惟一性，而且這兩個參數將貫穿整個OAuth協議，用以對應用合法性進行校驗。同時，應用須要提供redirect_uri，用以和平臺進行異步交互，獲取用戶令牌及錯誤信息。
2.受權/鑑權中心
a.對用戶的應戶名、密碼進行鑑權
b.對第三方應用的app_id,app_secret進行鑑權
c.展現受權界面，並對用戶對第三方應用的受權操做進行響應
d.對用戶受權碼及用戶token的真實性進行鑑權
3.token管理
a.建立token、刷新token
b.查詢token詳細數據
c.校驗token時效性

OAuth2體系結構

開放平臺集成OAuth2體系

1.平臺門戶：
門戶應用入住界面，須要集成OAuth2應用建立接口，錄入第三方回調地址，並回顯app_id和app_secret參數
2.鑑權服務：
鑑權服務需集成OAuth2的authorize及token接口，用以提供用戶受權及code/token鑑權功能
3.開放接口：
開放接口需集成OAuth2的resource server角色，對用戶數據進行安全管理，對第三方應用發起的請求作出響應，並對token進行真實性校驗
4.運營系統：
運營系統需提供對當前OAuth2應用的管理功能，用戶受權列表管理，用戶token管理等OAuth2協議相關管理功能。

SSO介紹

什麼是SSO

百科：SSO英文全稱Single Sign On，單點登陸。SSO是在多個應用系統中，用戶只須要登陸一次就能夠訪問全部相互信任的應用系統。它包括能夠將此次主要的登陸映射到其餘應用中用於同一個用戶的登陸的機制。它是目前比較流行的企業業務整合的解決方案之一。

簡單來講，SSO出現的目的在於解決同一產品體系中，多應用共享用戶session的需求。SSO經過將用戶登陸信息映射到瀏覽器cookie中，解決其它應用免登獲取用戶session的問題。

爲何須要SSO

開放平臺業務自己不須要SSO，可是若是平臺的普通用戶也能夠在申請後成爲一個應用開發者，那麼就須要將平臺加入到公司的總體帳號體系中去，另外，對於企業級場景來講，通常都會有SSO系統，充當統一的帳號校驗入口。

CAS協議中概念介紹

SSO單點登陸只是一個方案，而目前市面上最流行的單端登陸系統是由耶魯大學開發的CAS系統，而由其實現的CAS協議，也成爲目前SSO協議中的既定協議，下文中的單點登陸協議及結構，均爲CAS中的體現結構
CAS協議中有如下幾個概念：
1.CAS Client：須要集成單點登陸的應用，稱爲單點登陸客戶端
2.CAS Server：單點登陸服務器，用戶登陸鑑權、憑證下發及校驗等操做
3.TGT：ticker granting ticket，用戶憑證票據，用以標記用戶憑證，用戶在單點登陸系統中登陸一次後，再其有效期內，TGT即表明用戶憑證，用戶在其它client中無需再進行二次登陸操做，便可共享單點登陸系統中的已登陸用戶信息
4.ST：service ticket，服務票據，服務能夠理解爲客戶端應用的一個業務模塊，體現爲客戶端回調url，CAS用以進行服務權限校驗，即CAS能夠對接入的客戶端進行管控
5.TGC：ticket granting cookie，存儲用戶票據的cookie，即用戶登陸憑證最終映射的cookies

CAS核心協議介紹

1.用戶在瀏覽器中訪問應用
2.應用發現須要索要用戶信息，跳轉至SSO服務器
3.SSO服務器向用戶展現登陸界面，用戶進行登陸操做，SSO服務器進行用戶校驗後，映射出TGC
4.SSO服務器向回調應用服務url，返回ST
5.應用去SSO服務器校驗ST權限及合法性
6.SSO服務器校驗成功後，返回用戶信息

CAS基本流程介紹

如下爲基本的CAS協議流程，圖一爲初次登陸時的流程，圖二爲已進行過一次登陸後的流程

代碼及示例

spring提供了整套的開源包，用以搭建OAUTH2+SSO的體系：
1.spring-oauth2：用以實現OAuth2協議，提供了上述全部四個角色提供的功能
2.spring-cas：用以實現和cas的集成，將OAuth2的登陸、登出功能委託給CAS處理，並提供了統一的回調機制及憑證校驗機制
3.CAS，耶魯大學官方提供的SSO開源實現，本文的單點登陸協議即按照CAS進行的說明

本文還提供了基於GO語言實現的簡單OAuth2+SSO功能，詳見github: https://github.com/janwenjohn/go-oauth2-sso