Ce guide explique comment protéger par clé unique des vidéos importées sur un service VOD Infomaniak.

Préambule

• Attention, la protection par token n'est effective que dans le cas d'une intégration standard par iframe et donc via l'utilisation du Player Infomaniak.
• D'autres restrictions d'accès peuvent être activées: mot de passe | geoip

Protéger une vidéo par clé unique

Vous avez la possibilité de protéger l'ensemble des médias d'un dossier avec la création d'un token. Ce dernier sera unique pour chacun de vos visiteurs et devra être passé en paramètre à votre media afin de limiter la consultation de ce dernier. Vous seul serez capable de générer la clé unique, nécessaire à chaque utilisateur pour voir les vidéos. Cette clé permet donc de n'autoriser que les personnes préalablement vérifiées par vos soins.

Cela permet de contrôler l'accès aux vidéos et de n'autoriser que certaines personnes, les autres étant refusées ; utile dans des cas tels que du pay-per-view ou des diffusions limitées. Cependant veuillez noter que c'est à vous de développer l'intégration à votre système existant. 

Si le hash n'est pas valide, l'accès à la vidéo retournera une page d'erreur "403 forbidden".

Activer la restriction sur le dossier d'importation

Lorsque le mot de passe est défini une fois pour toute au niveau du dossier de destination, toutes les nouvelles importations de médias comporteront automatiquement ce mode à leur lecture. Pour configurer ce dossier:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Médias dans le menu latéral gauche.
4. Cliquez sur Gestion des médias dans le menu latéral gauche.
5. Cliquez sur l'icône afin de créer un Nouveau dossier:
   
6. Donnez un nom au dossier.
7. Cliquez sur le bouton bleu pour Créer le dossier.
8. Cliquez sur Configuration:
   
9. Choisissez les règles d'encodage pour les vidéos qui seront importées puis passez à l'étape suivante.
10. Configurez les options du dossier dans cette seconde étape puis passez à l'étape suivante.
11. Activez la restriction par clé unique.
12. Cliquez sur le bouton bleu une fois les différentes restrictions souhaitées configurées:
    

1. Créer un token API VOD

Pour avoir accès à l'API VOD, vous devez en premier lieu vous authentifier grâce à un token application. Cette étape n'est à faire qu'une seule fois. Le token applicatif sera commun pour l'ensemble des dossiers que vous souhaiterez protéger. Pour créer ce token d'application, prenez connaissance de cet autre guide puis de la documentation https://developer.infomaniak.com/getting-started#authentication.

2. Créer le token de playback

Cette étape sera à faire sur votre site internet/application et ce token devra être unique, donc généré pour chaque visiteur.

Il est donc important que la page qui aura pour rôle la génération de token ne possède pas de cache, afin de garantir l’unicité du token.

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

channel_id = 1227
share_id = correspond à l'identifiant de votre vidéo
Exemple: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

La liste des paramètres est disponible dans la documentation https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Utilisation du token unique sur un media

Le token récupéré au point 2 ci-dessus sera ainsi passé en paramètre au media, il sera unique donc différent pour chaque visiteur:

<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>