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

Inleiding

• Let op: de bescherming via een token is alleen effectief bij een standaardintegratie via een iframe en dus bij het gebruik van de Infomaniak Player.
• Er kunnen aanvullende toegangsbeperkingen worden ingesteld: Wachtwoord | GeoIP

Video beschermen met een unieke sleutel

U heeft de mogelijkheid om alle media in een map te beschermen door een token te genereren. Dit token is uniek voor elke bezoeker en moet als parameter aan uw media worden doorgegeven om de weergave te beperken. Alleen u kunt de unieke sleutel genereren die nodig is voor elke gebruiker om de video's te bekijken. Deze sleutel maakt het dus mogelijk om alleen de personen te autoriseren die u eerder hebt geverifieerd.

Hiermee kunt u de toegang tot video's controleren en slechts bepaalde personen toegang geven, terwijl anderen worden geweigerd; handig in gevallen zoals Pay-per-View of beperkte uitzendingen. Houd er echter rekening mee dat u de integratie in uw bestaande systeem zelf moet ontwikkelen.

Als de hash ongeldig is, wordt de toegang tot de video geweigerd en wordt een foutpagina "403 forbidden" weergegeven.

Beperking activeren op de importmap

Als het wachtwoord eenmaal is ingesteld voor de doelmap, bevatten alle nieuwe media-imports automatisch deze modus bij het afspelen. Om deze map te configureren:

1. Klik hier om toegang te krijgen tot het beheer van uw VOD/AOD in de Infomaniak Manager (Hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product:
   
3. Klik in het linkermenu op Media.
4. Klik in het linkermenu op Mediabeheer.
5. Klik op het pictogram om een nieuwe map te maken:
   
6. Geef de map een naam.
7. Klik op de blauwe knop om de map te maken.
8. Klik op Configuratie:
   
9. Klik op het tabblad Beperkingen.
10. Schakel indien nodig de schakelaar (toggle switch) uit om de overerving van de bovenliggende map te verwijderen. Dit stelt u in staat om uw eigen regels voor deze specifieke map te configureren.
11. Schakel de schakelaar (toggle switch) in om de beperking te configureren met een unieke sleutel.
12. Klik op Opslaan nadat u de gewenste opties hebt geconfigureerd:
    

1. Maak een API-VOD-token

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

2. Maak het afspeeltoken aan

Deze stap moet op uw website/applicatie worden uitgevoerd, en dit token moet uniek zijn, dus voor elke bezoeker 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 waarborgen.

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

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

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