（舊版） REST API逐步指南（使用者端對伺服器） rest-api-cookbook-client-to-server

Last update: Sat Apr 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
驗證

NOTE

此頁面上的內容僅供參考。使用此API需要Adobe的目前授權。不允許未經授權的使用。

IMPORTANT

請務必隨時瞭解彙總在產品公告頁面中的最新Adobe Pass驗證產品公告和淘汰時間表。

概觀 overview

本檔案逐步說明程式設計師的工程團隊，如何使用REST API服務整合「智慧型裝置」（遊戲主機、智慧型電視應用程式、機上盒等）與Adobe Pass驗證。這種使用者端對伺服器方法使用REST API，而不是使用者端SDK，可讓不同平台有更廣泛的支援，針對這些平台，開發大量不重複SDK將不可行。如需無使用者端解決方案運作方式的廣泛技術概覽，請參閱無使用者端技術概覽。

此方法需要兩個元件（串流應用程式和AuthN應用程式）才能完成所需的流程：串流應用程式中的啟動、註冊、授權和檢視媒體流程，以及AuthN應用程式中的驗證流程。

節流機制

Adobe Pass驗證REST API受節流機制所控管。

元件 components

在工作中的使用者端對伺服器解決方案中，涉及以下元件：

型別

元件

說明

串流裝置

串流應用程式

位在使用者串流裝置上並播放已驗證視訊的程式設計師應用程式。

[Optional]驗證模組

如果串流裝置具有使用者代理程式（即網頁瀏覽器），則AuthN模組會負責在MVPD IdP上驗證使用者。

[Optional] AuthN裝置

AuthN應用程式

如果串流裝置沒有使用者代理程式（亦即Web瀏覽器），則AuthN應用程式為程式設計人員網頁應用程式，可使用網頁瀏覽器從個別使用者的裝置進行存取。

Adobe基礎結構

Adobe Pass服務

此服務會與MVPD IdP和AuthZ服務整合，並提供驗證和授權決策。

MVPD基礎結構

MVPD IdP

MVPD端點，提供認證型驗證服務以驗證其使用者的身分。

MVPD AuthZ服務

MVPD端點，可根據使用者的訂閱、家長監護等提供授權決策。

流程 flows

動態使用者端註冊(DCR)

Adobe Pass使用DCR來保護程式設計人員應用程式或伺服器與Adobe Pass服務之間的使用者端通訊。 DCR流程是獨立的，在動態使用者端註冊概觀檔案中有所說明。

串流（智慧型裝置）應用程式流程

啟動流程

您的應用程式會啟動並載入其初始UI。
取得/產生裝置識別碼。
發出Check-authentication呼叫以檢視裝置是否已驗證。例如： <SP_FQDN>/api/v1/checkauthn [device ID]
如果checkauthn呼叫成功，請從步驟2開始進行授權流程。如果失敗，請啟動「註冊流程」。

註冊流程

取得註冊碼和URL，讓您的使用者使用來存取您的第二熒幕登入應用程式，並將這些呈現給使用者：

a.傳送POST要求至Adobe註冊代碼服務，傳遞雜湊裝置ID和「註冊URL」。例如： <REGGIE_FQDN>/reggie/v1/[requestorId]/regcode [device ID]

b.向使用者呈現傳回的註冊代碼和URL。

c.指示使用者切換到可支援網頁的裝置，導覽至URL，然後輸入註冊代碼。

授權流程

使用者從第二熒幕應用程式返回，並按裝置上的「繼續」按鈕。或者，您可以實作輪詢機制來檢查驗證狀態，但Adobe Pass驗證建議使用繼續按鈕方法來取代輪詢。例如： <SP_FQDN>/api/v1/tokens/authn
傳送GET請求至Adobe Pass Authentication Authorization Service以啟動授權。例如： <SP_FQDN>/api/v1/authorize [device ID, Requestor ID, Resource ID]

如果回應指出成功：使用者具備有效的AuthN權杖，且使用者已獲授權可觀看要求的媒體（此使用者具備有效的AuthZ權杖）。
如果回應指出失敗：請檢查擲回的例外狀況，以判斷其型別（AuthN、AuthZ或其他專案）：
- 如果是AuthN錯誤，請重新啟動註冊流程。
- 如果這是AuthZ錯誤，則使用者無權觀看請求的媒體，並且應向使用者顯示某種錯誤訊息。
- 如果發生其他錯誤（連線錯誤、網路錯誤等），則向使用者顯示適當的錯誤訊息。