Proteggere i video con una chiave unica

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

Proteggere un video con chiave unica

Hai la possibilità di proteggere tutti i media di una cartella con la creazione di un token. Quest’ultimo sarà unico per ciascuno dei tuoi visitatori e dovrà essere passato in parametro al tuo media al fine di limitare la consultazione di quest’ultimo. Solo tu sarai in grado di generare la chiave unica, necessaria per ogni utente per vedere i video. Questa chiave permette quindi di autorizzare solo le persone precedentemente verificate da voi.

In questo modo è possibile controllare l'accesso ai video e consentire solo alcune persone, mentre altre vengono rifiutate. Utile in casi come pay-per-view o trasmissioni limitate. Tuttavia, tieni presente che sta a te sviluppare l'integrazione con il 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 impostata una volta per tutte a livello della cartella di destinazione, tutte le nuove importazioni di media includeranno automaticamente questa modalità alla loro lettura. Per configurare questa cartella:

1. Clicca qui per accedere alla gestione del prodotto sul Manager Infomaniak (Hai bisogno di aiuto?).
2. Clicca direttamente su il nomeattribuito al prodotto in questione.
3. Clicca su Media nel menu laterale sinistro.
4. Clicca su Gestione dei media nel menu laterale sinistro.
5. Fare clic sull'icona per creare un Nuova cartella:
   
6. Dare un nome alla cartella.
7. Fare clic sul pulsante blu per Crea cartella.
8. Clicca su Configurazione:
   
9. Scegli le regole di codifica per i video che verranno importati e vai al passaggio successivo.
10. Configurare le opzioni della cartella in questo secondo passaggio e passare al passaggio successivo.
11. Attivare la restrizione per singola chiave.
12. Fare clic sul pulsante blu una volta configurate le diverse restrizioni desiderate:
    

1 . Creare un token API VOD

Per accedere all'API VOD, è necessario prima di tutto autenticarsi con un token applicazione. Questo passo deve essere fatto solo una volta. Il token per le applicazioni sarà comune per tutte le cartelle che si desidera proteggere. Per creare questo token di applicazione, prendere conoscenza di quest'altra guida Poi la documentazione https://developer.infomaniak.com/getting-started#authentication.

2. Creare il token di playback

Questo passaggio sarà fatto sul tuo sito web/applicazione e questo token dovrà essere unico, quindi generato per ogni visitatore.

È quindi importante che la pagina che avrà come ruolo la generazione di token non abbia una cache, al fine di 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

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

3. Utilizzo del token unico su un mezzo di comunicazione

Il token recuperato al punto 2 di cui sopra sarà così passato in parametro al media, sarà unico 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>