Guía de integración del programador
IMPORTANTEEsta 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
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
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.
| Fase | Prioridad | Caso de uso | Documentos |
|---|---|---|---|
| Autenticación | Alta | Autenticación | Para obtener más información, consulte los documentos agregados en la sección Fase de autenticación. |
| Alta | Autenticación basada en el hogar (HBA) | Para obtener más información, consulte Autenticación basada en el hogar. | |
| Alta | Inicio de sesión único (SSO) | Para obtener más información, consulte los documentos agregados en la sección Inicio de sesión único (SSO). | |
| Alta | Seleccionar MVPD | Para obtener más información, consulte los documentos agregados en la sección Fase de configuración. | |
| Medium | Página de inicio de sesión de MVPD | Permite a las MVPD proporcionar a las páginas de inicio de sesión una personalización de marca específica para el programador o el proveedor de servicios, incluida la compatibilidad con las preferencias de idioma predeterminadas. | |
| Alta | Configuración de valores de tiempo de vida (TTL) por plataforma | Para obtener más información, consulte la Guía del usuario sobre integraciones de paneles de TVE. | |
| Autorización Previa | Baja | Autorización previa (Autorización de verificación previa) | Para obtener más información, consulte los documentos agregados en la sección Fase de preautorización. |
| Medium | Códigos de error mejorados | Para obtener más información, consulte Códigos de error mejorados. | |
| Autorización | Alta | Autorización | Para obtener más información, consulte los documentos agregados en la sección Fase de autorización. |
| Alta | Autorización de canal distinto | Permite a los usuarios acceder al contenido desde varias redes de canales dentro de una única aplicación de TVE. Los programadores pueden hacer llamadas de autorización específicas al canal para verificar el derecho. | |
| Baja | Autorización de nivel de recurso | Permite a las MVPD recopilar análisis detallados de los activos de contenido individuales durante la autorización. | |
| Medium | Códigos de error mejorados | Para obtener más información, consulte Códigos de error mejorados. | |
| Alta | Reproductor Federado De Programador: Con Autorización A Nivel De Página | Para obtener más información, consulte Tokens de medios. | |
| Medium | Reproductor Federado De Programador: Con Autorización Interna Del Reproductor | Para obtener más información, consulte Tokens de medios. | |
| Alta | Syndicated Player: alojado en el portal de MVPD con autorización de nivel de página | Para obtener más información, consulte Tokens de medios. | |
| Baja | Control parental: clasificaciones de contenido en solicitudes de autorización | Permite al programador incluir clasificaciones de contenido como parte de la solicitud de autorización a MVPD que son útiles para la autorización de nivel de recurso. | |
| Baja | Control parental: filtrado de contenido basado en atributos del usuario | Permite al programador comprobar la clasificación de contenido máxima permitida para un usuario y filtrar el contenido disponible en consecuencia. | |
| Cerrar sesión | Medium | Cerrar sesión | Para obtener más información, consulte los documentos agregados en la sección Fase de cierre de sesión. |
Flujo de derecho
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:
NOTAFase de registro
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
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
CONSEJOFase de autenticación
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
CONSEJO