Asegurar vídeos por clave única

Esta guía explica cómo proteger por clave única los vídeos importados en un Servicio VOD Infomaniak.

Proteger un vídeo por clave única

Usted tiene la posibilidad de proteger a todos los medios de comunicación de una carpeta con la creación de un token. Este último será único para cada uno de sus visitantes y tendrá que pasar como parámetro a su medio para limitar la consulta de este último. Sólo usted será capaz de generar la clave única, necesaria para cada usuario para ver los vídeos. Por lo tanto, esta clave permite autorizar solamente a las personas previamente verificadas por usted.

Esto permite controlar el acceso a los vídeos y sólo permite a algunas personas, mientras que a otras se les niega el acceso. Util en casos como pay-per-view o transmisiones limitadas. Sin embargo, tenga en cuenta que depende de usted desarrollar la integración en su sistema existente.

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

Activar la restricción en el expediente de importación

Cuando la contraseña se define de una vez por todas a nivel de la carpeta de destino, todas las nuevas importaciones de medios incluirán automáticamente este modo a su lectura. Para configurar esta carpeta:

1. Haga clic aquí para acceder a la gestión de su producto en el Manager Infomaniak (¿Necesitas ayuda?).
2. Haga clic directamente en el nombreasignado al producto afectado.
3. Haga clic en Medios de comunicación en el menú lateral izquierdo.
4. Haga clic en Gestión de los medios de comunicación en el menú lateral izquierdo.
5. Haga clic en el icono para crear un Nueva carpeta:
   
6. Dale un nombre al expediente.
7. Haga clic en el botón azul para Crear carpeta.
8. Haga clic en Preferencias:
   
9. Elija las reglas de codificación para los vídeos que se importarán y luego pase al siguiente paso.
10. Configure las opciones de la carpeta en este segundo paso y pase al siguiente paso.
11. Active la restricción por clave única.
12. Haga clic en el botón azul una vez que se hayan configurado las diferentes restricciones deseadas:
    

1. Crear un token API VOD

Para tener acceso a la API VOD, primero debe autenticarse con un token aplicación. Este paso sólo tiene que hacerse una vez. El token applicativo será común para todas las carpetas que desee proteger. Para crear este token de aplicación, consulte esta otra guía y más tarde de la documentación https://developer.infomaniak.com/getting-started#authentication.

2. Crear el token de playback

Este paso será necesario hacer en su sitio web/aplicación y este token tendrá que ser único, por lo que se genera para cada visitante.

Por lo tanto, es importante que la página que tendrá como papel a la generación de token no tenga caché, a fin de 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 = coincide con el 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ónhttps://developer.infomaniak.com/docs/api/post/channel/share/token

3. Uso del token único en un medio de comunicación

El token recuperado en el punto 2 anterior será así pasado 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>