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

Introducción

• Tenga en cuenta que la protección solo es efectiva en caso de una integración estándar mediante iframe y, por lo tanto, mediante el uso del reproductor de Infomaniak.
• Se pueden activar otras restricciones de acceso: contraseña | geoIP
• Puede gestionar las imágenes de vista previa utilizadas al restringir el acceso.

Proteger un vídeo con una clave única

Tiene la posibilidad de proteger todos los archivos multimedia de una carpeta creando un token. Este token será único para cada uno de sus visitantes y deberá pasarse como parámetro a su archivo multimedia para limitar la visualización de este último. Solo usted podrá generar la clave única, necesaria para que cada usuario pueda ver los vídeos. Esta clave permite, por lo tanto, autorizar solo a las personas que usted haya verificado previamente.

Esto permite controlar el acceso a los vídeos y autorizar solo a ciertas personas, denegando el acceso a las demás; es útil en casos como el pago por visión o las transmisiones limitadas. Sin embargo, tenga en cuenta que usted deberá desarrollar la integración con su sistema existente.

Si el hash no es válido, el acceso al vídeo mostrará una página de error "403 prohibido".

Activar la restricción en la carpeta de importación

Cuando la contraseña se define una vez para toda la carpeta de destino, todas las nuevas importaciones de archivos multimedia incluirán automáticamente este modo en su reproducción. 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 correspondiente:
   
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 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 interruptor (toggle switch) para eliminar la herencia de la carpeta principal, con el fin de poder configurar sus propias reglas en esta carpeta específica.
11. Active el interruptor (toggle switch) para configurar la restricción por clave única.
12. Haga clic en Guardar una vez que se hayan configurado las diferentes opciones deseadas:
    

1. Crear un token API VOD

Para acceder a la API VOD, primero debe autenticarse mediante un token (esto solo debe hacerse una vez, ya que será válido para todos los archivos que desee proteger); consulte esta otra guía y 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.

Por lo tanto, es importante que la página que se encargará de generar el token no tenga 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 = corresponde al identificador de su vídeo
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 obtenido en el punto 2 anterior se pasará como parámetro al medio, y será único, por lo que será 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>