Deze handleiding legt uit hoe u video's die zijn geüpload naar een VOD-service van Infomaniak kunt beschermen met een unieke sleutel.

Inleiding

• Let op: de beveiliging is alleen effectief bij een standaardintegratie via een iframe en dus via het gebruik van de Infomaniak-speler.
• Er kunnen andere toegangsbeperkingen worden geactiveerd: wachtwoord | geoip
• U kunt de voorbeeldafbeeldingen beheren die worden gebruikt bij het instellen van toegangsbeperkingen.

Een video beveiligen met een unieke sleutel

U kunt alle media in een map beveiligen door een token te maken. Dit token is uniek voor elke bezoeker en moet als parameter aan uw media worden doorgegeven om de weergave ervan te beperken. U bent de enige die de unieke sleutel kan genereren, die elke gebruiker nodig heeft om de video's te bekijken. Deze sleutel zorgt er dus voor dat alleen personen die u vooraf hebt geverifieerd toegang hebben.

Dit maakt het mogelijk om de toegang tot de video's te controleren en alleen bepaalde personen toe te staan, terwijl anderen worden geweigerd; dit is handig in gevallen zoals pay-per-view of beperkte uitzendingen. Houd er echter rekening mee dat u zelf de integratie met uw bestaande systeem moet ontwikkelen.

Als de hash ongeldig is, wordt bij het openen van de video een foutpagina met de melding "403 forbidden" weergegeven.

Toegangsbeperking activeren voor de importmap

Wanneer eenmaal een wachtwoord is ingesteld voor de doelmap, wordt dit automatisch toegepast op alle nieuwe media die worden geïmporteerd. Om deze map te configureren:

1. Klik hier om naar het beheer van uw VOD/AOD te gaan in het Infomaniak Manager (hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product:
   
3. Klik op Media in het linkermenu.
4. Klik op Media beheren in het linkermenu.
5. Klik op het pictogram om een nieuwe map aan te maken:
   
6. Geef de map een naam.
7. Klik op de blauwe knop om de map aan te maken.
8. Klik op Configuratie:
   
9. Klik op het tabblad Beperkingen.
10. Schakel indien nodig de schakelaar uit om de overerving van de bovenliggende map te verwijderen, zodat u uw eigen regels voor deze specifieke map kunt configureren.
11. Schakel de schakelaar in om de beperking per unieke sleutel te configureren.
12. Klik op Opslaan nadat u de verschillende gewenste opties hebt geconfigureerd:
    

1. Een VOD API-token aanmaken

Om toegang te krijgen tot de VOD-API, moet u zich eerst authenticeren met een token (dit hoeft slechts één keer te gebeuren; het token is geldig voor alle mappen die u wilt beschermen). Raadpleeg deze andere handleiding en de documentatie https://developer.infomaniak.com/getting-started#authentication.

2. Maak het afspeeltoken aan

Deze stap moet op uw website/applicatie worden uitgevoerd en dit token moet uniek zijn, dus voor elke bezoeker afzonderlijk worden gegenereerd.

Het is daarom belangrijk dat de pagina die verantwoordelijk is voor het genereren van het token geen cache heeft, om de uniciteit van het token te garanderen.

POST  https://api.vod2.infomaniak.com/api/pub/v1/channel/channel_id/share/share_id/token

channel_id = 1227
share_id = komt overeen met de identificatie van uw video
Voorbeeld: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

De lijst met parameters is beschikbaar in de documentatie https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Gebruik van het unieke token in een media

Het token dat in stap 2 hierboven is verkregen, wordt als parameter aan de media doorgegeven; het is uniek en dus anders voor elke bezoeker:

<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>