集成

NOTE
此页面上的内容仅供参考。 使用此API需要来自Adobe的当前许可证。 不允许未经授权使用。

TVE仪表板的​ 集成 ​部分允许您查看和管理渠道与MVPD之间的集成设置。 您还可以根据需要创建新的集成

左侧面板中的​ 集成 ​选项卡显示现有集成的列表,详细信息如下:

  • 指示集成当前是活动还是不活动的状态
  • 将特定渠道与相应的MVPD关联的集成
  • 具有渠道ID的渠道名称
  • MVPD显示名称和MVPD ID

现有集成的列表

现有集成的列表

在列表上方的​ 搜索 ​栏中键入渠道或MVPD的名称,了解有关集成的详细信息。

管理集成配置 manage-integration-conf

请按照以下步骤管理特定集成。

  1. 在左侧面板中选择​ 集成 ​选项卡。

  2. 从提供的列表中选择集成,以查看和编辑以下部分中的各种设置:

IMPORTANT
查看查看并推送更改以了解有关激活配置更改的详细信息。

端点选择 endpoint-selection

此部分允许您从各自的下拉菜单中选择用于身份验证、授权和注销流的MVPD端点。

身份验证、授权和注销流的 端点

身份验证、授权和注销流的​ 端点

NOTE
MVPD可以为每个流提供一个或多个端点。 在集成新通道时,MVPD必须为每个流指定其首选端点。
IMPORTANT
对端点进行的任何更改都将影响集成的整体行为。 只有在收到MVPD的确认后,才应实施这些更改。

平台设置 platform-settings

此部分允许您查看和编辑所有平台上的集成设置。 您可以根据各个平台更改这些设置。 例如,您可以调整Android上的授权TTL持续时间,同时保留另一个平台的默认值。

平台设置中的每个属性都继承了MVPD设置的默认值,但如有必要,可以调整该值。

IMPORTANT
要确定为平台设置中的每个属性设置的值,需要与MVPD达成协议。
IMPORTANT
设置继承遵循从MVPD设置(最常用)、MVPD端点、集成、平台类别和platform(包含最具体的值)开始的链。

平台设置 ​用于覆盖继承链中每个级别的设置。 链中的可用级别分组如下:

  • Default for All:如果未定义特定平台值,则为适用于所有平台的属性设置值,而不管程序员的实施如何。

  • 台式机设备:设置适用于所有台式机和笔记本电脑的属性值,不考虑编程方法(JS SDK或REST API)。

  • 移动设备:设置适用于所有移动设备的属性值,包括​ iOSAndroid ​和其他设备,而不管编程方法如何(SDK或REST API)。

  • TV连接设备:设置适用于所有电视连接设备的属性值,包括​ tvOSRokuFireTV ​和其他设备,不考虑编程方法(SDK或REST API)。

  • 未识别的设备:设置适用于当前机制无法准确识别平台的所有设备的属性值。 在这种情况下,应用MVPD定义的最严格的规则。

    平台及其设备的类别

    平台及其设备的类别

选择 位于每个属性右侧的 继承链图标 {width="25"}图标可浏览用于上述每个继承级别的属性。

最常用的业务流程 most-used-flows

平台设置 ​部分提供用于不同业务流程的一系列属性。 实际属性可能因特定集成中选择的MVPD而异。 以下是最常用的流:

跨所有平台的​ AuthN TTL和AuthZ TTL

IMPORTANT
身份验证(AuthN) TTL和授权(AuthZ) TTL值必须与MVPD设置一致。

按照以下步骤更改特定集成在所有平台上的身份验证和授权TTL。

  1. 在左侧面板中选择​ 集成 ​选项卡。

  2. 选择要为其更改身份验证N TTL和身份验证Z TTL值的集成。

  3. 导航到​ 平台设置 ​部分。

  4. 在​ 平台设置 ​下选择​ 所有 ​选项卡的默认值。

    note note
    NOTE
    如果要更改平台类别或特定平台的​ AuthN TTL ​和​ AuthZ TTL ​的持续时间,请相应地选择平台。

    更改所有平台上的AuthN TTL AuthZ TTL持续时间

    更改所有平台上的AuthN TTL AuthZ TTL持续时间

    A. AuthN TTL属性​ B. AuthZ TTL属性

  5. 选择向上和向下箭头可调整​ AuthN TTL ​和​ AuthZ TTL ​属性中天数、小时数、分钟数和秒数的持续时间。

只有在查看和推送更改之后,才会更新所有平台上的​ AuthN TTL ​和​ AuthZ TTL ​的持续时间。

启用平台SSO

IMPORTANT
在​ iOS、tvOS、Roku和FireTV 平台上专门支持启用单点登录 ​属性。 它仅适用于与支持这些平台单点登录的MVPD的集成。

按照以下步骤为特定集成和平台启用或禁用SSO。

  1. 在左侧面板中选择​ 集成 ​选项卡。

  2. 选择要为其启用或禁用单点登录的集成。

  3. 导航到​ 平台设置 ​部分。

  4. 选择要在​ 平台设置 ​下启用单点登录的特定平台或平台类别。

    为特定平台启用单点登录

    为特定平台启用单点登录

    A. ​单点登录属性​ B. ​强制平台权限属性

  5. 从​ 启用单点登录 ​下拉菜单中选择​ ​启用或​ ​禁用。

  6. 从​ 强制平台权限 ​下拉菜单中选择​ ​启用或​ ​禁用。

    强制平台权限 ​属性控制是否遵循用户对其电视提供商订阅​ 允许 ​或​ 拒绝 ​平台访问的决定。

    例如,如果同时启用了​ 启用单点登录 ​和​ 强制平台权限,并且用户选择拒绝平台访问其电视提供商订阅,则相应的应用程序(频道)将无法使用由其他应用程序(频道)获得的Adobe Pass身份验证令牌。

