文件Adobe PassAdobe Pass 驗證

存取流程效能降低

最後更新： 2025年5月5日
  • 主題：
  • 驗證
重要
此頁面上的內容僅供參考。 使用此API需要Adobe的目前授權。 不允許未經授權的使用。
重要
REST API V2實作受到節流機制檔案的限制。
Related Articles
請確定也造訪REST API V2常見問題集。

降級提供暫時略過特定MVPD驗證和授權端點。 通常，程式設計師會起始此動作，但無論誰觸發降級事件，此動作取決於與受影響MVPD預先作出的安排。

如需有關降級功能的詳細資訊，請參閱降級檔案。

降級存取流程可讓您查詢下列情況：

  • 套用降級時執行驗證
  • 套用降級時擷取授權決策
  • 套用降級時擷取預先授權決策
  • 套用降級時擷取設定檔

套用降級時執行驗證

先決條件

在套用降級狀況時執行驗證流程之前，請確定符合下列必要條件：

  • 串流應用程式在需要使用MVPD登入時，必須起始驗證工作階段。
IMPORTANT
假設
  • 串流應用程式沒有該特定MVPD的有效設定檔儲存在Adobe Pass後端。
  • 提供的serviceProvider和mvpd之間的整合已套用AuthNAll降級規則。

工作流程

遵循指定步驟在套用降級時實施驗證流程，如下圖所示。

套用降級時執行驗證

套用降級時執行驗證

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

    IMPORTANT
    如需下列詳細資訊，請參閱建立驗證工作階段 API檔案：
    • 所有​_必要的_​引數，例如serviceProvider、mvpd、domainName和redirectUrl
    • 所有​_必要的_​標頭，例如Authorization和AP-Device-Identifier
    • 所有​_選用的_​引數和標頭

  2. 檢查降級規則： Adobe Pass伺服器會驗證是否將AuthNAll降級規則套用到提供的serviceProvider與mvpd之間的整合。

  3. 指示下一個動作： ​工作階段端點回應包含必要的資料，可引導串流應用程式進行下一個動作：

    • actionName屬性已設定為「授權」。
    • actionType屬性設定為「直接」。
    IMPORTANT
    如需工作階段回應中所提供資訊的詳細資訊，請參閱建立驗證工作階段 API檔案。
    「工作階段」端點會驗證請求資料，以確保符合基本條件：
    • 必要 ​引數和標頭必須有效。
    • 提供的serviceProvider與mvpd之間的整合必須是作用中。
    如果基本驗證失敗，將會產生錯誤回應，提供遵守增強型錯誤碼檔案的額外資訊。
    「工作階段」端點會使用要求資料來檢查是否符合降級存取條件：
    • 提供的serviceProvider與mvpd之間的整合必須套用AuthNAll降級規則。
    如果降級存取驗證失敗，回應會預設為基本驗證流程。

  4. 繼續決策流程： ​串流應用程式可以繼續後續的決策流程。

套用降級時擷取授權決策

先決條件

在套用降級時擷取授權決定之前，請確保符合以下先決條件：

  • 串流應用程式必須先擷取授權決定，才能播放使用者選取的資源。
IMPORTANT
假設
  • 串流應用程式沒有該特定MVPD的有效設定檔。
  • 提供的serviceProvider和mvpd之間的整合已套用AuthZAll或AuthNAll降級規則。

工作流程

遵循指定步驟以在套用降級時實施授權流程，如下圖所示。

套用降級時擷取授權決定

套用降級時擷取授權決定

  1. 擷取授權決定： ​串流應用程式會呼叫Decisions Authorized端點，收集所有必要資料以取得特定資源的授權決定。

    IMPORTANT
    請參考使用特定mvpd API擷取授權決定，以取得以下詳細資訊：
    • 所有​_必要的_​引數，例如serviceProvider、mvpd和resources
    • 所有​_必要的_​標頭，例如Authorization和AP-Device-Identifier
    • 所有​_選用的_​引數和標頭

  2. 檢查降級規則： Adobe Pass伺服器會驗證提供的serviceProvider與mvpd之間的整合是否套用了AuthZAll或AuthNAll降級規則。

  3. 傳回Permit決定，媒體權杖： ​決定授權端點回應包含Permit決定和媒體權杖。

    IMPORTANT
    請參閱使用特定mvpd🔗 API檔案的擷取授權決定，以取得決定回應中提供的詳細資訊。
    Decisions Authorize端點會驗證請求資料，以確保符合基本條件：
    • 必要 ​引數和標頭必須有效。
    • 提供的serviceProvider與mvpd之間的整合必須是作用中。
    如果基本驗證失敗，將會產生錯誤回應，提供遵守增強型錯誤碼檔案的額外資訊。
    決定授權端點使用請求資料來檢查是否符合降級存取條件：
    • 提供的serviceProvider與mvpd之間的整合必須套用AuthZAll或AuthNAll降級規則。
    如果降級存取驗證失敗，回應將預設為基本授權流程。

  4. 使用媒體權杖開始串流： ​串流應用程式使用媒體權杖播放內容。

套用降級時擷取預先授權決策

