在主应用程序中执行的基本身份验证流程 basic-authentication-flow-performed-within-primary-application
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进行身份验证。
- 流应用程序支持用户交互以选择MVPD。
- 流应用程序支持用户交互以在用户代理中与所选MVPD进行身份验证。
工作流 workflow-perform-authentication-completed-on-primary-application
按照给定的步骤实施在主应用程序中执行的基本身份验证流程,如下图所示。
在主应用程序中执行身份验证
-
创建身份验证会话: 流应用程序通过调用会话终结点来收集启动身份验证会话所需的所有数据。
note important IMPORTANT 有关以下内容的详细信息,请参阅创建身份验证会话 API文档: - 所有_必需的_参数,如
serviceProvider
、mvpd
、domainName
和redirectUrl
- 所有_必需的_标头,如
Authorization
、AP-Device-Identifier
- 所有_可选_参数和标头
创建身份验证会话时,流应用程序必须在单个调用中提供所有必需的参数。 - 所有_必需的_参数,如
-
指示下一个操作: 会话终结点响应包含指导流应用程序执行下一个操作所需的数据。
note important IMPORTANT 有关会话响应中提供的信息的详细信息,请参阅创建身份验证会话 API文档。 会话端点验证请求数据以确保满足基本条件: - 必需 参数和标头必须有效。
- 提供的
serviceProvider
和mvpd
之间的集成必须处于活动状态。
如果验证失败,将生成错误响应,提供附加信息以遵守增强型错误代码文档。 -
继续决策流: 会话终结点响应包含以下数据:
actionName
属性设置为“授权”。actionType
属性设置为“直接”。
如果Adobe Pass后端标识有效的配置文件,则流应用程序无需使用选定的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
,以检查是否已成功生成并保存常规配置文件。 - 所有_必需的_参数,如
-
返回有关常规配置文件的信息: 配置文件终结点响应包含有关与收到的参数和标头关联的常规配置文件的信息。
note important IMPORTANT 有关配置文件响应中提供的信息的详细信息,请参阅检索特定代码 API的配置文件。 配置文件端点验证请求数据,以确保满足基本条件: - 必需 参数和标头必须有效。
如果验证失败,将生成错误响应,提供附加信息以遵守增强型错误代码文档。