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

Preámbulo

• 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 Reproductor de Infomaniak.
• Otras restricciones de acceso pueden ser activadas: contraseña | geoip

Proteger un video con una clave única

Tiene la posibilidad de proteger todos los medios de una carpeta con la creación de un token. Este será único para cada uno de sus visitantes y deberá ser pasado como parámetro a su medio para limitar la consulta de este último. Solo usted será capaz de generar la clave única, necesaria para cada usuario para ver los videos. Esta clave permite, por lo tanto, autorizar solo a las personas previamente verificadas por usted.

Esto permite controlar el acceso a los videos y autorizar solo a ciertas personas, mientras que las demás son rechazadas; útil en casos como el pago por visión o transmisiones limitadas. Sin embargo, tenga en cuenta que es usted quien 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 al ser leídos. Para configurar esta carpeta:

1. Haga clic aquí para acceder a la gestión de su VOD/AOD en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto concernido:
   
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 ícono para crear una Nueva carpeta:
   
6. Asigne un nombre a la carpeta.
7. Haga clic en el botón azul para Crear la carpeta.
8. Haga clic en Configuración:
   
9. Haga clic en la pestaña Restricciones.
10. Desactive, si es necesario, el botón de alternancia (toggle switch) para eliminar la herencia de la carpeta padre, con el fin de poder configurar sus propias reglas en esta carpeta específica.
11. Active la palanca de cambio (toggle switch) para configurar la restricción por clave única.
12. Haga clic en Guardar una vez configuradas las diferentes opciones deseadas:
    

1. Crear un token de API VOD

Para acceder a la API VOD, primero debe autenticarse con un token (solo una vez - será común para todos los directorios que desee proteger); 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 tanto, generado para cada visitante.

Por lo tanto, es importante que la página que tendrá 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 su 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, 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>