搭建一個(gè)已有用戶體系的云盤(pán)系統(tǒng)
本文檔介紹如何基于PDS搭建一個(gè)擁有已有用戶體系的云盤(pán)系統(tǒng)。云盤(pán)系統(tǒng)將使用已有的用戶登錄界面，適用于已有用戶體系的應(yīng)用對(duì)接。
1. 準(zhǔn)備工作
開(kāi)通網(wǎng)盤(pán)與相冊(cè)服務(wù)。如果沒(méi)有開(kāi)通，請(qǐng)到產(chǎn)品詳情頁(yè)面開(kāi)通。
產(chǎn)品授權(quán)。第一次登錄控制臺(tái)： https://pds.console.aliyun.com, 會(huì)彈出授權(quán)提示，需要同意授權(quán)。如果已經(jīng)授權(quán)過(guò)，請(qǐng)忽略。
2. 創(chuàng)建域
域（domain）：是一個(gè)獨(dú)立的資源空間，比如一個(gè)分發(fā)系統(tǒng)或一個(gè)網(wǎng)盤(pán)系統(tǒng)。
2.1登錄PDS官網(wǎng)控制臺(tái)，創(chuàng)建一個(gè)域。
點(diǎn)擊”創(chuàng)建域”按鈕, 打開(kāi)創(chuàng)建域面板
數(shù)據(jù)存儲(chǔ)方式，選擇“標(biāo)準(zhǔn)模式”。
用戶個(gè)人空間： 啟用用戶個(gè)人空間設(shè)置后。用戶第一次登錄成功后，系統(tǒng)會(huì)自動(dòng)為其創(chuàng)建一個(gè)云盤(pán)空間。
3. 服務(wù)端調(diào)用管理接口接入
服務(wù)端有兩種方式獲取最終用戶的 access_token： 通過(guò)阿里云AccessKey方式通過(guò)JWT方式
3.1 AccessKey方式：
3.1.1 創(chuàng)建子用戶生成AccessKey并授權(quán)
RAM 控制臺(tái) https://ram.console.aliyun.com 創(chuàng)建用戶，并創(chuàng)建AK，并授予相關(guān)權(quán)限（ GetToken權(quán)限 ）。
點(diǎn)擊創(chuàng)建用戶按鈕
勾選OpenAPI調(diào)用訪問(wèn)。
創(chuàng)建好后注意保存AccessKeyID和AccessKeySecret，只出現(xiàn)一次。
3.1.2 給子用戶授權(quán)
在用戶列表找到剛才創(chuàng)建的用戶，添加權(quán)限。
搜索找到 AliyunPDSFullAccess，添加。
至此，該用戶已經(jīng)擁有調(diào)用 PDS 接口的所有權(quán)限。
注意：生產(chǎn)環(huán)境下建議使用自定義的權(quán)限策略，盡量縮小權(quán)限的范圍，只保留調(diào)用需要的接口的權(quán)限，遵循最小權(quán)限原則。
最后調(diào)用接口獲取最終用戶AccessToken： AccessKey調(diào)接口接入
3.2 JWT方式：
3.2.1 創(chuàng)建應(yīng)用
進(jìn)入域詳情，在應(yīng)用列表界面，創(chuàng)建一個(gè)應(yīng)用：
3.2.2 設(shè)置公鑰
應(yīng)用創(chuàng)建好后，點(diǎn)擊”設(shè)置公鑰”：
生成公私鑰：
生成公私鑰后，記得復(fù)制私鑰，自己保存。然后點(diǎn)確定即可。
最后調(diào)用接口獲取最終用戶 AccessToken：JWT應(yīng)用接入
4. 集成 SDK
4.1 方式一：使用自己開(kāi)發(fā)的云盤(pán)應(yīng)用界面
接入步驟：
用戶先通過(guò)業(yè)務(wù)系統(tǒng)自己的登錄頁(yè)面認(rèn)證。
認(rèn)證成功后，服務(wù)端通過(guò)內(nèi)部的UserID獲取到最終用戶在PDS的
AccessToken。服務(wù)端將
AccessToken返回給客戶端?？蛻舳送ㄟ^(guò)AccessToken訪問(wèn) API概覽。
4.2方式二：使用官方PDSBasicUI應(yīng)用
如果使用官方 BasicUI 應(yīng)用， 需要先允許 BasicUI 訪問(wèn)您的域：
然后需要以超級(jí)管理員登入一次，以同步數(shù)據(jù)：
用例圖：
用戶先通過(guò)已有的登錄頁(yè)面登錄。
需要打開(kāi)官方 BasicUI 應(yīng)用界面的時(shí)候，登錄后界面
window.open('https://'+domainId+'.apps.aliyunpds.com/accesstoken?origin='+location.origin)。登錄后界面等待 BasicUI postMessage 回來(lái)表示 Ready。
登錄后界面請(qǐng)求服務(wù)端使用 “JWT應(yīng)用接入” 簽發(fā) AccessToken。
登錄后界面拿到 AccessToken 后，postMessage 給BasicUI。
BasicUI 拿到 AccessToken 后，通過(guò)AccessToken 訪問(wèn) API概覽。