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 in caso di 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 una chiave unica

È possibile proteggere tutti i media di una cartella creando un token. Quest'ultimo sarà unico per ciascuno dei vostri visitatori e dovrà essere passato come parametro al vostro media per limitare la consultazione di quest'ultimo. Solo voi sarete in grado di generare la chiave unica, necessaria per ogni utente per visualizzare i video. Questa chiave permette quindi di autorizzare solo le persone precedentemente verificate da voi.

Ciò consente di controllare l'accesso ai video e di autorizzare solo determinate persone, mentre le altre vengono rifiutate; utile in casi come il pay-per-view o le trasmissioni limitate. Tuttavia, si noti 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 alla lettura. Per configurare questa cartella:

1. Clicca qui per accedere alla gestione del tuo VOD/AOD sul Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato:
   
3. Clicca su Media nel menu laterale sinistro.
4. Clicca su Gestione dei media nel menu laterale sinistro.
5. Clicca sull'icona per creare una Nuova cartella:
   
6. Dai 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, il pulsante a scorrimento (toggle switch) per rimuovere l'eredità della cartella genitore, in modo da poter configurare le tue regole su questa cartella specifica.
11. Attiva l'interruttore (toggle switch) per configurare la restrizione per chiave unica.
12. Clicca su Salva una volta configurate le diverse opzioni desiderate:
    

1. Creare un token API VOD

Per accedere all'API VOD, è necessario autenticarsi prima di tutto con un token (da fare una sola volta - sarà comune per tutte le cartelle che si desidera proteggere); consulta questa altra guida e poi la documentazione https://developer.infomaniak.com/getting-started#authentication.

2. Creare il token di riproduzione

Questa operazione andrà 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>