場(chǎng)景簡(jiǎn)介

OneAccess提供第三方API的授權(quán)管理功能，API提供者將API配置到OneAccess之后，API消費(fèi)者在使用API之前需要先到OneAccess獲取鑒權(quán)Token，在使用API時(shí)攜帶該鑒權(quán)Token，API提供者根據(jù)鑒權(quán)Token判斷是否可以提供服務(wù)，用以實(shí)現(xiàn)API的授權(quán)管理功能。

前提條件

請(qǐng)確保您已擁有OneAccess管理門戶的訪問(wèn)權(quán)限。

在OneAccess中添加企業(yè)應(yīng)用

在OneAccess管理門戶中添加企業(yè)應(yīng)用，提供給API使用者獲取鑒權(quán)Token信息。

登錄OneAccess管理門戶。

在導(dǎo)航欄中，單擊“資源 > 應(yīng)用”。

在企業(yè)應(yīng)用頁(yè)面，單擊自建應(yīng)用下的“添加自建應(yīng)用”，設(shè)置Logo和名稱，單擊“保存”。

獲取的ClientId和ClientSecret。

在應(yīng)用信息頁(yè)面單擊應(yīng)用圖標(biāo)，在應(yīng)用詳情頁(yè)面獲取ClientId和ClientSecret（此信息需要提供給API使用者）。

在OneAccess中添加企業(yè)API

OneAccess管理員在OneAccess管理門戶中添加企業(yè)需要的自定義API產(chǎn)品。

登錄OneAccess管理門戶。

在導(dǎo)航欄中，單擊“資源 > 企業(yè)API”。

在企業(yè)API頁(yè)面，單擊自定義API產(chǎn)品下的“添加自定義API產(chǎn)品”。

在“添加企業(yè)API”頁(yè)面，上傳產(chǎn)品LOGO，填寫(xiě)產(chǎn)品名稱和描述，單擊“確定”，自定義API產(chǎn)品添加完成，自定義API產(chǎn)品頁(yè)面顯示已添加的API產(chǎn)品。

單擊新建的自定義API產(chǎn)品，切換到“應(yīng)用授權(quán)”頁(yè)簽，單擊在OneAccess中添加企業(yè)應(yīng)用中新建的應(yīng)用后的“授權(quán)”，完成API對(duì)應(yīng)用的授權(quán)使用。

切換到“權(quán)限信息”頁(yè)面，添加API權(quán)限信息。

在OneAccess應(yīng)用中授權(quán)相應(yīng)API權(quán)限

在OneAccess的應(yīng)用中，授權(quán)具體自定義API的權(quán)限。

登錄OneAccess管理門戶。

在導(dǎo)航欄中，單擊“資源 > 應(yīng)用”。

單擊在OneAccess中添加企業(yè)應(yīng)用中新建的應(yīng)用，單擊應(yīng)用圖標(biāo)，進(jìn)入通用信息頁(yè)面。

選擇“API權(quán)限 ”，在API權(quán)限頁(yè)面，單擊某一權(quán)限代碼右側(cè)“操作”列的“授權(quán)”則授權(quán)成功。

在OneAccess中獲取簽名公鑰和算法密鑰

OneAccess辦法的鑒權(quán)Token是經(jīng)過(guò)加密和簽發(fā)的，需要獲取簽名公鑰和算法密鑰給API提供者進(jìn)行解密。

登錄OneAccess管理門戶。

在導(dǎo)航欄中，選擇“設(shè)置 > 服務(wù)配置”，單擊“API認(rèn)證配置”，獲取簽名公鑰和算法密鑰，提供給APPI提供者。

API使用者從OneAccess獲取鑒權(quán)Token

API使用者調(diào)用OneAccess鑒權(quán)接口獲取鑒權(quán)Token。

訪問(wèn)接口：https://訪問(wèn)域名/api/oap/oauth/token?grant_type=client_credentials。

API提供者校驗(yàn)Token

API使用者調(diào)用API提供者的接口時(shí)，攜帶從OneAccess獲取的id_token，API提供者在收到API使用者的消息時(shí)需要校驗(yàn)該Token，主要校驗(yàn)兩個(gè)內(nèi)容：

Token的簽名信息是否正確，保證Token是OneAccess頒發(fā)的。

校驗(yàn)Token中申明的權(quán)限是否包含當(dāng)前訪問(wèn)當(dāng)前的API。

流程詳情請(qǐng)參考：企業(yè)API使用