Autenticar solicitudes de stream de vídeo de inserción dinámica de anuncios

Las claves de autenticación de inserción dinámica de anuncios se usan para verificar que es el usuario el que ha hecho las solicitudes de stream de vídeo. También proporcionan mayor seguridad durante el proceso del servicio de anuncios. Una clave es una cadena ininterrumpida de 64 caracteres y números. Algunas claves más antiguas pueden tener 25 caracteres o números.

Ejemplo

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Claves de API estáticas: las claves de API tienen prioridad sobre las claves HMAC cuando se incluyen ambas. Las claves de API son menos seguras que las claves HMAC. Por lo tanto, se recomienda el uso de claves HMAC.

HMAC: la autenticación mediante token basado en HMAC ofrece mayor seguridad que las claves de API estáticas. Los tokens basados en HMAC usan una clave secreta y una duración limitada para que el token no pueda compartirse fácilmente entre usuarios o sesiones.

Nota: Antes de autenticar las solicitudes de streaming, asegúrate de que tienes lo siguiente:

• Clave de autenticación de inserción dinámica de anuncios de tipo HMAC
• Emisión en directo configurada para la inserción dinámica de anuncios

Añadir una clave de autenticación de inserción dinámica de anuncios HMAC

Genera y añade una clave de autenticación de inserción dinámica de anuncios de tipo HMAC:

1. Inicie sesión en Google Ad Manager.
2. Haga clic en Administrar y, a continuación, en Vídeo y audio.
3. Seleccione "Claves de autenticación de inserción dinámica de anuncios".
4. Haga clic en Nueva clave de autenticación de DAI.
5. Introduce el nombre de la nueva clave. Seleccione el tipo "HMAC".
6. Haga clic en Guardar.

Esta clave se vincula a su emisión en directo cuando habilita la autenticación.

Habilitar la autenticación para las solicitudes a las APIs de inserción dinámica de anuncios

Vincule su clave HMAC a su emisión:

1. Inicie sesión en Google Ad Manager.
2. Haga clic en Vídeo y, a continuación, en Emisiones en directo.
3. Seleccione la emisión en directo de la lista o haga clic en Nueva emisión en directo. Más información sobre cómo crear una emisión en directo
4. En Configuración general,
   1. Seleccione "Habilitado" en "Claves de autenticación de recursos del pod de anuncios" para autenticar solicitudes de pods de anuncios o
   2. Seleccione "Habilitado" en "Claves de autenticación para crear streams" para autenticar las solicitudes de sesión de emisión.
5. Seleccione la clave HMAC que ha creado.
6. Haga clic en Guardar.

Para ver y copiar su clave, vuelva a la página de detalles. Una vez que haya creado una clave de autenticación de DAI activa, puede usarla de inmediato. Incluya la clave en la aplicación de vídeo del cliente, donde haga solicitudes de emisión de inserción dinámica de anuncios.

Nota: Una práctica recomendada consiste en generar claves de autenticación de inserción dinámica de anuncios independientes para cada una de sus plataformas de cliente (por ejemplo, iOS, Android y Web).

Las claves se activan automáticamente al guardar. Solo las claves activas que se implementan correctamente pueden validar solicitudes.

Las solicitudes que usan claves desactivadas se rechazan. Desactive una clave solo si se ha vulnerado su seguridad o no debe utilizarse.

Desactivar una clave de autenticación

Para desactivar una clave de autenticación, siga estos pasos:

1. Inicie sesión en Google Ad Manager.
2. Haga clic en Administrar, Vídeo y audio y, a continuación, "Claves de autenticación de inserción dinámica de anuncios".
3. En la lista, seleccione la clave que quiera desactivar.
4. Seleccione el estado "Inactivo".
5. Haga clic en Guardar.

Implementar una clave de autenticación

Claves HMAC

Consulte información sobre cómo implementar la autenticación con HMAC.

Claves de API

Utilice el SDK de IMA para establecer la propiedad apiKey en el objeto IMAStreamRequest. Para obtener más información, consulte la documentación para desarrolladores de iOS, Android, Chromecast o tvOS.

En la señalización de servidor (SSB), utilice el parámetro de consulta api-key:

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

Si tiene algún problema relacionado con la solución de problemas o las interrupciones de la inserción dinámica de anuncios, póngase en contacto con el equipo de Asistencia para editores.