Asegurar videos con una clave única

Esta guía explica cómo proteger videos importados en un servicio VOD de Infomaniak con una clave única.

Proteger un Video con una Clave Única

Tienes la opción de proteger todos los medios en una carpeta creando un token. Este será único para cada uno de tus visitantes y debe pasarse como parámetro a tu medio para limitar su visualización. Solo tú podrás generar la clave única requerida por cada usuario para ver los videos. Por lo tanto, esta clave permite autorizar solo a individuos previamente verificados por ti.

Esto te permite controlar el acceso a los videos y solo permitir que ciertas personas los vean, mientras que otros son denegados. Útil en casos como pago por vista o transmisiones limitadas. Sin embargo, ten en cuenta que es tu responsabilidad desarrollar la integración en tu sistema existente.

Si el hash no es válido, el acceso al video devolverá una página de error "403 Forbidden".

Activar la Restricción en la Carpeta de Importación

Cuando la contraseña se establece una vez para siempre a nivel de la carpeta de destino, todas las nuevas importaciones de medios tendrán automáticamente este modo habilitado al reproducirse. Para configurar esta carpeta:

1. Inicia sesión en el Manager de Infomaniak (manager.infomaniak.com) usando un navegador web como Brave o Edge.
2. Haz clic en el icono en la parte superior derecha de la interfaz (o navega a través del menú lateral izquierdo, por ejemplo, aquí).
3. Selecciona VOD/AOD (universo de Streaming).
4. Haz clic en el nombre del objeto relevante en la tabla que se muestra.
5. Haz clic en Medios en el menú lateral izquierdo.
6. Haz clic en Gestión de Medios en el menú lateral izquierdo.
7. Haz clic en el icono para crear una Nueva Carpeta
   
8. Asigna un nombre a la carpeta.
9. Haz clic en el botón azul para Crear la carpeta.
10. Haz clic en Configuración
    
11. Selecciona las reglas de codificación para los videos importados y procede al siguiente paso.
12. Configura las opciones de la carpeta en este segundo paso y procede al siguiente paso.
13. Habilita la restricción con una clave única.
14. Haz clic en el botón azul una vez que se hayan configurado las restricciones deseadas
    

1. Crear un Token API VOD

Para acceder a la API VOD, primero debes autenticarte con un token de aplicación. Este paso solo debe hacerse una vez. El token de aplicación será común para todas las carpetas que desees proteger. Para crear este token de aplicación, lee esta guía y la documentación en https://developer.infomaniak.com/getting-started#authentication.

2. Crear el Token de Reproducción

Este paso debe realizarse en tu sitio web/aplicación y este token debe ser único, por lo que se genera para cada visitante.

Por lo tanto, es importante que la página responsable de la generación del token no tenga una caché, para garantizar la singularidad del token.

POST  https://api.vod2.infomaniak.com/api/pub/v1/channel/channel_id/share/share_id/token

channel_id = 1227
share_id = el ID de tu video
Ejemplo: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

La lista de parámetros está disponible en la documentación en https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Usar el Token Único en un Medio

El token obtenido en el paso 2 anterior se pasará como parámetro al medio, será único y por lo tanto diferente para cada visitante:

<iframe frameborder="0" width="720" height="360"  src="https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html?token=st=1637143497~exp=1637143797~acl=/hls/1jhvl2uq4dnra/1jhvl2uq4dnmd/*~hmac=914aa838bdba141ec85db74266b54278572a1353a49e8851e4fd096dc6372127" allowfullscreen></iframe>

Se pueden habilitar restricciones de acceso adicionales: contraseña + GeoIP.