先決條件

在套用降級時擷取預先授權決定之前，請確定符合下列先決條件：

  • 串流應用程式想要擷取預先授權決定，以顯示資源清單及其關聯狀態。
IMPORTANT
假設
  • 串流應用程式沒有該特定MVPD的有效設定檔。
  • 提供的serviceProvider和mvpd之間的整合已套用AuthZAll或AuthNAll降級規則。

工作流程

遵循指定步驟以在套用降級時實作預先授權流程，如下圖所示。

套用降級時擷取預先授權決定

套用降級時擷取預先授權決定

  1. 擷取預先授權決定： ​串流應用程式會呼叫Decisions Preauthorize端點，收集所有必要的資料，以取得資源清單的預先授權決定。

    IMPORTANT
    如需下列詳細資訊，請參閱使用特定mvpd🔗 API檔案擷取預先授權決定：
    • 所有​_必要的_​引數，例如serviceProvider、mvpd和resources
    • 所有​_必要的_​標頭，例如Authorization和AP-Device-Identifier
    • 所有​_選用的_​引數和標頭

  2. 檢查降級規則： Adobe Pass伺服器會驗證提供的serviceProvider與mvpd之間的整合是否套用了AuthZAll或AuthNAll降級規則。

  3. 傳回預先授權決定： ​決定預先授權端點回應包含每個資源的Permit決定。

    IMPORTANT
    請參閱使用特定mvpd🔗 API檔案的擷取預先授權決定，以取得決定回應中提供的詳細資訊。
    決定預先授權端點會驗證請求資料，以確保符合基本條件：
    • 必要 ​引數和標頭必須有效。
    • 提供的serviceProvider與mvpd之間的整合必須是作用中。
    如果基本驗證失敗，將會產生錯誤回應，提供遵守增強型錯誤碼檔案的額外資訊。
    決定預先授權端點會使用請求資料來檢查是否符合降級存取條件：
    • 提供的serviceProvider與mvpd之間的整合必須套用AuthZAll或AuthNAll降級規則。
    如果降級存取驗證失敗，回應將預設為基本預先授權流程。

  4. 處理預先授權決定： ​串流應用程式會處理回應，並可以使用它選擇性地在使用者介面上顯示每個資源的適當狀態。

套用降級時擷取設定檔

IMPORTANT
當套用降級時，設定檔端點查詢是選用的。
「工作階段」端點回應會指示應用程式在套用降級時繼續決策流程。 如需詳細資訊，請參閱套用降級時執行驗證區段。

先決條件

在套用降級時擷取特定MVPD的設定檔之前，請確定符合下列先決條件：

  • 串流應用程式具有選取或快取的mvpd識別碼，想要擷取特定MVPD的設定檔。
IMPORTANT
假設
  • 串流應用程式沒有該特定MVPD的有效設定檔。
  • 提供的serviceProvider和mvpd之間的整合已套用AuthNAll降級規則。

工作流程

遵循指定步驟，在套用降級時為特定MVPD實施設定檔擷取流程，如下圖所示。

套用降級時擷取設定檔

套用降級時擷取設定檔

  1. 擷取特定mvpd的設定檔： ​串流應用程式會傳送要求至設定檔端點，以收集所有必要資料來擷取該特定MVPD的設定檔資訊。

    IMPORTANT
    如需下列詳細資訊，請參閱特定mvpd🔗 API檔案的擷取設定檔：
    • 所有​_必要的_​引數，如serviceProvider和mvpd
    • 所有​_必要的_​標頭，例如Authorization和AP-Device-Identifier
    • 所有​_選用的_​引數和標頭

  2. 檢查降級規則： Adobe Pass伺服器會驗證是否將AuthNAll降級規則套用到提供的serviceProvider與mvpd之間的整合。

  3. 傳回降級設定檔的相關資訊： ​設定檔端點回應包含降級設定檔的相關資訊，包括設定為「降級」的屬性type。

    IMPORTANT
    請參閱特定mvpd🔗 API檔案的擷取設定檔，以取得設定檔回應中提供的詳細資訊。
    設定檔端點會驗證請求資料，以確保符合基本條件：
    • 必要 ​引數和標頭必須有效。
    • 提供的serviceProvider與mvpd之間的整合必須是作用中。
    如果基本驗證失敗，將會產生錯誤回應，提供遵守增強型錯誤碼檔案的額外資訊。
    設定檔端點會使用請求資料來檢查是否符合降低的存取條件：
    • 提供的serviceProvider與mvpd之間的整合必須套用AuthNAll降級規則。
    如果降級存取驗證失敗，回應將預設為基本設定檔擷取流程。

  4. 繼續決策流程： ​如果設定檔端點回應包含設定檔，串流應用程式會使用降級設定檔資訊，繼續後續決策流程。

  5. 指示新的基本驗證流程： ​如果設定檔端點回應不包含設定檔，串流應用程式會指示使用者啟動新的基本驗證流程。

NOTE
特定驗證程式碼的設定檔擷取流程步驟與上述相同，但所使用的端點是擷取特定程式碼設定檔檔案中描述的端點。
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b