使用平台身分流程的單一登入 single-sign-on-platform-identity-full-flows
平台識別方法可讓多個應用程式使用唯一的平台識別碼，在使用Adobe Pass服務時，在裝置或平台層級達成單一登入(SSO)。
應用程式負責使用Adobe Pass系統外部的裝置特定身分識別服務或程式庫來擷取唯一平台識別碼裝載。
應用程式負責將此不重複平台識別碼裝載納入指定該裝載的所有要求的Adobe-Subject-Token標題中。
如需Adobe-Subject-Token標頭的詳細資訊，請參閱Adobe-Subject-Token檔案。
使用平台身分識別透過單一登入執行驗證 perform-authentication-through-single-sign-on-using-platform-identity
先決條件 prerequisites-perform-authentication-through-single-sign-on-using-platform-identity
在使用平台身分識別透過單一登入執行驗證流程之前，請確定符合以下先決條件：
- 平台必須提供識別服務或資料庫，此服務或資料庫會傳回相同裝置或平台上所有應用程式上一致的
JWS或JWE裝載資訊。 - 第一個串流應用程式必須擷取唯一的平台識別碼，並針對所有指定該識別碼的要求，將
JWS或JWE承載包含在Adobe — 主體 — 權杖標頭中。 - 第一個串流應用程式必須選取MVPD。
- 第一個串流應用程式必須起始驗證工作階段，才能使用選取的MVPD登入。
- 第一個串流應用程式必須在使用者代理程式中使用選取的MVPD進行驗證。
- 第二個串流應用程式必須擷取唯一的平台識別碼，並包含
JWS或JWE裝載，做為所有指定該識別碼的要求之Adobe — 主體 — 權杖標頭的一部分。
- 第一個串流應用程式支援使用者互動以選取MVPD。
- 第一個串流應用程式支援使用者互動，以在使用者代理程式中使用選取的MVPD進行驗證。
工作流程 workflow-perform-authentication-through-single-sign-on-using-platform-identity
執行以下指定步驟，使用平台身分識別透過單一登入實作驗證流程，如下圖所示。
使用平台識別透過單一登入執行驗證
-
擷取平台識別碼： 第一個串流應用程式會呼叫Adobe Pass系統之外的識別服務或程式庫，以取得與唯一平台識別碼相關聯的
JWS或JWE裝載。 -
傳回唯一平台識別碼為JWS或JWE： 第一個串流應用程式會驗證回應資料，以確保符合基本安全性條件：
- 承載未過期。
- 承載已簽署或加密。
-
建立驗證工作階段： 第一個串流應用程式會收集所有必要的資料，藉由呼叫「工作階段」端點來啟動驗證工作階段。
note important IMPORTANT 如需下列詳細資訊，請參閱建立驗證工作階段 API檔案： - 所有_必要的_引數，例如
serviceProvider、mvpd、domainName和redirectUrl - 所有_必要的_標頭，例如
Authorization、AP-Device-Identifier - 所有_選用的_引數和標頭
串流應用程式在提出要求之前，必須確定其中包含唯一平台識別碼的有效值。 如需 Adobe-Subject-Token標頭的詳細資訊，請參閱Adobe-Subject-Token檔案。 - 所有_必要的_引數，例如
-
指示下一個動作： 工作階段端點回應包含必要的資料，可引導第一個串流應用程式瞭解下一個動作。
note important IMPORTANT 如需工作階段回應中所提供資訊的詳細資訊，請參閱建立驗證工作階段 API檔案。 「工作階段」端點會驗證請求資料，以確保符合基本條件： - 必要 引數和標頭必須有效。
- 提供的
serviceProvider與mvpd之間的整合必須是作用中。
如果驗證失敗，將會產生錯誤回應，提供可遵守增強錯誤碼檔案的額外資訊。 -
在使用者代理程式中開啟URL： 工作階段端點回應包含下列資料：
url可用來在MVPD登入頁面中起始互動式驗證。actionName屬性已設定為「驗證」。actionType屬性設定為「互動式」。
如果Adobe Pass後端未識別有效的設定檔，第一個串流應用程式會開啟使用者代理程式，以載入提供的
url，並向驗證端點提出要求。 此流程可能包含數個重新導向，最終將使用者帶往MVPD登入頁面並提供有效認證。 -
完成MVPD驗證： 如果驗證流程成功，使用者代理程式互動會在Adobe Pass後端儲存一般設定檔，並到達提供的
redirectUrl。 -
擷取特定程式碼的設定檔： 第一個串流應用程式會傳送要求至設定檔端點，以收集擷取設定檔資訊所需的所有資料。
note important IMPORTANT 如需下列詳細資訊，請參閱特定程式碼🔗 API檔案的擷取設定檔： - 所有_必要的_引數，如
serviceProvider、code - 所有_必要的_標頭，例如
Authorization、AP-Device-Identifier - 所有_選用的_引數和標頭
note tip TIP 建議：串流應用程式可以等待使用者代理程式到達提供的 redirectUrl，以檢查一般設定檔是否已成功產生並儲存。 - 所有_必要的_引數，如
-
尋找一般設定檔： Adobe Pass伺服器會根據收到的引數和標頭識別有效的設定檔。
-
傳回關於一般設定檔的資訊： 設定檔端點回應包含關於所找到之設定檔的相關資訊，這些設定檔與收到的引數和標題相關聯。
note important IMPORTANT 請參閱特定程式碼🔗 API檔案的擷取設定檔，以取得設定檔回應中提供的詳細資訊。 設定檔端點會驗證請求資料，以確保符合基本條件： - 必要 引數和標頭必須有效。
如果驗證失敗，將會產生錯誤回應，提供可遵守增強錯誤碼檔案的額外資訊。 -
繼續決策流程： 第一個串流應用程式可以繼續後續的決策流程。
note important IMPORTANT 串流應用程式在提出要求之前，必須確定其中包含唯一平台識別碼的有效值。 如需 Adobe-Subject-Token標頭的詳細資訊，請參閱Adobe-Subject-Token檔案。 -
擷取平台識別碼： 第二個串流應用程式會呼叫Adobe Pass系統之外的識別服務或程式庫，以取得與唯一平台識別碼相關聯的
JWS或JWE裝載。 -
傳回唯一平台識別碼為JWS或JWE： 第二個串流應用程式會驗證回應資料，以確保符合基本安全性條件：
- 承載未過期。
- 承載已簽署或加密。
-
擷取設定檔： 第二個串流應用程式會收集所有必要資料，藉由傳送要求給設定檔端點來擷取所有設定檔資訊。
note important IMPORTANT 如需下列詳細資訊，請參閱擷取設定檔 API檔案： - 所有_必要的_引數，例如
serviceProvider - 所有_必要的_標頭，例如
Authorization、AP-Device-Identifier - 所有_選用的_引數和標頭
串流應用程式在提出要求之前，必須確定其中包含唯一平台識別碼的有效值。 如需 Adobe-Subject-Token標頭的詳細資訊，請參閱Adobe-Subject-Token檔案。 - 所有_必要的_引數，例如
-
尋找單一登入設定檔： Adobe Pass伺服器會根據收到的引數和標題，識別有效的單一登入設定檔。
-
傳回有關單一登入設定檔的資訊： 設定檔端點回應包含有關所找到之設定檔的資訊，此設定檔與收到的引數和標題相關聯。
note important IMPORTANT 如需設定檔回應中所提供資訊的詳細資訊，請參閱擷取設定檔 API檔案。 設定檔端點會驗證請求資料，以確保符合基本條件： - 必要 引數和標頭必須有效。
如果驗證失敗，將會產生錯誤回應，提供可遵守增強錯誤碼檔案的額外資訊。 -
繼續決策流程： 第二個串流應用程式可以繼續後續的決策流程。
note important IMPORTANT 串流應用程式在提出要求之前，必須確定其中包含唯一平台識別碼的有效值。 如需 Adobe-Subject-Token標頭的詳細資訊，請參閱Adobe-Subject-Token檔案。
使用平台身分識別透過單一登入擷取授權決策 performing-authorization-flow-using-platform-identity-single-sign-on-method
先決條件 prerequisites-scenario-performing-authorization-flow-using-platform-identity-single-sign-on-method
在使用平台身分識別透過單一登入執行授權流程之前，請確保符合以下先決條件：
- 平台必須提供識別服務或資料庫，此服務或資料庫會傳回相同裝置或平台上所有應用程式上一致的
JWS或JWE裝載資訊。 - 第二個串流應用程式必須擷取唯一的平台識別碼，並包含
JWS或JWE裝載，做為所有指定該識別碼的要求之Adobe — 主體 — 權杖標頭的一部分。 - 第二個串流應用程式必須先擷取授權決定，才能播放使用者選取的資源。
工作流程 workflow-scenario-performing-authorization-flow-using-platform-identity-single-sign-on-method
執行以下指定步驟，使用平台身分透過單一登入實作授權流程，如下圖所示。
使用平台識別透過單一登入擷取授權決定
-
擷取平台識別碼： 第二個串流應用程式會呼叫Adobe Pass系統之外的識別服務或程式庫，以取得與唯一平台識別碼相關聯的
JWS或JWE裝載。 -
傳回唯一平台識別碼為JWS或JWE： 第二個串流應用程式會驗證回應資料，以確保符合基本安全性條件：
- 承載未過期。
- 承載已簽署或加密。
-
擷取授權決定： 第二個串流應用程式會呼叫Decisions Authorized端點，收集所有必要資料以取得特定資源的授權決定。
note important IMPORTANT 請參考使用特定mvpd API擷取授權決定，以取得以下詳細資訊： - 所有_必要的_引數，例如
serviceProvider、mvpd和resources - 所有_必要的_標頭，例如
Authorization和AP-Device-Identifier - 所有_選用的_引數和標頭
串流應用程式在提出要求之前，必須確定其中包含唯一平台識別碼的有效值。 如需 Adobe-Subject-Token標頭的詳細資訊，請參閱Adobe-Subject-Token檔案。 - 所有_必要的_引數，例如
-
尋找單一登入設定檔： Adobe Pass伺服器會根據收到的引數和標題，識別有效的單一登入設定檔。
-
擷取所要求資源的MVPD決定： Adobe Pass伺服器會呼叫MVPD授權端點，以取得從串流應用程式接收之特定資源的
Permit或Deny決定。 -
傳回
Permit決定，媒體權杖： 決定授權端點回應包含Permit決定和媒體權杖。note important IMPORTANT 請參閱使用特定mvpd🔗 API檔案的擷取授權決定，以取得決定回應中提供的詳細資訊。 Decisions Authorize端點會驗證請求資料，以確保符合基本條件： - 必要 引數和標頭必須有效。
- 提供的
serviceProvider與mvpd之間的整合必須是作用中。
如果驗證失敗，將會產生錯誤回應，提供可遵守增強錯誤碼檔案的額外資訊。 -
使用媒體權杖開始串流： 第二個串流應用程式使用媒體權杖播放內容。
-
傳回
Deny決定，詳細資料： Decisions Authorize端點回應包含Deny決定和依循增強式錯誤碼檔案的錯誤承載。note important IMPORTANT 請參閱使用特定mvpd🔗 API檔案的擷取授權決定，以取得決定回應中提供的詳細資訊。 Decisions Authorize端點會驗證請求資料，以確保符合基本條件： - 必要 引數和標頭必須有效。
- 提供的
serviceProvider與mvpd之間的整合必須是作用中。
如果驗證失敗，將會產生錯誤回應，提供可遵守增強錯誤碼檔案的額外資訊。 -
處理
Deny決定詳細資料： 第二個串流應用程式會處理回應中的錯誤資訊，並可使用它來選擇性地在使用者介面上顯示特定訊息。