主要應用程式內執行的基本驗證流程 basic-authentication-flow-performed-within-primary-application

IMPORTANT
此頁面上的內容僅供參考。 使用此API需要Adobe的目前授權。 不允許未經授權的使用。
IMPORTANT
REST API V2實作受到節流機制檔案的限制。

Adobe Pass驗證許可權內的​ 驗證流程 ​可讓串流應用程式驗證使用者是否擁有有效的MVPD帳戶。 此程式要求使用者擁有作用中的MVPD帳戶,並在MVPD登入頁面上輸入有效的登入認證。

在下列情況下需要驗證流程:

  • 使用者首次開啟應用程式時。
  • 當使用者的先前驗證過期時。
  • 當使用者從MVPD帳戶登出時。
  • 當使用者想要使用不同的MVPD進行驗證時。

在所有這些情況下,呼叫任何設定檔端點的應用程式會收到空白回應或一或多個設定檔,但針對不同的MVPD。

驗證流程 ​需要使用者代理程式(瀏覽器)來完成從應用程式到Adobe Pass後端,然後到MVPD登入頁面,最後返回應用程式的一系列呼叫。 此流程可能包括數個重新導向至MVPD系統並管理針對每個網域儲存的Cookie或工作階段,若沒有使用者代理程式,這對於實現和安全都極具挑戰。

根據主要應用程式(串流應用程式)支援使用者互動以選取MVPD以及在使用者代理程式中使用選取的MVPD進行驗證的功能,驗證情況如下:

在主要應用程式內執行驗證 perform-authentication-within-primary-application

先決條件 prerequisites-perform-authentication-within-primary-application

在透過主要應用程式內的使用者互動執行驗證之前,請確定符合下列先決條件:

  • 串流應用程式必須選取MVPD。
  • 串流應用程式必須起始驗證工作階段,才能使用選取的MVPD登入。
  • 串流應用程式必須在使用者代理程式中使用選取的MVPD進行驗證。
IMPORTANT
假設
  • 串流應用程式支援使用者互動以選取MVPD。
  • 串流應用程式支援使用者互動,以在使用者代理程式中使用選取的MVPD進行驗證。

工作流程 workflow-perform-authentication-completed-on-primary-application

請依照指定的步驟,實作主要應用程式內執行的基本驗證流程,如下圖所示。

在主要應用程式內執行驗證

在主要應用程式內執行驗證

  1. 建立驗證工作階段: ​串流應用程式會呼叫工作階段端點,收集所有必要的資料以啟動驗證工作階段。

    note important
    IMPORTANT
    如需下列詳細資訊,請參閱建立驗證工作階段 API檔案:
    • 所有​_必要的_​引數,例如serviceProvidermvpddomainNameredirectUrl
    • 所有​_必要的_​標頭,例如AuthorizationAP-Device-Identifier
    • 所有​_選用的_​引數和標頭
    串流應用程式在建立驗證工作階段時,必須在單一呼叫中提供所有必要的引數。
  2. 指示下一個動作: ​工作階段端點回應包含必要的資料,可引導串流應用程式瞭解下一個動作。

    note important
    IMPORTANT
    如需工作階段回應中所提供資訊的詳細資訊,請參閱建立驗證工作階段 API檔案。
    「工作階段」端點會驗證請求資料,以確保符合基本條件:
    • 必要 ​引數和標頭必須有效。
    • 提供的serviceProvidermvpd之間的整合必須是作用中。
    如果驗證失敗,將會產生錯誤回應,提供可遵守增強錯誤碼檔案的額外資訊。
  3. 繼續決策流程: ​工作階段端點回應包含下列資料:

    • actionName屬性已設定為「授權」。
    • actionType屬性設定為「直接」。

    如果Adobe Pass後端識別有效的設定檔,串流應用程式就不需要使用選取的MVPD重新驗證,因為已經有設定檔可用於後續的決策流程。

  4. 在使用者代理程式中開啟URL: ​工作階段端點回應包含下列資料:

    • url可用來在MVPD登入頁面中起始互動式驗證。
    • actionName屬性已設定為「驗證」。
    • actionType屬性設定為「互動式」。

    如果Adobe Pass後端未識別有效的設定檔,串流應用程式會開啟使用者代理程式,以載入提供的url,並向驗證端點提出要求。 此流程可能包含數個重新導向,最終將使用者帶往MVPD登入頁面並提供有效認證。

  5. 完成MVPD驗證: ​如果驗證流程成功,使用者代理程式互動會在Adobe Pass後端儲存一般設定檔,並到達提供的redirectUrl

  6. 擷取特定程式碼的設定檔: ​串流應用程式會傳送要求至設定檔端點,以收集擷取設定檔資訊所需的所有資料。

    note important
    IMPORTANT
    如需下列詳細資訊,請參閱特定程式碼🔗 API檔案的擷取設定檔:
    • 所有​_必要的_​引數,如serviceProvidercode
    • 所有​_必要的_​標頭,例如AuthorizationAP-Device-Identifier
    • 所有​_選用的_​引數和標頭
    note tip
    TIP
    建議:串流應用程式可以等待使用者代理程式到達提供的redirectUrl,以檢查一般設定檔是否已成功產生並儲存。
  7. 傳回關於一般設定檔的資訊: ​設定檔端點回應包含關於與所接收引數和標題關聯的一般設定檔的資訊。

    note important
    IMPORTANT
    請參閱特定程式碼🔗 API檔案的擷取設定檔,以取得設定檔回應中提供的詳細資訊。
    設定檔端點會驗證請求資料,以確保符合基本條件:
    • 必要 ​引數和標頭必須有效。
    如果驗證失敗,將會產生錯誤回應,提供可遵守增強錯誤碼檔案的額外資訊。
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b