集成
TVE仪表板的 集成 部分允许您查看和管理渠道与MVPD之间的集成设置。 您还可以根据需要创建新的集成。
左侧面板中的 集成 选项卡显示现有集成的列表,详细信息如下:
- 指示集成当前是活动还是不活动的状态
- 将特定渠道与相应的MVPD关联的集成
- 具有渠道ID的渠道名称
- MVPD显示名称和MVPD ID
现有集成的列表
在列表上方的 Search 栏中键入渠道或MVPD的名称,了解有关集成的更多信息。
管理集成配置 manage-integration-conf
请按照以下步骤管理特定集成。
端点选择 endpoint-selection
在此部分中,您可以从各自的下拉菜单中选择用于身份验证、授权和注销流的MVPD端点。
身份验证、授权和注销流的
身份验证、授权和注销流的端点
平台设置 platform-settings
此部分允许您查看和编辑所有平台上的集成设置。 您可以根据各个平台更改这些设置。 例如,您可以调整Android上的授权TTL持续时间,同时保留另一个平台的默认值。
平台设置中的每个属性都继承了MVPD设置的默认值,但如有必要,可以调整该值。
平台设置用于覆盖继承链中每个级别的设置。 链中的可用级别分组如下:
-
Default for All:如果未定义特定平台值,则为适用于所有平台的属性设置值,而不管程序员的实施如何。
-
桌面设备:设置适用于所有台式机和笔记本电脑的属性值,不考虑编程方法(JS SDK或REST API)。
-
移动设备:设置适用于所有移动设备的属性值,包括iOS、Android和其他设备,而不管编程方法如何(SDK或REST API)。
-
TV连接设备:设置适用于所有电视连接设备的属性值,包括tvOS、Roku、FireTV和其他设备,不考虑编程方法(SDK或REST API)。
-
未识别的设备:设置适用于当前机制无法准确识别平台的所有设备的属性值。 在这种情况下,应应用MVPD定义的最严格的规则。
平台及其设备的类别
选择 位于每个属性右侧的
最常用的业务流程 most-used-flows
平台设置部分提供用于不同业务流程的一系列属性。 实际属性可能因特定集成中选择的MVPD而异。 以下是最常用的流:
跨所有平台的AuthN TTL和AuthZ TTL
按照以下步骤更改特定集成在所有平台上的身份验证和授权TTL。
-
在左侧面板中选择 集成 选项卡。
-
选择要为其更改身份验证N TTL和身份验证Z TTL值的集成。
-
导航到 平台设置 部分。
-
在 平台设置 下选择 所有 选项卡的默认值。
note note NOTE 如果要更改平台类别或特定平台的 AuthN TTL 和 AuthZ TTL 的持续时间,请相应地选择平台。
更改所有平台上的AuthN TTL AuthZ TTL持续时间
A. AuthN TTL属性B. AuthZ TTL属性
-
选择向上和向下箭头可调整 AuthN TTL 和 AuthZ TTL 属性中天数、小时数、分钟数和秒数的持续时间。
只有在 查看和推送更改 之后,才会更新所有平台上的 AuthN TTL 和AuthZ TTL的持续时间。
启用平台SSO
按照以下步骤为特定集成和平台启用或禁用SSO。
-
在左侧面板中选择 集成 选项卡。
-
选择要为其启用或禁用单点登录的集成。
-
导航到 平台设置 部分。
-
选择要在 平台设置 下启用单点登录的特定平台或平台类别。
为特定平台启用单点登录
A.单点登录属性 B. 强制平台权限属性
-
从 启用单点登录 下拉菜单中选择 是 启用或 否 禁用。
-
从 强制平台权限 下拉菜单中选择 是 启用或 否 禁用。
强制平台权限属性控制是否遵循用户对其电视提供商订阅 允许 或 拒绝 平台访问的决定。
例如,如果同时启用了 启用单点登录 和强制平台权限,并且用户选择拒绝平台访问其电视提供商订阅,则相应的应用程序(频道)将无法使用由其他应用程序(频道)获得的Adobe Pass身份验证令牌。
仅在 查看和推送更改 之后,才能启用或禁用所选平台的单点登录属性。
启用基于主目录的身份验证
按照以下步骤为基于OAuth2的MVPD启用或禁用基于主目录的身份验证。
-
在左侧面板中选择 集成 选项卡。
-
选择要为其启用或禁用基于主目录的身份验证的集成。
-
导航到 平台设置 部分。
-
选择要在 平台设置 下启用基于主页的身份验证的特定平台或平台类别。
为特定平台启用基于主目录的身份验证
A.尝试HBA属性B. HBA AuthN TTL属性
-
从 尝试HBA 下拉菜单中选择 是 启用和 否 禁用。
只有在 查看和推送更改 之后,才能启用或禁用特定MVPD的尝试HBA属性。
添加更多属性 add-more-properties
添加更多属性允许灵活地为集成包含其他特定属性,尤其是不太常见的流。
您可以添加以下属性:
- 对于所有平台,选择左侧所有 选项卡的 默认值。
- 对于平台类别,请选择左侧的桌面设备、移动设备或 TV连接设备 选项卡。
- 对于特定设备,请选择左侧的iOS、Android、tvOS、Roku或 FireTV 选项卡。
以下是可以通过添加这些属性启用的不同流的一些示例:
更改预授权资源的数量
默认情况下,大多数MVPD支持最多使用5个资源ID的预检authZ调用。
但是,如果MVPD同意提高此限制,则可以导航到添加更多属性,然后从选项菜单中选择预检最大资源。
预检最大资源将添加新的属性,以便指定与MVPD商定的限制。
添加预检最大资源属性
预检最大资源属性仅在审核和推送更改之后添加。
更改MVPD显示名称或徽标URL
对于不想构建其MVPD选取器而是依赖所提供的配置的程序员应用程序,您可以导航到 添加更多属性 并选择 显示名称 或 徽标URL 以从选项菜单为每个MVPD添加所需的显示名称或徽标URL。
这些属性的不同值可用于相同的MVPD,具体取决于设备平台和所需的用户体验。
添加显示名称或徽标URL属性
显示名称或 徽标URL 属性仅在审阅和推送更改之后添加。
在应用程序(渠道)切换时请求新的身份验证流程
如果要在用户在不同应用程序之间切换时强制进行新身份验证。 在这种情况下,您可以导航到添加更多属性,选择 每个聚合器的身份验证 属性。
为每个聚合器 添加 身份验证会有效地中断相应渠道的单点登录。
为每个聚合器属性添加身份验证
仅在 审阅和推送更改 之后才会添加每个聚合器的身份验证属性。
添加后,选择 是 为选定的集成启用每个聚合器的 身份验证 属性。
删除属性 delete-properties
选择 每个属性右侧的
只有在 审阅和推送更改 后,属性才会从平台设置部分中删除。
用户元数据 user-metadata
在此部分中,您可以更新MVPD共享的每个用户元数据参数的设置。
用户元数据部分显示以下列:
密钥:表示要在API中用于提取值的实际用户元数据参数。
描述:提供每个用户元数据参数的简短描述。
Encrypted:此列允许您通过分别从下拉菜单中选择 是 或 否 来启用或禁用API中的参数。 选择 是 表示将在API中加密参数值。 使用由 用户元数据 作用域定义的证书执行加密。
已启用:此列允许您通过从下拉菜单中分别选择 是 或 否 来启用或禁用API中的参数。
可用于用户元数据的参数
创建新集成 create-new-integration
要在当前设置中创建与新MVPD的新集成,请执行以下步骤:
-
在左侧面板中选择 集成 选项卡。
-
选择 集成 部分的右上角的新建集成。
创建新集成
将显示以下部分:
选择渠道和MVPD
从 选择渠道 下拉菜单中选择一个 渠道 以添加新集成。 选择渠道后,从 选择MVPD 下拉菜单中选择所需的 MVPD 以便与所选渠道集成。
选择渠道和MVPD
选择端点
选择所需的MVPD后,选择端点部分将预填充为该特定MVPD配置的默认端点。
note important IMPORTANT 除非MVPD特别说明,否则请勿更改任何流中的默认端点。
选择端点
其他信息
此部分包括需要在 选择渠道和MVPD 部分中为所选MVPD配置的各种属性。
note note NOTE 根据 选择渠道和MVPD 部分中选择的MVPD,实际属性可能会有所不同。 例如,您可以在下图的MVPD登录页面上编辑 AuthN TTL 或合作伙伴ID (渠道ID)以用于品牌联合。
编辑其他信息
选择 新建集成 部分的右上角的保存集成。
只有在审核并推送更改之后才会创建新集成。
禁用集成 disable-integration
要禁用集成,请执行以下步骤:
-
在左侧面板中选择 集成 选项卡。
-
选择要禁用的集成。
-
禁用所选集成右上角的切换。
禁用集成
只有在审阅并推送更改后,才会禁用该集成。
禁用集成后,最终用户将无法使用特定的MVPD进行身份验证或授权。