Questa guida spiega come proteggere con una chiave univoca i video caricati su un servizio VOD di Infomaniak.

Introduzione

• Attenzione: la protezione è efficace solo nel caso di un'integrazione standard tramite iframe e quindi tramite l'utilizzo del Player di Infomaniak.
• È possibile attivare altre restrizioni di accesso: password | geoip
• È possibile gestire le immagini di anteprima utilizzate durante la restrizione dell'accesso.

Proteggere un video con una chiave univoca

È possibile proteggere tutti i contenuti multimediali di una cartella creando un token. Quest'ultimo sarà univoco per ciascuno dei vostri visitatori e dovrà essere passato come parametro al vostro contenuto multimediale per limitare la visualizzazione. Solo voi sarete in grado di generare la chiave univoca, necessaria a ciascun utente per visualizzare i video. Questa chiave consente quindi di autorizzare solo le persone preventivamente verificate.

Questo permette di controllare l'accesso ai video e di autorizzare solo determinate persone, negando l'accesso alle altre; utile in casi come il pay-per-view o le trasmissioni a numero limitato. Tuttavia, si prega di notare che è necessario sviluppare l'integrazione con il proprio sistema esistente.

Se l'hash non è valido, l'accesso al video restituirà una pagina di errore "403 forbidden".

Attivare la restrizione sulla cartella di importazione

Quando la password viene definita una sola volta a livello della cartella di destinazione, tutte le nuove importazioni di contenuti multimediali avranno automaticamente questa modalità durante la riproduzione. Per configurare questa cartella:

1. Clicca qui per accedere alla gestione del tuo VOD/AOD nel Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome del prodotto in questione:
   
3. Clicca su Media nel menu laterale sinistro.
4. Clicca su Gestione media nel menu laterale sinistro.
5. Clicca sull'icona per creare una Nuova cartella:
   
6. Assegna un nome alla cartella.
7. Clicca sul pulsante blu per Creare la cartella.
8. Clicca su Configurazione:
   
9. Clicca sulla scheda Restrizioni.
10. Disattiva, se necessario, l'interruttore per rimuovere l'ereditarietà dalla cartella principale, in modo da poter configurare le tue regole specifiche per questa cartella.
11. Attiva l'interruttore per configurare la restrizione tramite chiave univoca.
12. Clicca su Salva dopo aver configurato le diverse opzioni desiderate:
    

1. Creare un token API VOD

Per accedere all'API VOD, è necessario innanzitutto autenticarsi tramite un token (questa operazione va eseguita una sola volta e sarà valida per tutti i contenuti che si desidera proteggere); consultare questa guida e la documentazione https://developer.infomaniak.com/getting-started#authentication.

2. Creazione del token di riproduzione

Questa operazione deve essere eseguita sul proprio sito web/applicazione e il token deve essere univoco, quindi generato per ogni visitatore.

È quindi importante che la pagina che si occupa della generazione del token non abbia una cache, al fine di garantire l'univocità del token.

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

channel_id = 1227
share_id = corrisponde all'identificativo del proprio video
Esempio: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

L'elenco dei parametri è disponibile nella documentazione https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Utilizzo del token univoco in un media

Il token recuperato al punto 2 di cui sopra verrà quindi passato come parametro al media; sarà univoco e quindi diverso per ogni visitatore:

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