Diese Anleitung erklärt, wie Sie importierte Videos in einem Infomaniak VOD-Dienst mit einem eindeutigen Schlüssel schützen können.

Einleitung

• Beachten Sie, dass der Schutz nur bei einer Standard-Einbettung per iFrame und somit über die Verwendung des Infomaniak-Players wirksam ist.
• Weitere Zugriffsbeschränkungen können aktiviert werden: Passwort | GeoIP
• Sie können die Vorschaubilder verwalten, die bei der Zugriffsbeschränkung verwendet werden.

Ein Video mit einem eindeutigen Schlüssel schützen

Sie haben die Möglichkeit, alle Medien in einem Ordner durch die Erstellung eines Tokens zu schützen. Dieser Token ist für jeden Ihrer Besucher eindeutig und muss als Parameter an Ihr Medium übergeben werden, um die Anzeige dieses Mediums zu beschränken. 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 Ihnen also, nur Personen zu autorisieren, die Sie zuvor überprüft haben.

Dies ermöglicht es Ihnen, den Zugriff auf die Videos zu kontrollieren und nur bestimmte Personen zu autorisieren, während andere abgewiesen werden; nützlich in Fällen wie Pay-per-View oder begrenzten Ausstrahlungen. Beachten Sie jedoch, dass Sie die Integration in Ihr bestehendes System selbst entwickeln müssen.

Wenn der Hash ungültig ist, wird beim Zugriff auf das Video eine Fehlerseite mit der Meldung "403 forbidden" angezeigt.

Die Beschränkung für den Importordner aktivieren

Wenn ein Passwort einmal für den Zielordner festgelegt wurde, wird bei allen neuen Medienimporten automatisch dieser Modus bei der Wiedergabe verwendet. Um diesen Ordner zu konfigurieren:

1. Klicken Sie hier, um auf die Verwaltung Ihres VOD/AOD im Infomaniak Manager zuzugreifen (Benötigen Sie Hilfe?).
2. Klicken Sie direkt auf den Namen des betreffenden Produkts:
   
3. Klicken Sie im linken Menü auf Medien.
4. Klicken Sie im linken Menü 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 den blauen Button, um den Ordner zu erstellen.
8. Klicken Sie auf Konfiguration:
   
9. Klicken Sie auf den Reiter Einschränkungen.
10. Deaktivieren Sie gegebenenfalls den Schalter, um die Vererbung vom übergeordneten Ordner zu entfernen, damit Sie Ihre eigenen Regeln für diesen spezifischen Ordner konfigurieren können.
11. Aktivieren Sie den Schalter, um die Einschränkung über einen eindeutigen Schlüssel zu konfigurieren.
12. Klicken Sie auf Speichern, sobald die gewünschten Optionen konfiguriert sind:
    

1. Erstellen eines VOD API-Tokens

Um auf die VOD-API zuzugreifen, müssen Sie sich zunächst mit einem Token authentifizieren (dies muss nur einmal erfolgen – es wird für alle Ordner gelten, die Sie schützen möchten). Lesen Sie dazu diese Anleitung und die Dokumentation unter https://developer.infomaniak.com/getting-started#authentication.

2. Erstellen des Wiedergabe-Tokens

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

Es ist daher wichtig, dass die Seite, die für die Generierung des Tokens zuständig ist, keinen Cache verwendet, um die Eindeutigkeit 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 finden Sie in der Dokumentation unter https://developer.infomaniak.com/docs/api/post/channel/share/token

3. Verwendung des eindeutigen Tokens für ein Medium

Das im vorherigen Schritt (Punkt 2) abgerufene Token wird als Parameter an das Medium übergeben. Es ist eindeutig und daher 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>