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

Prólogo

• Atención, la protección por token solo es efectiva en el caso de una integración estándar por iframe y, por lo tanto, mediante el uso del Player Infomaniak.
• Otras restricciones de acceso pueden activarse: contraseña | geoip

Proteger un video con clave única

Tienes la posibilidad de proteger todos los medios de una carpeta creando un token. Este será único para cada uno de tus visitantes y deberá pasarse como parámetro a tu medio para limitar su consulta. Solo tú podrás generar la clave única, necesaria para que cada usuario vea los videos. Esta clave permite autorizar solo a las personas previamente verificadas por ti.

Esto permite controlar el acceso a los videos y autorizar solo a ciertas personas, rechazando a las demás; útil en casos como el pay-per-view o transmisiones limitadas. Sin embargo, tenga en cuenta que usted debe desarrollar la integración con su 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 define una vez para siempre a nivel de la carpeta de destino, todas las nuevas importaciones de medios incluirán automáticamente este modo en su lectura. Para configurar esta carpeta:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto en cuestión.
3. Haga clic en Medios en el menú lateral izquierdo.
4. Haga clic en Gestión de medios en el menú lateral izquierdo.
5. Haga clic en el icono para crear una Nueva carpeta:
   
6. Asigne un nombre al directorio.
7. Haga clic en el botón azul para Crear la carpeta.
8. Haga clic en Configuración:
   
9. Seleccione las reglas de codificación para los videos que se importarán y luego pase al siguiente paso.
10. Configure las opciones de la carpeta en este segundo paso y luego pase al siguiente paso.
11. Active la restricción por clave única.
12. Haga clic en el botón azul una vez configuradas las diferentes restricciones deseadas:
    

1. Crear un token API VOD

Para acceder a la API VOD, primero debe autenticarse utilizando un token de aplicación. Este paso solo debe realizarse una vez. El token de la aplicación será común para todos los carpetas que desee proteger. Para crear este token de aplicación, consulte esta otra guía y luego la documentación https://developer.infomaniak.com/getting-started#authentication.

2. Crear el token de reproducción

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

Es por eso importante que la página que tenga el rol de generar el token no tenga caché, para garantizar la unicidad del token.

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

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

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

3. Uso del token único en un medio

El token recuperado en el punto 2 anterior se pasará como parámetro al medio, será único y 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>