Primetime TVE仪表板用户指南 tve-db-user-guide
简介 tve-db-intro
Adobe 动态仪表板（动态仪表板） 是一个自助仪表板，面向为与Adobe Pass身份验证产品团队有业务关系的媒体公司（程序员）工作的用户。
请联系您的技术客户经理(TAM)以获取访问权限。 要获得访问权限，您需要在Adobe Marketing Cloud组织中配置两个新用户组：
- TVE仪表板读写 — 此组的成员对仪表板的所有可编辑部分具有完全权限
- TVE仪表板只读 — 此组的成员在整个仪表板中仅具有查看权限
在深入研究本用户指南之前，我们建议您浏览以下资源，以便很好地了解Adobe Pass身份验证产品团队提供的流程和功能，并熟悉本文档中使用的术语：
继续本用户指南的后续部分，您将发现如何为公司的渠道、程序员或渠道与MVPD（多渠道视频项目分发商）之间的集成管理不同的设置。
图1： Adobe Primetime TVE功能板“基本/高级工作区”下拉列表
环境 authn-environments
根据用户可能需要执行的任务，可能需要在Adobe Pass身份验证环境之间切换。 有关Adobe Pass身份验证环境的详细信息，请参阅以下文档： 了解Adobe Pass身份验证环境.
TVE Dashboard提供两个名为Prequal (Prequalification)和Release的环境，每个环境都有两个名为Staging和Production的用户档案，如下所示：
要在环境之间切换，用户可以单击下面描述的下拉元素中由条目表示的所需环境：
图2： Adobe Pass TVE功能板环境下拉列表
要通过TVE仪表板对Adobe Pass身份验证配置进行管理更改，请执行以下操作：
- 在中执行更改 发布暂存并验证它们.
- 在中执行更改 前期生产并验证它们.
- 在中执行更改 发布生产环境并验证它们.
图3： Adobe Primetime TVE功能板审核和推送更改通知
区域 sections
为媒体公司工作的用户（程序员）可以从侧栏访问TVE仪表板的以下部分：
- 渠道 — 包含与内容提供商相关的设置
- 程序员 — 包含与聚合一个或多个父组织相关的设置 渠道
- 集成 — 包含与之间的集成相关的设置 渠道 和 MVPDs
- MVPDs — 包含与可用的相关的设置 MVPDs
- 报表 — 包含三种类型报表的聚合数据：AuthN TTL、AuthZ TTL、SSO
- 更改日志 — 包含应用于TVE仪表板配置的最新修改
图4： Adobe Primetime TVE仪表板部分
渠道 tve-db-channels-section
此部分允许查看和编辑可用渠道的设置或创建新渠道。 单击其中一个可用渠道将返回一个包含以下选项卡的屏幕：
-
渠道数据
- 渠道ID — 我们系统中使用的渠道的唯一ID，也称为“请求者ID”。
- 显示名称 — 渠道的商业名称。
-
常规设置
- Analytics配置 — 配置要转发到Adobe Analytics的Adobe Pass身份验证事件。 有关在启用此功能之前需要如何配置报表包ID (RSID)的更多详细信息，请与Adobe联系。
-
证书
包含身份验证流程中使用的证书列表及其颁发组织、颁发日期和到期日期。 这些证书用作私钥/公钥，并用于验证目的。
-
域
包含域列表，相应的渠道将通过这些域与Adobe Pass身份验证进行通信。
-
集成
包含与可用MVPD的集成的列表，以及每个可能启用的或未启用的集成的状态。 单击特定条目即可导航到集成页面。
-
已注册的应用程序
包含应用程序注册列表。 有关更多详细信息，请查看文档 动态客户端注册管理.
-
自定义架构
包含自定义方案的列表。 有关更多详细信息，请参阅 iOS/tvOS应用程序注册 和 动态客户端注册管理
添加/删除域 add-delete-domains
要启动为所选渠道添加新域的过程，您需要单击“域”列表下方的“添加新域”按钮。 这将创建一个新的域条目，您可以在其中指定域名。 如果域列表中已存在更通用的域，则不应添加新子域。
图：通道中的“域”选项卡
程序员 tve-db-programmers-section
此部分允许查看和编辑可用程序员的设置或创建新设置。 单击其中一个可用的程序员将返回一个包含以下选项卡的屏幕：
-
程序员数据
- 程序员ID — 系统中使用的程序员的唯一ID。
- 显示名称 — 程序员的商业名称。
- 徽标URL — 程序员的商业徽标统一资源定位器(URL)。
- 徽标预览 — 通过从上述统一资源定位器(URL)下载程序员的商业徽标预览。
-
证书
包含身份验证流程中使用的证书列表及其颁发组织、颁发日期和到期日期。 这些证书用作私钥/公钥，并用于验证目的。
-
渠道
包含属于此特定程序员的渠道列表。 单击特定条目，即可使用导航到渠道部分。
-
已注册的应用程序
包含应用程序注册列表。 有关更多详细信息，请参阅 动态客户端注册管理.
-
自定义架构
包含自定义方案的列表。 有关更多详细信息，请参阅 iOS/tvOS应用程序注册 和 动态客户端注册管理.
集成 tve-db-integrations-sec
此部分允许查看和编辑渠道与可用MVPD之间集成的设置，或创建新渠道。 使用基本工作区时，单击其中一个可用集成将返回单个页面，或使用高级工作区时，将返回具有以下选项卡的屏幕：
-
集成数据
- 集成ID — 将MVPD的唯一ID附加到以“_”字符分隔的渠道的唯一ID的结果。
- 渠道显示名称 — 渠道的商业名称。
- 渠道ID — 我们系统中使用的渠道的唯一ID，也称为“请求者ID”。
- MVPD显示名称 - MVPD的商业名称。
- MVPD Id — 系统中使用的MVPD的唯一ID。
-
常规设置
- 用户元数据键 — 配置可用于特定集成的元数据键。
- 平台特定的设置 — 为特定平台配置不同的设置（例如，TTL、SSO和IFrames）。
-
身份验证设置
- 包含与Adobe Pass身份验证功能相关的设置。
-
授权设置
- 包含与Adobe Pass身份验证授权功能相关的设置。
-
注销设置
- 包含与Adobe Pass身份验证注销功能相关的设置。
创建集成 create-integration
要创建新集成，请执行以下步骤：
- 单击“添加新集成”按钮
- 搜索并选择渠道
- 搜索并选择MVPD
- 等待TVE功能板计算“集成ID”并显示可用的MVPD端点
- 选择身份验证、授权和注销端点或使用默认值
- 单击“创建集成”按钮
- 根据MVPD设置，可能会出现弹出窗口并询问其他属性，这些属性应由MVPD预先提供，否则将重定向到新创建的集成页面
图5. Adobe Primetime TVE功能板新集成窗口
更新集成 update-integration
要更新现有集成，请在集成部分或渠道部分（包含集成选项卡）中单击该特定集成的表条目。
使用基本工作区模式时，此部分将允许查看和编辑最常更新的设置，例如身份验证和授权令牌TTL（生存时间）以及iFrame设置。 请记住，与支持动态定义的令牌持久性TTL的MVPD的集成可能缺少TTL设置(请参阅中的条目1.19 MVPD集成要求)。
使用高级工作区模式时，此部分将允许查看和编辑不太常见的设置。
在基本和高级工作区模式中，这些设置可以在平台级别更改（例如，在Android上选择授权TTL令牌的自定义值，默认设置在所有其他平台上）。
图6. Adobe Primetime TVE功能板属性继承链组件
平台特定的设置 platform-sp-settings
此子部分可用于覆盖特定平台的设置。 可用的平台包括：
- 所有平台 — 设置将应用于所有平台的值，不考虑程序员实施，以防没有为特定平台设置其他值。
- Android — 设置将通过Adobe Pass身份验证Android SDK应用于程序员实施的值。
- 无客户端REST API — 设置将通过Adobe Pass身份验证REST API应用于程序员实施的值。
- Fire TV — 设置将通过Adobe Pass Authentication FireTV SDK应用于程序员实施的值。
- FLASHSDK — 此平台已弃用。 已弃用
- JavaScript SDK — 设置将通过Adobe Pass身份验证JavaScript SDK应用于程序员实施的值。
- Roku — 设置将通过Adobe Pass身份验证REST API应用于程序员实施的值，并将发送“Roku”作为设备类型。 对于Roku设备，其优先于为无客户端REST API平台设置的值。
- Xbox本机SDK — 此平台已弃用。 已弃用
- Xbox 360 REST API — 设置将通过Adobe Pass身份验证REST API应用于程序员实施的值，并将发送“xbox”作为设备类型。 对于Xbox 360设备，其优先级高于为无客户端REST API平台设置的值。
- Xbox One REST API — 设置将通过Adobe Pass身份验证REST API应用于程序员实施的值，并将发送“xboxOne”作为设备类型。 对于XboxOne设备，其优先级高于为无客户端REST Api平台设置的值。
- iOS — 设置将通过Adobe Pass身份验证iOS SDK应用于程序员实施的值。
- tvOS — 设置将应用于Adobe Pass身份验证tvOS SDK上的程序员实施的值。
图7. Adobe Primetime TVE功能板平台特定的设置
启用Platform单点登录 enable-platform-sso
请按照以下步骤为特定集成和平台启用/禁用单点登录：
-
确保您使用的是高级工作区模式
-
导航到所需的集成
-
导航至 常规设置 选项卡
-
选择要启用或禁用单点登录的所需平台
-
切换 启用单点登录 标记到所需的值（是/否）
note important IMPORTANT 请务必注意 启用单点登录 标记仅适用于iOS、tvOS、Roku和FireTV平台，并且仅适用于与在这些平台上支持单点登录的MVPD的集成。 -
切换 强制平台权限 标记到所需的值（是/否）
note important IMPORTANT 请务必注意 强制平台权限 标记控制是否强制用户允许或拒绝平台访问其电视提供商订阅。 考虑以下情况 启用单点登录 标志设置为“是”， 强制平台权限 标志也设置为“是”，并且用户选择拒绝平台访问他/她的电视提供商订阅，则相应的应用程序（频道）将无法使用由其他应用程序（频道）获得的Adobe Pass身份验证令牌。
启用基于家庭的身份验证 enable-hba
请按照以下步骤启用/禁用家庭身份验证 OAuth2 基于MVPD：
- 确保您使用的是高级工作区模式
- 导航到所需的集成
- 导航到 身份验证设置 选项卡
- 导航到 AuthN动态规则 子选项卡
- 切换 尝试HBA 标记到所需的值（是/否）
联系 tve-support@adobe.com 有关为基于SAML的MVPD启用Home-Base身份验证的信息。
MVPDs tve-db-mvpds-sec
此部分允许查看可用MVPD的设置。 单击其中一个可用的MVPD将返回一个包含以下选项卡的屏幕：
-
MVPD数据
- MVPD Id — 系统中使用的MVPD的唯一ID。
- 显示名称 - MVPD的商业名称，可在用户的选取器中使用。
- 徽标URL - MVPD的商业徽标统一资源定位器(URL)。
- 徽标预览 - MVPD的商业徽标预览，可从上述统一资源定位器(URL)下载。
-
常规设置
-
用户元数据键
- 可用于特定MVPD的元数据键。
-
客户端数据属性
- 身份验证/汇总 — 如果设置为“是”，则用户尝试访问的每个新渠道都需要一个新的身份验证令牌。
- 已启用被动身份验证 — 如果Auth/Aggregator标志设置为“Yes”，并且Passive AuthN Enabled设置为“Yes”，则后台将执行其他渠道的身份验证过程，而无需完全重定向浏览器并显示选取器。
- 身份验证/浏览器会话 — 如果设置为“是”，则在关闭浏览器后，用户将被注销。 如果设置为“否”，则用户可以重新启动浏览器并保持登录状态。
- 需要IFrame — 如果设置为“是”，则表示MVPD登录窗口需要iFrame。 “iFrame宽度”和“iFrame高度”字段表示加载MVPD登录页面的iFrame所需的大小。
-
-
身份验证设置
- 选择端点
- 此字段指示MVPD公开的身份验证终结点。 端点可以因所使用的身份验证协议而异。
- AuthN常规设置
- 此子选项卡显示MVPD使用的验证协议和协议相关信息。
- AuthN证书
- 此子选项卡显示MVPD在身份验证流中使用的证书及其颁发者组织、颁发日期和到期日期。 这些证书用作私钥/公钥，并用于验证目的。
- AuthN动态规则
- 此子选项卡显示应用于身份验证进程的规则。 按下图表的请求/响应/令牌后，您可以看到高亮显示应用于该部分身份验证流程的参数。
- 选择端点
-
授权设置
-
选择端点
- 此字段指示MVPD公开的授权终结点。 端点可能会因所使用的授权协议而异。 可用的授权协议有SOAP、REST（用于无客户端设备）、SAML、XACML和OAUTH。
-
AuthZ常规设置
- 此子选项卡显示MVPD使用的授权协议和协议相关信息。
- 印前检查配置
- 它描述在一次调用中可由MVPD预授权的资源数量、使用的PreFlight模型以及超时阈值。 有时，给定集成的资源数量可能不同。 可通过编辑''对其进行管理 预检资源的最大数量”属性，该属性位于“常规设置”选项卡下。 此属性仅适用于给定的集成，如果设置，将使用该属性，而不是授权设置 — > PreFlight配置 — > PreFlight最大资源中定义的值。
- DOS保护
- 它描述了MVPD授权端点上的拒绝服务保护。 有关每个字段的详细说明，请将鼠标悬停在DOS保护字段上以查看工具提示。
- 如果MVPD是 临时传递，然后 AuthZ常规设置 还包含有关TempPass持续时间的信息。
- 如果MVPD是 FlexibleTempPass，然后 AuthZ常规设置 还包含有关TempPass持续时间、最大资源数和标识字段的信息（请参阅下图）。
-
AuthZ证书
- 此子选项卡显示MVPD在授权流中使用的证书及其颁发者组织、颁发日期和到期日期。 这些证书用作私钥/公钥，并用于验证目的。
-
AuthZ动态规则
- 此子选项卡显示应用于授权进程的规则。 按下图表的 请求/响应/令牌，您可以看到高亮显示的应用于该部分授权流的参数。
-
-
注销设置
-
选择端点
-
此字段指示MVPD公开的注销终结点。 提供的协议可以是SAML或OAuth2。
-
注销常规设置
- 此子选项卡显示MVPD使用的注销协议和协议相关信息。
- 需要已签名的注销响应 — 如果设置为“是”，则响应必须由受信任的证书签名。
-
注销证书
- 此子选项卡显示MVPD在注销流中使用的证书及其颁发者组织、颁发日期和到期日期。 这些证书用作私钥/公钥，并用于验证目的。
-
注销动态规则
- 此子选项卡显示适用于注销流程的规则。 按下图表的 请求/响应/令牌，则您会看到高亮显示的应用于该部分注销流的参数。
-
-
报告 tve-db-reports-sec
要导航到此部分，请单击“仪表板节”菜单。 该操作将导航到包含3个选项卡的屏幕，以下子部分将详细介绍这些选项卡： AuthN TTL报表， AuthZ TTL报表， SSO报告.
此部分允许您查看和导出多种类型报表的聚合数据，这些报表用于您在所有平台上与各种MVPD的渠道集成。
平台 report-platforms
所有报表汇总以下平台中的值：
浏览器
显示将通过Adobe Pass身份验证JavaScript SDK应用于程序员实施的值。
移动设备：IOS
显示将通过Adobe Pass Authentication iOS SDK应用于程序员实施的值。
移动设备：ANDROID
显示将应用于通过Adobe Pass Authentication Android SDK进行程序员实施的值。
移动设备：其他
显示将应用于通过为移动设备开发的Adobe Pass身份验证REST API实现的程序员的值。
TVCD： ROKU
显示将通过Adobe Pass身份验证REST API应用于程序员实施的值，并将发送“Roku”作为设备类型。
TVCD：FIRETV
显示将通过Adobe Pass Authentication FireTV SDK应用于程序员实施的值。
TVCD： APPLETV
显示将通过Adobe Pass身份验证tvOS SDK应用于程序员实施的值。
TVCD：其他
显示将应用于通过Adobe Pass身份验证REST API为连接电视的设备开发的程序员实施的值。
平台：未知
显示将应用于Adobe Pass身份验证服务检测到未知设备类型的程序员实施的值。
审查机制 传递客户端信息 更改为Adobe Pass身份验证REST API或SDK，以了解有关如何发送所需设备类型（例如“Roku”）的更多详细信息。
所有报表都会根据特定于每个Adobe Pass身份验证环境的配置计算聚合值。 因此，在不同的TVE功能板环境之间切换时，您可能会收到不同的报表数据。
请查阅 环境 部分以了解与Adobe Pass身份验证可用环境相关的更多详细信息。
选择特定渠道/ MVPD selecting-specific-channels-mvpds
通过选择特定渠道或选择要包含在结果报告中的特定MVPD，所有报告都允许使用过滤器。
要选择一个或多个渠道，请使用 下拉列表 放在“为报表选择的渠道”标签之后。 请参见图8。/9./10. 中的图像。
要选择一个或多个MVPD，请使用 下拉列表 放置在“为报告选择的MVPD”标签之后。 请参见图8。/9./10. 中的图像。
默认情况下，会在贵公司的所有渠道（“所有渠道”）以及与之集成的MVPD（“所有MVPD”）之间聚合数据。
如果您选择取消选择“所有渠道”或“所有MVPD”而未选择特定选项，则UI将显示“无数据可用”占位符。
导出报告 export-report
所有报表都允许以逗号分隔值(CSV)格式文件导出数据。
要导出数据，请使用位于窗口右上角的“导出报告”按钮。 请参见图8。/9./10. 中的图像。
名为的文件 Report.csv 将自动下载到您的计算机。 因此，请确保您的浏览器设置允许下载文件。
在计算Report.csv文件时，“导出数据”加载图标将显示在屏幕上，该图标可能占用 到几分钟 取决于要导出的数据大小。
AuthN TTL报表(#authn-ttl-reports)
此报告显示为您的渠道与所有平台上的各种MVPD的集成配置的身份验证令牌的生存时间(TTL)。
身份验证令牌生存时间，也称为 身份验证TTL，以人类可读的值显示，例如： 天、小时、分钟、秒.
就用户体验而言，AuthN TTL报表允许您根据特定MVPD和特定平台直观地检查用户进行身份验证的时间量。
要导航到此类报告，请单击“报告”部分中的“验证TTL报告”选项卡。
图8： Adobe Primetime TVE功能板身份验证N TTL报告选项卡
“AuthN TTL报告”表格包含页面，并可根据屏幕大小进行水平和垂直滚动。
如果您考虑更改AuthN TTL值，请查看 集成 部分。
AuthZ TTL报表 authz-ttl-reports
此报表显示授权令牌的生存时间(TTL)，该令牌是为您的渠道与所有平台上的各种MVPD的集成而配置的。
授权令牌生存时间，也称为 AuthZ TTL，以人类可读的值显示，例如： 天、小时、分钟、秒.
在用户体验方面，AuthZ TTL报表允许您可视地检查针对特定MVPD和特定平台授予用户权限的时间量。
要导航到此类报告，请单击“报告”部分中的“AuthZ TTL报告”选项卡。
图9. Adobe Primetime TVE功能板AuthZ TTL报告选项卡
AuthZ TTL报告表格包含页面，并可根据屏幕大小进行水平和垂直滚动。
如果您考虑更改AuthZ TTL值，请参见 集成 部分。
SSO报告 sso-reports
此报表显示为您的渠道集成配置的“单点登录” (SSO)状态，该渠道集成包含所有平台上的各种MVPD。
单点登录状态，也称为 SSO状态，显示为具有下列可能值的三状态： SSO已禁用，SSO已启用，SSO不确定.
在用户体验方面，SSO报告允许您查看预期的用户身份验证SSO体验，其中考虑特定MVPD和特定平台。
要导航到此类型的报告，请单击“SSO报告”选项卡中的“ ”报表“ ”部分。
图10： Adobe Primetime TVE功能板SSO报告选项卡
“SSO报告”表格包含页面，并可根据屏幕大小进行水平和垂直滚动。
如果您考虑更改SSO状态，请查看 集成 部分。
更改日志 tve-db-changelog-sec
此部分显示通过TVE仪表板推送到Adobe Pass身份验证环境和配置的所有修改的列表。
其中有些列指示推送日期、操作修改的用户以及推送的状态。
此部分还允许比较两个表条目，以缩小要检查的特定修改范围，甚至将比较作为邮件项共享。
反馈 tve-db-feedback-sec
此部分允许用户发送反馈。 请按照以下步骤向Adobe Pass身份验证产品团队提供反馈：
- 单击屏幕右侧的“反馈”按钮
- 输入主题
- 输入消息
- 如果需要，通过单击“上载屏幕快照”按钮，将屏幕快照上载到消息
- 单击“提交”按钮
图11： Adobe Primetime TVE功能板反馈部分
有关如何捕获屏幕快照的说明，请查看以下链接：
故障排除 tve-db-troubleshoot
维护模式 maintenance-mode
图：处于维护模式的TVE应用程序
如果TVE功能板处于“维护模式”，则用户将无法查看或进行新的更改。
如果发生这种情况，则必须等待Adobe Pass身份验证工程团队完成TVE功能板的维护工作。
已降级状态 degraded-state
图：TVE应用程序处于已降级状态
如果TVE仪表板处于“降级状态”，则用户将缺少搜索和排序功能，但用户将能够查看或进行新更改。
如果发生这种情况，则必须等待Adobe Pass身份验证工程团队完成TVE功能板的维护工作。