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

Introducción

• Atención, la protección solo es efectiva en caso de una integración estándar mediante iframe y, por lo tanto, a través del uso del reproductor de Infomaniak.
• Se pueden activar otras restricciones de acceso: contraseña | geolocalización
• Puede administrar 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 su visualización. Solo usted podrá generar la clave única necesaria para que cada usuario pueda ver los vídeos. Esta clave permite, por lo tanto, autorizar únicamente a las personas que usted haya verificado previamente.

Esto permite controlar el acceso a los vídeos y autorizar únicamente 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 se define una contraseña única para la carpeta de destino, todas las nuevas importaciones de archivos multimedia incluirán automáticamente esta contraseña al reproducirse. Para configurar esta carpeta:

1. Haga clic aquí para acceder a la gestión de su VOD/AOD en el Administrador 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 Administrar archivos 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 para eliminar la herencia de la carpeta principal, con el fin de poder configurar sus propias reglas para esta carpeta específica.
11. Active el interruptor para configurar la restricción mediante una clave única.
12. Haga clic en Guardar una vez que haya configurado las diferentes opciones deseadas:
    

1. Crear un token de 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  {{URL_14}}

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; será único y, por lo tanto, diferente para cada visitante:

<iframe frameborder="0" width="720" height="360"  src="{{URL_18}}" allowfullscreen></iframe>