使用平台身份流进行单点登录 single-sign-on-platform-identity-full-flows
使用Adobe Pass服务时，平台标识方法允许多个应用程序使用唯一的平台标识符在设备或平台级别实现单点登录(SSO)。
这些应用程序负责使用Adobe Pass系统之外的设备特定身份服务或库检索唯一平台标识符有效负载。
应用程序负责将此唯一平台标识符有效负载包含在所有指定该有效负载的Adobe-Subject-Token标头中。
有关Adobe-Subject-Token标头的更多详细信息，请参阅Adobe主题令牌文档。
使用平台身份通过单点登录执行身份验证 perform-authentication-through-single-sign-on-using-platform-identity
先决条件 prerequisites-perform-authentication-through-single-sign-on-using-platform-identity
在使用平台标识通过单点登录执行身份验证流程之前，请确保满足以下先决条件：
- 平台必须提供一个标识服务或库，该服务或库在同一设备或平台上的所有应用程序上以
JWS或JWE有效负载的形式返回一致的信息。 - 第一个流应用程序必须检索唯一的平台标识符，并在所有指定该标识符的Adobe的Subject-Token标头中包含
JWS或JWE有效负载。 - 第一个流应用程序必须选择一个MVPD。
- 第一个流应用程序必须启动身份验证会话，才能使用选定的MVPD登录。
- 第一个流应用程序必须在用户代理中使用选定的MVPD进行身份验证。
- 第二个流应用程序必须检索唯一的平台标识符，并将
JWS或JWE有效负载作为所有指定该标识符的Adobe的Subject-Token标头的一部分。
- 第一流应用程序支持用户交互以选择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主题令牌文档。 - 所有_必需的_参数，如
-
指示下一个操作： 会话终结点响应包含指导第一个流应用程序执行下一个操作的必需数据。
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主题令牌文档。 -
检索平台标识符： 第二个流应用程序在Adobe Pass系统之外调用标识服务或库，以获取与唯一平台标识符关联的
JWS或JWE有效负载。 -
返回唯一平台标识符为JWS或JWE： 第二个流应用程序验证响应数据以确保满足基本安全条件：
- 有效负载未过期。
- 有效负载已签名或加密。
-
检索配置文件： 第二个流应用程序通过向“配置文件”端点发送请求，收集检索所有配置文件信息所需的所有数据。
note important IMPORTANT 有关以下内容的详细信息，请参阅检索配置文件 API文档： - 所有_必需的_参数，如
serviceProvider - 所有_必需的_标头，如
Authorization、AP-Device-Identifier - 所有_可选_参数和标头
在发出请求之前，流应用程序必须确保它包含唯一平台标识符的有效值。 有关 Adobe-Subject-Token标头的更多详细信息，请参阅Adobe主题令牌文档。 - 所有_必需的_参数，如
-
查找单点登录配置文件： Adobe Pass服务器根据收到的参数和标头标识有效的单点登录配置文件。
-
返回有关单点登录配置文件的信息： 配置文件终结点响应包含有关找到的与收到的参数和标头关联的配置文件的信息。
note important IMPORTANT 有关配置文件响应中提供的信息的详细信息，请参阅检索配置文件 API文档。 配置文件端点验证请求数据，以确保满足基本条件： - 必需 参数和标头必须有效。
如果验证失败，将生成错误响应，提供附加信息以遵守增强型错误代码文档。 -
继续决策流： 第二个流应用程序可以继续后续决策流。
note important IMPORTANT 在发出请求之前，流应用程序必须确保它包含唯一平台标识符的有效值。 有关 Adobe-Subject-Token标头的更多详细信息，请参阅Adobe主题令牌文档。
使用平台标识通过单点登录检索授权决策 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的Subject-Token标头的一部分。 - 第二个流应用程序必须在播放用户选择的资源之前检索授权决定。
工作流 workflow-scenario-performing-authorization-flow-using-platform-identity-single-sign-on-method
执行给定步骤以使用平台标识通过单点登录实施授权流，如下图所示。
使用平台标识通过单点登录检索授权决策
-
检索平台标识符： 第二个流应用程序在Adobe Pass系统之外调用标识服务或库，以获取与唯一平台标识符关联的
JWS或JWE有效负载。 -
返回唯一平台标识符为JWS或JWE： 第二个流应用程序验证响应数据以确保满足基本安全条件：
- 有效负载未过期。
- 有效负载已签名或加密。
-
检索授权决定： 第二个流应用程序通过调用Decisions Authorize终结点，收集所有必需的数据以获取特定资源的授权决定。
note important IMPORTANT 有关以下各项的详细信息，请参阅使用特定mvpd🔗 API检索授权决策： - 所有_必需的_参数，如
serviceProvider、mvpd和resources - 所有_必需的_标头，如
Authorization和AP-Device-Identifier - 所有_可选_参数和标头
在发出请求之前，流应用程序必须确保它包含唯一平台标识符的有效值。 有关 Adobe-Subject-Token标头的更多详细信息，请参阅Adobe主题令牌文档。 - 所有_必需的_参数，如
-
查找单点登录配置文件： 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决策详细信息： 第二个流应用程序处理来自响应的错误信息，并可用于在用户界面上显示特定消息。