Decisiones decisions
Las decisiones las genera la autenticación de Adobe Pass API REST V2 en función de las consultas de autorización o preautorización de MVPD del usuario, lo que determina si se concede o deniega el acceso al contenido protegido.
Existen dos tipos de decisiones que se proporcionan, según la API invocada:
- Decisiones de preautorización que son decisiones informativas.
- Decisiones de autorización que son decisiones autorizadas.
Decisiones de preautorización preauthorization-decisions
La decisión de preautorización es una decisión informativa que permite informar a la aplicación cliente de si MVPD puede permitir o denegar el acceso del usuario a un recurso protegido.
El propósito de la preautorización (autorización de comprobación preliminar) es permitir que la aplicación muestre información precisa sobre el contenido que el usuario puede tener derecho a ver. Esto se logra mejorando la interfaz de usuario con indicadores, como los iconos bloqueados o desbloqueados, para reflejar el estado del acceso.
El uso de la API de preautorización no es obligatorio, la aplicación cliente puede omitirlo si desea presentar un catálogo de recursos sin ningún filtro.
Si la aplicación cliente pretende utilizar esta función, es importante tener en cuenta que las decisiones de preautorización solo se pueden obtener para un número limitado de recursos por solicitud de API, normalmente hasta 5.
Las MVPD pueden admitir la preautorización a través de varios mecanismos, cada uno con implicaciones distintas para el rendimiento y el número máximo de recursos que se pueden administrar en una sola solicitud de API.
Para obtener más información sobre los mecanismos existentes que admiten la preautorización, consulte la Autorización de comprobaciones de MVPD.
Decisiones de autorización authorization-decisions
La decisión de autorización es una decisión autorizada que permite que la aplicación cliente cumpla con la decisión de MVPD de permitir o denegar el acceso del usuario a un recurso protegido.
El propósito de la autorización es permitir que la aplicación reproduzca los recursos solicitados por el usuario, después de la validación de los derechos con el MVPD y de recibir un token de medios de la autenticación de Adobe Pass.
El uso de la API de autorización es obligatorio, la aplicación cliente no puede omitir esta fase si desea reproducir recursos que el usuario solicita, ya que requiere verificar con la MVPD que el usuario tiene derecho antes de liberar el flujo.
Es importante tener en cuenta que las decisiones de autorización solo se pueden obtener para un número limitado de recursos por solicitud de API, normalmente 1.
Administración del tiempo de vida de la autorización (TTL) authorization-ttl-management
Tiempo de vida de autorización (TTL) define cuánto tiempo permanece autorizado un recurso antes de tener que volver a autorizarlo. Este periodo de tiempo es limitado y debe acordarse con los representantes de MVPD. Los valores TTL pueden variar en función de lo siguiente:
- Categoría de plataforma (por ejemplo, escritorio, móvil, dispositivos conectados a TV)
- Plataforma específica (por ejemplo, iOS, Android, tvOS, Roku, FireTV)
El TTL de autorización (authZ) se puede ver y cambiar a través del panel de TVE de Adobe Pass por uno de los administradores de la organización o por un representante de autenticación de Adobe Pass que actúe en su nombre.
Para obtener más información, consulte la Guía del usuario sobre integraciones de paneles de TVE.
Recursos protegidos protected-resources
Los recursos protegidos se refieren a contenido transmisible, identificado por valores únicos definidos a través de acuerdos entre MVPD y los programadores participantes.
Los recursos protegidos siguen una estructura de árbol jerárquica, y cada nivel proporciona una mayor granularidad para la autorización de contenido:
- Red
- Canal
- Mostrar
- Episodio
- Recurso
- Episodio
- Mostrar
- Canal
CDATA en caso de preautorización, ya que se utilizan principalmente para recursos de nivel de recurso definidos por un MRSS.Identificador de recurso resource-identifier
El identificador único del recurso puede tener dos formatos:
- Un formato de cadena simple, como un identificador único de un canal (marca).
- Un formato RSS (RSS) multimedia que contiene información adicional, como el título, las clasificaciones y los metadatos de control parental.
En el caso de un identificador de recurso simple, como "REF30" (se supone que representa un canal), se puede traducir en un identificador de recurso RSS de la siguiente manera:
<rss version="2.0">
<channel>
<title>REF30</title>
</channel>
</rss>
En el caso de un identificador de recurso más complejo, el identificador de recurso RSS puede incluir información de clasificación adicional de la siguiente manera:
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
<channel>
<title>REF30</title>
<media:rating scheme="urn:mpaa">pg</media:rating>
</channel>
</rss>
Los identificadores únicos son principalmente opacos para la autenticación de Adobe Pass, sin embargo, los transformadores pueden aplicarse en función de las capacidades y los requisitos de MVPD. Si MVPD no puede reconocer o analizar un identificador de recurso, devuelve un error a Autenticación de Adobe Pass, que posteriormente retransmite el error a la aplicación cliente mediante un Código de error mejorado.
API DE REST V2 rest-api-v2
Las decisiones de preautorización se pueden recuperar mediante la siguiente API:
Las decisiones de autorización se pueden recuperar mediante la siguiente API:
Consulte las secciones Respuesta y Ejemplos de las API anteriores para comprender la estructura de las decisiones de autorización y preautorización.
Para obtener más información acerca de cómo y cuándo integrar las API anteriores, consulte los siguientes documentos: