Proteggere i video con una chiave unica

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

Proteggere un Video con una Chiave Unica

Hai la possibilità di proteggere tutti i media di una cartella creando un token. Questo sarà unico per ciascuno dei tuoi visitatori e dovrà essere passato come parametro al tuo media per limitarne la visualizzazione. Solo tu sarai in grado di generare la chiave unica necessaria per ciascun utente per vedere i video. Questa chiave consente quindi di autorizzare solo le persone precedentemente verificate da te.

Questo ti permette di controllare l'accesso ai video e di permettere solo a determinate persone di visualizzarli, mentre gli altri sono negati. Utile in casi come il pay-per-view o le trasmissioni limitate. Tuttavia, tieni presente che è tua responsabilità sviluppare l'integrazione nel tuo 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 volta per tutte a livello della cartella di destinazione, tutte le nuove importazioni di media avranno automaticamente questa modalità abilitata durante la riproduzione. Per configurare questa cartella:

1. Accedi al Manager di Infomaniak (manager.infomaniak.com) utilizzando un browser web come Brave o Edge.
2. Fai clic sull'icona nell'angolo in alto a destra dell'interfaccia (o naviga attraverso il menu laterale sinistro, ad esempio, qui).
3. Seleziona VOD/AOD (universo di Streaming).
4. Fai clic sul nome dell'oggetto rilevante nella tabella visualizzata.
5. Fai clic su Media nel menu laterale sinistro.
6. Fai clic su Gestione Media nel menu laterale sinistro.
7. Fai clic sull'icona per creare una Nuova Cartella
   
8. Assegna un nome alla cartella.
9. Fai clic sul pulsante blu per Creare la cartella.
10. Fai clic su Configurazione
    
11. Seleziona le regole di codifica per i video importati e procedi con il passaggio successivo.
12. Configura le opzioni della cartella in questo secondo passaggio e procedi al passaggio successivo.
13. Attiva la restrizione con una chiave unica.
14. Fai clic sul pulsante blu una volta configurate le restrizioni desiderate
    

1. Creare un Token API VOD

Per accedere all'API VOD, devi prima autenticarti con un token di applicazione. Questo passaggio va eseguito solo una volta. Il token dell'applicazione sarà comune per tutte le cartelle che desideri proteggere. Per creare questo token di applicazione, leggi questa guida e poi la documentazione https://developer.infomaniak.com/getting-started#authentication.

2. Creare il Token di Playback

Questo passaggio deve essere eseguito sul tuo sito web/applicazione e il token deve essere unico, quindi generato per ogni visitatore.

È importante quindi che la pagina che genererà il token non abbia una cache, per garantire l'unicità 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'ID del tuo video
Esempio: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

La lista dei parametri è disponibile nella documentazione https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Utilizzo del Token Unico su un Media

Il token ottenuto nel passaggio 2 sopra verrà quindi passato come parametro al media, sarà unico 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>

Sono disponibili ulteriori restrizioni di accesso: password + GeoIP.