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

Introduzione

• Attenzione, la protezione è efficace solo in caso di integrazione standard tramite iframe e quindi tramite l'utilizzo del Player Infomaniak.
• È possibile attivare ulteriori 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 file multimediali di una cartella creando un token. Questo token sarà univoco per ciascuno dei vostri visitatori e dovrà essere passato come parametro al file multimediale, in modo da limitarne 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 che avete preventivamente verificato.

Questo permette di controllare l'accesso ai video e di autorizzare solo determinate persone, negandolo agli altri; è utile in casi come il pay-per-view o le trasmissioni a numero chiuso. 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".

Abilitare la restrizione sulla cartella di importazione

Quando la password viene impostata una sola volta a livello della cartella di destinazione, tutte le nuove importazioni di contenuti multimediali la utilizzeranno automaticamente 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. Fate clic direttamente sul nome assegnato al prodotto in questione:
   
3. Fate clic su Media nel menu laterale sinistro.
4. Fare clic su Gestione media nel menu laterale sinistro.
5. Fare clic sull'icona per creare una Nuova cartella:
   
6. Assegna un nome alla cartella.
7. Fai clic sul pulsante blu per creare la cartella.
8. Fare clic su Configurazione:
   
9. Fare clic sulla scheda Restrizioni.
10. Disattivate, se necessario, l'interruttore per rimuovere l'ereditarietà dalla cartella principale, in modo da poter configurare le vostre regole specifiche per questa cartella.
11. Attivate l'interruttore per configurare la restrizione tramite chiave univoca.
12. Una volta configurate le diverse opzioni desiderate, fare clic su Salva:
    

1. Creare un token API VOD

Per accedere all'API VOD, è necessario innanzitutto autenticarsi tramite un token (questo deve essere fatto una sola volta e sarà valido per tutte le cartelle che si desidera proteggere); consultare questa guida e la documentazione https://developer.infomaniak.com/getting-started#authentication.

2. Creare il token di riproduzione

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

È quindi importante che la pagina che avrà il compito di generare il token non abbia una cache, al fine di garantire l'univocità del token.

POST  {{URL_14}}

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 univoco in un ambiente

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

<iframe frameborder="0" width="720" height="360"  src="{{URL_18}}" allowfullscreen></iframe>