Decisiones

Última actualización: 5 de marzo de 2025
IMPORTANT
El contenido de esta página se proporciona únicamente con fines informativos. El uso de esta API requiere una licencia actual de Adobe. No se permite el uso no autorizado.

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

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.

IMPORTANT
La decisión de preautorización no debe utilizarse de manera autorizada para reproducir recursos, ya que ese es el propósito de una decisión de autorización.

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.

IMPORTANT
El número máximo de recursos solo se puede aumentar después de alcanzar un acuerdo con los representantes de MVPD y autenticación de Adobe Pass. Una vez acordados, un administrador de su organización o un representante de autenticación de Adobe Pass que actúe en su nombre puede implementar los cambios a través del panel de control de Adobe Pass TVE.
Para obtener más información, consulte la Guía del usuario sobre integraciones de paneles de TVE.

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.

IMPORTANT
En el caso de las MVPD sin compatibilidad total con la autorización de verificación previa, el uso de la autorización previa debe acordarse de antemano con los representantes de las MVPD y los representantes de autenticación de Adobe Pass, ya que puede provocar problemas de rendimiento y tiempos de respuesta más lentos.

Decisiones de autorización

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.

IMPORTANT
La autenticación de Adobe Pass recomienda que los programadores utilicen la biblioteca de Media Token Verifier para validar el token de medios incluido en una decisión de autorización, lo que garantiza un acceso seguro antes de iniciar el flujo de vídeo.
Para obtener más información, consulte la documentación de Tokens de medios.

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.

IMPORTANT
El número máximo de recursos solo se puede aumentar después de alcanzar un acuerdo con los representantes de MVPD y autenticación de Adobe Pass.

Administración del tiempo de vida de la autorización (TTL)

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

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
IMPORTANT
La preautorización (autorización de comprobación preliminar) se centra en recursos de nivel de canal con identificadores que tienen una cadena simple o un formato MRSS.
No se recomienda utilizar recursos con identificadores que incluyan secciones de CDATA en caso de preautorización, ya que se utilizan principalmente para recursos de nivel de recurso definidos por un MRSS.