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

Premessa

• Attenzione, la protezione tramite token è efficace solo nel caso di un'integrazione standard tramite iframe e quindi tramite l'utilizzo del Player Infomaniak.
• Altre restrizioni di accesso possono essere attivate: password | geoip

Proteggere un video con chiave univoca

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

Questo permette di controllare l'accesso ai video e di autorizzare solo alcune persone, mentre altre vengono rifiutate; utile in casi come il pay-per-view o le trasmissioni limitate. Tuttavia, si prega di notare che spetta a voi sviluppare l'integrazione con il vostro 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 è impostata una volta per tutte a livello della cartella di destinazione, tutte le nuove importazioni di media avranno automaticamente questo modo di lettura. Per configurare questa cartella:

1. Clicca qui per accedere alla gestione del tuo prodotto su il Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome assegnato al prodotto interessato.
3. Fai clic su Media nel menu laterale sinistro.
4. Fai clic su Gestione dei media nel menu laterale sinistro.
5. Clicca sull'icona per creare una Nuova cartella:
   
6. Dai un nome alla cartella.
7. Fai clic sul pulsante blu per Creare la cartella.
8. Clicca su Configurazione:
   
9. Scegliete le regole di codifica per i video che verranno importati, quindi passate al passaggio successivo.
10. Configurate le opzioni della cartella in questa seconda fase, quindi passate alla fase successiva.
11. Attiva la restrizione tramite chiave univoca.
12. Fai clic sul pulsante blu una volta configurate le diverse restrizioni desiderate:
    

1. Creare un token API VOD

Per accedere all'API VOD, devi autenticarti utilizzando un token applicazione. Questa operazione va eseguita una sola volta. Il token applicativo sarà comune per tutti i dossier che desideri proteggere. Per creare questo token applicativo, consulta questa guida e la documentazione https://developer.infomaniak.com/getting-started#authentication.

2. Creare il token di riproduzione

Questa fase va eseguita sul tuo sito web/applicazione e questo token dovrà essere unico, quindi generato per ogni visitatore.

È quindi importante che la pagina che avrà il compito di generare il token non abbia 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'identificativo del tuo 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 unico su un media

Il token recuperato al punto 2 sopra sarà quindi passato come 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>