Ce guide explique comment protéger par clé unique (token) les vidéos hébergées sur un service VOD Infomaniak.

Préambule

• Important : cette protection s'applique uniquement aux intégrations standards par iframe utilisant le Player Infomaniak (❓: aide).
• D'autres modes de restriction sont également disponibles : par mot de passe (❓: aide) ou par géoblocage (GeoIP). (❓: aide).
• Vous pouvez personnaliser les images d'aperçu affichées lors d'un refus d'accès (❓: aide).

Fonctionnement de la protection par clé unique

La restriction par clé unique vous permet de sécuriser l'accès aux médias d'un dossier en exigeant un jeton temporaire (token) propre à chaque visiteur.

Ce jeton est généré exclusivement par vos soins (côté serveur) et doit être transmis en paramètre lors de l'appel du média. Ce mécanisme est idéal pour des cas d'usage comme le Pay-Per-View ou la diffusion à accès restreint.

Note : l'intégration et la génération dynamique des jetons doivent être développées sur votre propre application web. Si la clé fournie est invalide ou expirée, le Player retourne une erreur 403 Forbidden.

Activer la restriction sur un dossier VOD

Lorsqu'une restriction est configurée sur un dossier, elle s'applique automatiquement à l'ensemble des médias qui y sont contenus ou importés ultérieurement.

1. Accéder au Manager : cliquez ici pour accéder à la gestion de votre produit VOD/AOD (❓: aide).
2. Sélectionner le produit : cliquez sur le nom attribué à votre service VOD :
   
3. Dans le menu latéral gauche, allez sous Médias puis Gestion des médias.
4. Créer ou configurer un dossier : cliquez sur l'icône de création de Nouveau dossier :
   
5. Saisissez le nom du dossier puis cliquez sur Créer le dossier.
6. Accédez aux paramètres du dossier en cliquant sur Configuration :
   
7. Ouvrez l'onglet Restrictions.
8. Si nécessaire, désactivez le bouton bascule pour **rompre l'héritage** du dossier parent afin d'appliquer des règles spécifiques.
9. Activez l'option de restriction par Clé unique.
10. Cliquez sur Enregistrer pour valider :
    

Procédure d'intégration technique

1. Créer un jeton d'accès API (Token API)

Afin d'interagir avec l'API VOD, générez au préalable une clé d'API globale depuis votre compte (❓: aide).

2. Générer le jeton de lecture (Playback Token)

Côté serveur, votre application doit exécuter une requête POST pour chaque utilisateur unique avant l'affichage du lecteur.

Requête API (❓: aide):

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

• channel_id : identifiant de votre chaîne VOD (ex. 1227)
• share_id : identifiant unique du média (ex. extrait de l'URL d'intégration : https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html)

3. Intégrer le jeton dans le code Iframe

Passez le jeton obtenu à l'étape précédente en paramètre d'URL (?token=...) dans le code d'intégration de votre iframe :

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