文档Adobe PassAdobe Pass 身份验证

授权服务监控概述 entitlement-service-monitoring-overview

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
此页面上的内容仅供参考。 使用此API需要来自Adobe的当前许可证。 不允许未经授权使用。

简介 introduction

TVE网站和应用程序需要全天候可用，因此客户需要实时洞察授权事件，以尽快检测和纠正问题。 他们还需要分析每月数据，以确定哪些平台提供了大部分流量，以及哪些平台实施不好和转化率低。

授权服务监控(ESM)为程序员和MVPD提供了数据馈送，可实时查看其身份验证和授权事件。 数据从Adobe Pass身份验证系统中收集，并通过RESTful API提供。 客户可以通过直接方式使用数据，或从他们自己的自定义操作功能板中使用数据。

ESM系统的核心元素是其量度和维度。 ESM会根据维度选择生成包含汇总量度的报表。 由于Adobe Pass事件以PST时区记录，因此ESM报告也以PST时区提供。

ESM API不公开发布。 有关可用性问题，请联系您的Adobe代表。

面向程序员的ESM esm-for-programmers

程序员可以监控以下量度： programmers-monitor-metrics

指标名称
描述
authn-attempts
启动的身份验证流的数量
验证成功
客户端成功获取的身份验证令牌数量
authn-pending
成功生成的身份验证令牌的数量（无论客户端是否实际获取它）
验证失败
通过外部系统执行的身份验证失败的次数。
无客户端令牌
已成功发出的无客户端令牌数量
无客户端故障
尝试从无客户端API接收令牌失败的次数
authz尝试
尝试的授权数
authz成功
成功的授权数
authz失败
应用程序级别的MVPD拒绝的授权数
authz-rejected
Adobe服务提供商认为具有恶意并因DoS攻击预防而拒绝的授权尝试次数
授权延迟
在MVPD端点上花费的总毫秒数
media-tokens
生成的短媒体令牌数量（与播放请求数量相同）
独特帐户
在所选时间间隔内执行授权(AuthN / AuthZ)操作的独特用户数。 （此量度仅在请求每日值时显示。）
这是为每个单独的数据中心计算的。 当未请求“dc”维度时，将不显示此量度。
独特会话
在所选时间间隔内对Adobe Pass身份验证服务执行身份验证流调用的唯一会话数。 （此量度仅在请求每日值时显示。）
这是为每个单独的数据中心计算的。 当未请求“dc”维度时，将不显示此量度。
count
在事件导向报表中使用的简单计数器

程序员可以按以下维度筛选上面列出的量度： progr-filter-metrics

Dimension名称
描述
年
4位数年份
月
月份(1-12)
天
日期(1-31)
小时
一天中的第几个小时
分钟
该小时中的第几分钟
media-company
拥有发起用户权利流程的网站的媒体公司
dc
（数据中心）收到请求的主区域。
代理
代理MVPD（对于直接集成，它为“直接”）
mvpd
负责向用户授予权利的MVPD
请求者ID
用于执行授权请求的请求者ID
渠道
渠道网站，从资源字段提取（从MRSS有效负载中提取作为渠道/标题，如果提供，或映射到资源值，前提是它不是RSS格式）。
resource-id
授权请求中涉及的实际资源标题（从MRSS有效负载提取为项目/标题，如果提供）
设备
设备平台（PC、移动设备、控制台等）
eap
通过外部系统执行身份验证流程时的外部身份验证提供程序。
值可以是：
- N/A - Adobe Pass身份验证
- Apple — 提供身份验证的外部系统是Apple
os系列
设备上运行的操作系统
browser-family
用于访问Adobe Pass身份验证的用户代理
cdt
当前用于无客户端的设备平台（替代）。
值可以是：
- N/A — 事件不是源自无客户端SDK
- Unknown — 由于无客户端API中的deviceType参数是可选的，因此有些调用不包含任何值。
— 通过无客户端API发送的任何其他值，例如xbox、appletv、roku等。
platform-version
无客户端SDK的版本
操作系统类型
设备上运行的操作系统，替代（当前未使用）
browser-version
用户代理版本
nsdk
使用的客户端SDK(android、fireTV、js、iOS、tvOS、非sdk)
nsdk-version
Adobe Pass身份验证客户端SDK的版本
事件
Adobe Pass身份验证事件名称
原因
失败的原因，由Adobe Pass身份验证报告
sso类型
底层SSO机制：platform/passive/adobe。 指示授权令牌是通过在其他应用程序中重用AuthN发出的
平台
设备已识别平台。 可能的值：
- Android
- FireTV
- Roku
- iOS
- tvOS
— 等
application-name
在TVE仪表板中为配置为使用的DCR注册应用程序配置的应用程序名称。
application-version
在TVE仪表板中为配置为使用的DCR注册应用程序配置的应用程序版本。
customer-app
通过设备信息传递的自定义应用程序ID。
内容类别
您的应用程序请求的内容的类别。

MVPD的ESM esm-for-mvpds

MVPD可以监控以下度量：

量度名称
描述
authn-attempts
启动的身份验证流的数量
验证成功
客户端成功获取的身份验证令牌数量
authn-pending
成功生成的身份验证令牌的数量（无论客户端是否实际获取它）
验证失败
通过外部系统执行的身份验证失败的次数。
authz尝试
尝试的授权数
authz成功
成功的授权数
authz失败
应用程序级别的MVPD拒绝的授权数
authz-rejected
Adobe服务提供商认为具有恶意并因DoS攻击预防而拒绝的授权尝试次数
授权延迟
在MVPD端点上花费的总毫秒数

MVPD可以按以下维度过滤上面列出的量度：

Dimension名称
描述
年
4位数年份
月
月份(1-12)
天
日期(1-31)
小时
一天中的第几个小时
分钟
该小时中的第几分钟
mvpd
用于执行授权请求的mvpd ID
请求者ID
用于执行授权请求的请求者ID
eap
通过外部系统执行身份验证流程时的外部身份验证提供程序。
值可以是：
- N/A - Adobe Pass身份验证
- Apple — 提供身份验证的外部系统是Apple
cdt
当前用于无客户端的设备平台（替代）。
值可以是：
- N/A — 事件不是源自无客户端SDK
- Unknown — 由于无客户端API中的deviceType参数是可选的，因此有些调用不包含任何值。
— 通过无客户端API发送的任何其他值，例如xbox、appletv、roku等。
sdk-type
使用的客户端SDK(Flash、HTML5、Android本机、iOS、无客户端SDK等)
平台
设备已识别平台。 可能的值：
- Android
- FireTV
- Roku
- iOS
- tvOS
— 等
nsdk
使用的客户端SDK(android、fireTV、js、iOS、tvOS、非sdk)
nsdk-version
Adobe Pass身份验证客户端SDK的版本

用例 use-cases

您可以将ESM数据用于以下用例：

  • 监控 — 操作或监控团队可以创建每分钟调用一次API的仪表板或图表。 使用显示的信息，他们可以在问题出现的一分钟就检测到问题(Adobe Pass身份验证或MVPD)。

  • 调试/质量测试 — 由于数据也按平台、设备、浏览器和操作系统进行划分，因此分析使用模式可以查明特定组合上的问题（例如，OSX上的Safari）。

  • Analytics — 提供的数据可用于补充/审核通过Adobe Analytics或其他分析工具收集的客户端数据。

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