Guía de integración del programador programmer-integration-guide
Esta guía de integración está dirigida a los proveedores de contenido (programadores) que planean integrarse con la autenticación de Adobe® Pass.
En el panorama digital actual, los espectadores pueden acceder a Internet en cualquier momento y en cualquier lugar, y solicitar acceso a su contenido protegido. Es posible que busquen ver un evento único o que busquen los derechos para transmitir una serie completa de televisión que esté transmitiendo.
Antes de conceder acceso al contenido protegido, debe determinar si el visualizador tiene derecho a él. Las preguntas clave incluyen:
- ¿Tiene el visor una suscripción activa con un Distribuidor de programación de vídeo multicanal (MVPD)?
- ¿Esa suscripción incluye su programación?
Autenticación de Adobe Pass para TV en todas partes adobe-pass-authentication-for-tv-everywhere
Para los programadores, la determinación de la asignación de derechos no siempre es sencilla. Las MVPD custodian los datos de identificación de sus clientes y sus privilegios de acceso. Para complicar aún más las cosas, los programadores y los espectadores pueden suscribirse a una amplia variedad de MVPD, cada una de las cuales funciona con sistemas únicos. Estas complejidades hacen que la verificación de los derechos sea técnicamente difícil y consuma muchos recursos.
Derecho De Usuario Determinado Directamente Por El Programador
La autenticación de Adobe Pass facilita de forma segura las transacciones de derechos entre programadores y MVPD, lo que facilita, simplifica y asegura la provisión de contenido protegido a los visualizadores aptos.
Derecho de usuario mediado por la autenticación de Adobe Pass
La autenticación de Adobe Pass actúa como un proxy y facilita el flujo de asignación de derechos entre programadores y MVPD al ofrecer interfaces seguras y coherentes para ambas partes.
Para los programadores, la autenticación de Adobe Pass proporciona API como parte de un nivel Standard o Premium:
-
API de autenticación estándar de Adobe Pass:
-
API de autenticación de Adobe Pass Premium:
Casos de uso use-cases
En esta sección se describen más adelante los casos de uso de integración de programador admitidos por la autenticación de Adobe Pass:
-
Programador (TVE) con una red de un solo canal
Esto permite al programador proporcionar a los visualizadores acceso al contenido desde una red de canal de una sola marca dentro de una aplicación de TVE.
-
Aplicación de programador (TVE) con redes multicanal
Esto permite al programador proporcionar a los visualizadores acceso al contenido de varias redes de canales dentro de una sola aplicación de TVE.
-
Programador (TVE) aplicación para eventos especiales
Esto permite al programador proporcionar a los visualizadores acceso al contenido de eventos especiales que pueden no ser recursos que se encuentran en la base de datos de derechos de MVPD como en los canales normales.
Flujo de derecho entitlement-flow
El flujo de derechos es una serie de pasos que una aplicación de Programador (TVE) debe completar para transmitir contenido protegido. El flujo consta de las siguientes fases:
En la visita inicial de un usuario a una aplicación de Programador (TVE), el flujo de derechos sigue la secuencia descrita. Sin embargo, en visitas posteriores, la aplicación puede omitir ciertos pasos según el estado del registro o la autenticación y las políticas de visualización aplicables.
Para obtener una exploración detallada del flujo de derechos y sus fases, continúe leyendo este documento y, después, consulte las guías del libro de cocina que lo acompañan para obtener información adicional:
Fase de registro registration-phase
El propósito de la fase de registro es registrar la aplicación cliente con la autenticación de Adobe Pass a través del proceso de Registro dinámico de clientes (DCR).
El proceso de registro dinámico de clientes (DCR) requiere que la aplicación cliente obtenga un par de credenciales de cliente y recupere un token de acceso como objetivo final de la fase de registro.
API
Flujos
preguntas más frecuentes
Fase de configuración configuration-phase
El propósito de la fase de configuración es proporcionar a la aplicación cliente la lista de MVPD con las que está integrada activamente junto con los detalles de configuración guardados por la autenticación de Adobe Pass para cada MVPD.
La fase de configuración actúa como un paso previo para la fase de autenticación cuando la aplicación cliente necesita pedir al usuario que seleccione su proveedor de TV.
API
preguntas más frecuentes
Fase de autenticación authentication-phase
El propósito de la fase de autenticación es proporcionar a la aplicación cliente la capacidad de comprobar la identidad del usuario con MVPD y obtener información de metadatos del usuario.
La fase de autenticación actúa como un paso previo para la fase de preautorización o la fase de autorización cuando la aplicación cliente necesita reproducir contenido.
La autenticación correcta genera un perfil vinculado a la aplicación, el dispositivo y el proveedor de servicios, que también contiene información de metadatos del usuario.
Pasos de alto nivel
Los siguientes pasos describen los pasos de alto nivel en caso de integración de SAML:
-
Carga de aplicación del programador (sitio web)
El usuario navega a la aplicación del programador (sitio web), que integra la autenticación de Adobe Pass REST API V2. -
Solicitud de contenido protegido
Cuando el usuario intenta acceder a contenido protegido, la aplicación del programador muestra una lista de MVPD para que el usuario las seleccione. -
Inicialización de solicitud de autenticación
Al seleccionar MVPD, se redirige al usuario a un servidor de autenticación de Adobe Pass. En este caso, se genera una solicitud de autenticación SAML cifrada para el MVPD seleccionado, en caso de integración con SAML. Esta solicitud se envía en nombre del programador a MVPD. Según el sistema de MVPD, el explorador del usuario se redirige a la página de inicio de sesión de MVPD o se incrusta un iFrame de inicio de sesión en la aplicación del programador. -
Inicio de sesión en MVPD
MVPD acepta la solicitud y presenta su interfaz de inicio de sesión, ya sea mediante redireccionamiento o iFrame. -
Inicio de sesión y validación de usuario
El usuario inicia sesión con sus credenciales de MVPD. MVPD valida el estado de suscripción del usuario y establece su propia sesión HTTP. -
Respuesta de MVPD a la autenticación de Adobe Pass
Una vez finalizada la validación, MVPD genera una respuesta SAML (cifrada) y la devuelve a la autenticación de Adobe Pass. -
Generación de perfiles
La autenticación de Adobe Pass verifica la respuesta de SAML, genera un perfil de usuario que se almacena en caché y redirige al usuario de nuevo a la aplicación del programador (sitio web).
API
Flujos
preguntas más frecuentes
Inicio de sesión único (SSO) single-sign-on
API
Flujos
(Opcional) Fase de preautorización preauthorization-phase
El propósito de la fase de preautorización es proporcionar a la aplicación cliente la capacidad de presentar un subconjunto de recursos de su catálogo al que el usuario tendría derecho de acceso.
La fase de preautorización puede mejorar la experiencia del usuario cuando abre la aplicación cliente por primera vez o navega a una nueva sección.
API
Flujos
preguntas más frecuentes
Fase de autorización authorization-phase
El propósito de la fase de autorización es proporcionar a la aplicación cliente la capacidad de reproducir recursos que el usuario solicita después de validar sus derechos con MVPD.
La autorización correcta genera una decisión que contiene también un token de medios que se proporciona a la aplicación Programador (TVE) por motivos de seguridad.
Pasos de alto nivel
Los pasos siguientes describen los pasos de alto nivel:
-
Control de identificador de recurso
El contenido protegido se identifica con un identificador de recurso, que puede ser una cadena simple o una estructura más compleja. Este identificador está predefinido y es acordado por el programador y MVPD. La aplicación del programador envía el identificador de recurso a la API de autenticación de Adobe Pass REST V2. -
Comprobación de autorización de MVPD
El servidor de autenticación de Adobe Pass se comunica con el extremo de autorización de MVPD mediante protocolos estandarizados. -
Respuesta de MVPD a la autenticación de Adobe Pass
Una vez finalizada la validación, MVPD confirma que el usuario tiene derecho (o no) a acceder al contenido y envía una respuesta de vuelta a Autenticación de Adobe Pass. -
Generación de token de medios y decisión
La autenticación de Adobe Pass comprueba la respuesta, genera una decisión que se almacena en caché y devuelve la decisión que contiene un token multimedia de nuevo a la aplicación del programador (sitio web). -
Verificación de acceso al contenido
La aplicación del programador usa el Comprobador de token multimedia para confirmar que el usuario correcto tiene acceso al contenido correcto. Una vez validado, se concede al usuario acceso para ver el contenido protegido.
API
Flujos
preguntas más frecuentes
Fase de cierre de sesión logout-phase
El propósito de la fase de cierre de sesión es proporcionar a la aplicación cliente la capacidad de finalizar el perfil autenticado del usuario dentro de la autenticación de Adobe Pass si el usuario lo solicita.
API
Flujos
preguntas más frecuentes
Cierre de sesión único (SLO) single-logout
Flujos
Explicación de derechos understanding-entitlements
La solución de autenticación de Adobe Pass gira en torno a la creación de datos específicos de derechos generados al completar correctamente los flujos de trabajo de autenticación y autorización. Estos derechos otorgan acceso a contenido protegido, pero tienen una duración limitada. Una vez que caduca un derecho, debe renovarse reiniciando los procesos de autenticación o autorización.
Para obtener más información sobre los derechos, consulte los siguientes documentos:
-
Perfiles
Una vez autenticada correctamente, la autenticación de Adobe Pass crea un perfil autenticado ("de larga duración") asociado a la aplicación, el dispositivo y el identificador del proveedor de servicios solicitante (identificador del solicitante).
-
Tras la autenticación correcta (y, en algunos casos, después de la autorización), la autenticación de Adobe Pass recibe metadatos de usuario de MVPD que pueden exponerlos a la aplicación solicitante.
-
Una vez concedida la autorización, la autenticación de Adobe Pass crea una decisión de autorización ("larga duración") asociada a la aplicación, el dispositivo, el identificador del proveedor de servicios (identificador del solicitante) y un recurso protegido específico (identificador de recurso) solicitantes.
-
Una vez que la autorización se ha realizado correctamente, la autenticación de Adobe Pass crea un token de medios ("de corta duración") que se asocia a una solicitud de reproducción correcta y proporciona compatibilidad con las prácticas recomendadas del sector para mitigar el fraude (por ejemplo, copiar secuencias).
Los valores de tiempo de vida ("TTL") para perfiles y decisiones se establecen en función de los acuerdos entre programadores y proveedores de TV de pago, que acuerdan un valor que mejor sirva a todos los involucrados.