Dieser Leitfaden erklärt, wie Sie Videos, die auf einen Infomaniak VOD-Dienst hochgeladen wurden, mit einem eindeutigen Schlüssel schützen.

Vorwort

• Achtung, der Schutz durch Token ist nur bei einer Standardintegration per iframe und somit durch die Verwendung des Infomaniak Players wirksam.
• Weitere Zugriffsbeschränkungen können aktiviert werden: Passwort | GeoIP

Video mit eindeutigem Schlüssel schützen

Sie haben die Möglichkeit, alle Medien in einem Ordner mit der Erstellung eines Tokens zu schützen. Letzteres ist für jeden Ihrer Besucher einzigartig und muss als Parameter an Ihr Medium übergeben werden, um die Ansicht zu begrenzen. Nur Sie können den eindeutigen Schlüssel generieren, der für jeden Benutzer erforderlich ist, um die Videos anzusehen. Dieser Schlüssel ermöglicht es also, nur die von Ihnen zuvor überprüften Personen zu autorisieren.

Damit können Sie den Zugriff auf Videos kontrollieren und nur bestimmte Personen zulassen, während andere abgelehnt werden; nützlich in Fällen wie Pay-per-View oder begrenzten Übertragungen. Beachten Sie jedoch, dass Sie die Integration in Ihr bestehendes System selbst entwickeln müssen.

Wenn der Hash ungültig ist, wird der Zugriff auf das Video eine Fehlerseite "403 forbidden" zurückgeben.

Einschränkung auf dem Importordner aktivieren

Wenn das Passwort einmal für den Zielordner festgelegt ist, enthalten alle neuen Medienimporte automatisch diesen Modus beim Abspielen. Um diesen Ordner zu konfigurieren:

1. Klicken Sie hier, um auf die Verwaltung Ihres VOD/AOD im Infomaniak Manager zuzugreifen (Hilfe benötigt?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts:
   
3. Klicken Sie im linken Seitenmenü auf Medien.
4. Klicken Sie im linken Seitenmenü auf Medienverwaltung.
5. Klicken Sie auf das Symbol, um einen Neuen Ordner zu erstellen:
   
6. Geben Sie dem Ordner einen Namen.
7. Klicken Sie auf die blaue Schaltfläche, um den Ordner zu erstellen.
8. Klicken Sie auf Konfiguration:
   
9. Klicken Sie auf die Registerkarte Einschränkungen.
10. Deaktivieren Sie bei Bedarf den Umschalter (Toggle Switch), um die Vererbung des übergeordneten Ordners zu entfernen. Dies, um Ihre eigenen Regeln für diesen bestimmten Ordner konfigurieren zu können.
11. Aktivieren Sie den Umschalter (Toggle Switch), um die Einschränkung durch einen eindeutigen Schlüssel zu konfigurieren.
12. Klicken Sie auf Speichern, nachdem Sie die gewünschten Optionen konfiguriert haben:
    

1. Erstellen Sie ein API-VOD-Token

Um auf die VOD-API zugreifen zu können, müssen Sie sich zunächst mit einem Token authentifizieren (dies muss nur einmal erfolgen - es wird für alle Ordner gemeinsam sein, die Sie schützen möchten); nehmen Sie sich die Zeit, diesen anderen Leitfaden und die Dokumentation https://developer.infomaniak.com/getting-started#authentication zu lesen.

2. Erstellen Sie das Wiedergabe-Token

Dieser Schritt muss auf Ihrer Website/Anwendung durchgeführt werden, und dieses Token muss einzigartig sein, also für jeden Besucher generiert werden.

Es ist daher wichtig, dass die Seite, die für die Token-Generierung verantwortlich ist, keinen Cache besitzt, um die Einzigartigkeit des Tokens zu gewährleisten.

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

channel_id = 1227
share_id = entspricht der Kennung Ihres Videos
Beispiel: https://api.vod2.infomaniak.com/res/embed/1jhvl2uqa5rdf.html

Die Liste der Parameter ist in der Dokumentation verfügbar https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Verwendung des eindeutigen Tokens in einem Medium

Das im obigen Punkt 2 abgerufene Token wird somit als Parameter an das Medium übergeben, es wird einzigartig sein und somit für jeden Besucher unterschiedlich:

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