仅在查看和推送更改之后,才能启用或禁用所选平台的​ 单点登录 ​属性。

启用基于主目录的身份验证

按照以下步骤为基于OAuth2的MVPD启用或禁用基于主目录的身份验证。

  1. 在左侧面板中选择​ 集成 ​选项卡。

  2. 选择要为其启用或禁用基于主目录的身份验证的集成。

  3. 导航到​ 平台设置 ​部分。

  4. 选择要在​ 平台设置 ​下启用基于主页的身份验证的特定平台或平台类别。

    为特定平台启用基于主目录的身份验证

    为特定平台启用基于主目录的身份验证

    A. ​尝试HBA属性​ B. HBA AuthN TTL属性

  5. 从​ 尝试HBA ​下拉菜单中选择​ ​启用和​ ​禁用。

IMPORTANT
应避免更改​ HBA AuthN TTL ​属性的持续时间。 它可能会导致授权过程中出现意外故障。

只有在查看和推送更改之后,才能启用或禁用特定MVPD的​ 尝试HBA ​属性。

添加更多属性 add-more-properties

添加更多属性 ​允许灵活地为集成包含其他特定属性,尤其是不太常见的流。

您可以添加以下属性:

  • 对于所有平台,选择左侧所有​ 选项卡的 ​默认值。
  • 对于平台类别,请选择左侧的​ 桌面设备移动设备 ​或​ TV连接设备 ​选项卡。
  • 对于特定设备,请选择左侧的​ iOSAndroidtvOSRoku ​或​ FireTV ​选项卡。

以下是可以通过添加这些属性启用的不同流的一些示例:

更改预授权资源的数量

默认情况下,大多数MVPD支持最多使用5个资源ID的预检authZ调用。
但是,如果MVPD同意提高此限制,则可以导航到​ 添加更多属性,然后从选项菜单中选择​ 预检最大资源

预检最大资源 ​将添加新的属性,可以指定与MVPD商定的限制。

添加预检最大资源属性

添加预检最大资源属性

预检最大资源 ​属性仅在审核和推送更改之后添加。

更改MVPD显示名称或徽标URL

对于不想构建其MVPD选取器而是依赖所提供的配置的程序员应用程序,您可以导航到​ 添加更多属性 ​并选择​ 显示名称 ​或​ 徽标URL ​以从选项菜单为每个MVPD添加所需的显示名称或徽标URL。

这些属性的不同值可用于相同的MVPD,具体取决于设备平台和所需的用户体验。

添加显示名称或徽标URL属性

添加显示名称或徽标URL属性

显示名称 ​或​ 徽标URL ​属性仅在审阅和推送更改之后添加。

在应用程序(渠道)切换时请求新的身份验证流程

如果要在用户在不同应用程序之间切换时强制进行新身份验证。 在这种情况下,您可以导航到​ 添加更多属性,选择​ 每个聚合器的身份验证 ​属性。

为每个聚合器​ 添加 ​身份验证会有效地中断相应渠道的单点登录。

为每个聚合器属性添加身份验证

为每个聚合器属性添加身份验证

仅在审阅和推送更改之后才会添加每个聚合器​ 的身份验证 ​属性。

添加后,选择​ ​为选定的集成启用每个聚合器的​ 身份验证 ​属性。

删除属性 delete-properties

选择 每个属性右侧的 “删除属性”按钮 {width="25"}图标用于删除不再需要的属性。

NOTE
无法删除某些属性,因为它们是所选MVPD的必需要求。

只有在审阅和推送更改后,属性才会从​ 平台设置 ​部分中删除。

用户元数据 user-metadata

此部分允许您更新MVPD共享的每个用户元数据参数的设置。

NOTE
每个MVPD可以共享不同的参数。 有关特定MVPD可以共享的参数的更多信息,请联系您的Adobe代表。

用户元数据部分显示以下列:

密钥:表示要在API中用于提取值的实际用户元数据参数。

描述:提供每个用户元数据参数的简短描述。

Encrypted:此列允许您通过分别从下拉菜单中选择​ ​或​ ​来启用或禁用API中的参数。 选择​ ​表示将在API中加密参数值。 使用由​ 用户元数据 ​作用域定义的证书执行加密。

TIP
始终确保​ ZIP ​参数已加密。

了解有关程序员渠道部分中的可用证书的详细信息。

已启用:此列允许您通过从下拉菜单中分别选择​ ​或​ ​来启用或禁用API中的参数。

可用于用户元数据的参数

可用于用户元数据的参数

创建新集成 create-new-integration

要在当前设置中创建与新MVPD的新集成,请执行以下步骤:

  1. 在左侧面板中选择​ 集成 ​选项卡。

  2. 选择​ 集成 ​部分的右上角的​ 新建集成

    创建新集成

    创建新集成

    将显示以下部分:

    选择通道和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

要禁用集成,请执行以下步骤:

  1. 在左侧面板中选择​ 集成 ​选项卡。

  2. 选择要禁用的集成。

  3. 禁用所选集成右上角的切换。

    禁用集成

    禁用集成

只有在审阅并推送更改后,才会禁用该集成。

禁用集成后,最终用户将无法使用特定的MVPD进行身份验证或授权。

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b