Domain-Sperre und Geo-Beschränkungen für eingebettete Videos

Sobald ein Video öffentlich ist, kann jeder, der Ihren Seitenquelltext lesen kann, seine Adresse kopieren. Manchmal ist das in Ordnung. Oft nicht: Eine andere Website bettet Ihren Player ein und verbraucht Ihren Traffic, eine Lizenz gilt nur für bestimmte Länder, oder ein Adressblock durchsucht ständig Ihre Bibliothek. UFOLOAD bietet dafür mehrere Kontrollen, die auf unterschiedlichen Ebenen wirken. Dieser Artikel erklärt, was jede davon tut, wie die Abgleichregeln funktionieren und wo jede an ihre Grenzen stößt, damit Sie sie sinnvoll kombinieren, statt sich auf einen einzigen Schalter zu verlassen.

Die Kontrollen im Überblick

Alles in dieser Liste gehört zu den Player- und Auslieferungseinstellungen Ihres Kontos und gilt für alle Ihre Videos. Die Regeln stehen in jedem Tarif bereit; nur der Download-Button selbst ist auf die Tarife Pro und Max beschränkt, wie die Preisseite zeigt.

Schritt 1: Einbettung auf Ihre Domains beschränken

Der Einbettungsplayer läuft in einem iframe auf der Seite eines anderen, und der Browser teilt ihm über den Referrer mit, um welche Seite es sich handelt. Der Player gibt diesen Host an den Server weiter, der ihn mit Ihrer Liste vergleicht. Steht der Host nicht auf der Liste, lehnt der Server mit 403 ab, und der Player zeigt statt des Videos einen Hinweis, dass es nicht verfügbar ist.

Die Abgleichregeln sind streng, und es lohnt sich, sie genau zu kennen:

• example.com erlaubt genau diesen Host und sonst nichts. www.example.com ist damit nicht erlaubt.
• *.example.com erlaubt jede Subdomain von example.com, aber nicht die blanke example.com. Um eine Website samt Subdomains abzudecken, tragen Sie beide Einträge ein.
• Groß- und Kleinschreibung spielt keine Rolle, Ports und ein abschließender Punkt werden ignoriert, sodass Example.com:8080 auf example.com passt.
• Die Liste fasst bis zu 100 Einträge. Eine leere Liste bedeutet, dass der Player überall eingebettet werden darf; das ist die Voreinstellung.
• Tragen Sie einfache Hostnamen ein. Wenn Sie versehentlich eine vollständige Adresse einfügen, wird nur der Host übernommen.

Was die Domain-Sperre nicht leistet

Diese Kontrolle stoppt beiläufiges Hotlinking: jemand fügt Ihr iframe in seine Seite ein. Sie ist keine Sicherheitsgrenze, und es ist besser zu wissen, warum. Die Prüfung stützt sich auf den Referrer, den der Browser sendet. Entfernt eine Seite den Referrer, kann der Player nicht erkennen, wo er eingebettet ist, und blockiert in diesem Fall nicht, weil Datenschutzeinstellungen und Referrer-Richtlinien sonst legitime Einbettungen kaputt machen würden. Ebenso kann ein entschlossener Besucher, der die signierte Playlist-Adresse aus dem Netzwerk-Tab kopiert, sie bis zum Ablauf woanders abspielen, denn Segmente werden anhand der Signatur im Link geprüft, nicht anhand der Seite, die sie anfordert. Auch die öffentliche Wiedergabeseite eines Videos ist durch die Domain-Liste nicht eingeschränkt: Jeder mit dem Link kann sie öffnen.

Betrachten Sie die Liste also als Zaun, der ehrliche Nachbarn draußen hält. Für stärkere Kontrolle über einen Stream, den Sie selbst ausliefern, nutzen Sie signierte Links, die unten beschrieben sind. Brauchen Sie das Gegenteil – ein Video, das nur ausgewählte Personen erreichen können –, beachten Sie, dass UFOLOAD weder private Videos noch DRM bietet; lesen Sie Selbsthosting, kostenlose Plattformen oder Videohoster, bevor Sie sich bei vertraulichen Inhalten darauf verlassen.

Schritt 2: Länder und IP-Adressen sperren

Regeln für Länder und IP-Adressen werden an zwei Stellen durchgesetzt: wenn ein Zuschauer die Wiedergabe- oder Einbettungsseite öffnet, und bei jeder Anfrage nach Playlist und Segmenten auf der Auslieferungsebene. Die Prüfungen bei der Auslieferung erfolgen für jede Anfrage einzeln und werden nicht zwischengespeichert, sodass eine neue Regel schon für das nächste Segment gilt und niemand sie umgehen kann, indem er einen bereits erhaltenen Link behält.

• Länder sind zweistellige Codes nach ISO 3166-1 alpha-2, durch Kommas getrennt, zum Beispiel US, CN, RU. Das Land des Zuschauers wird anhand der IP-Adresse in einer Geolokalisierungsdatenbank ermittelt. Jede Liste fasst bis zu 100 Einträge.
• IP-Adressen können eine einzelne Adresse wie 203.0.113.7 sein oder eine Maske mit Stern im letzten Oktett wie 203.0.113.*, die den gesamten Bereich von 256 Adressen abdeckt. IPv6-Adressen lassen sich exakt eintragen.

Zwei praktische Hinweise. Masken sind grob: Eine .*-Maske auf einem Mobilfunk- oder Büronetz sperrt jede legitime Person dahinter. Und IP-basierte Geografie ist nur so genau wie die zugrunde liegenden Adressdaten. Besucher hinter einem VPN oder Proxy erscheinen dort, wo der Ausgangsknoten steht. Eine Ländersperre ist daher ein Mittel, unerwünschten Traffic zu verringern oder eine regionale Lizenz in gutem Glauben einzuhalten, keine Garantie.

Signierte Links für Ihren eigenen Player

Wenn Sie den Stream mit hls.js auf Ihrer eigenen Seite abspielen (siehe ein HLS-Video einbetten), spielt die Domain-Liste keine Rolle, weil der Player die UFOLOAD-Seite nie um Erlaubnis fragt. Die Kontrolle kommt dann aus dem Link selbst. POST /api/v1/files/{id}/links stellt Wiedergabe- und Download-Links mit einer Gültigkeit von 60 Sekunden bis 30 Tagen aus. Fügen Sie bind_ip hinzu, um den Link an eine IPv4-Adresse zu binden, oder bind_cookie, um ihn an einen Cookie-Wert zu binden, den Ihr Server für den Besucher setzt; die Antwort nennt dann das Cookie, das die Anfrage begleiten muss.

curl -X POST "https://ufoload.com/api/v1/files/FILE_ID/links" \
  -H "Authorization: Bearer $UFOLOAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ttl": 600, "bind_ip": "203.0.113.7"}'

Eine kurze Gültigkeit kombiniert mit einer Bindung ist das stärkste verfügbare Werkzeug: Ein von Ihrer Seite kopierter Link ist binnen Minuten nutzlos und von jeder anderen Adresse aus ohnehin. Der Preis dafür ist, dass Ihr Server bei jedem Seitenaufruf Links ausstellen muss – genau das Muster, das die Upload- und API-Anleitung und die API-Dokumentation beschreiben.

Download-Domains

Player in den Tarifen Pro und Max können einen Download-Button anzeigen. Eine separate Liste, die erlaubten Download-Domains, funktioniert genau wie die Einbettungsliste, steuert aber, welche Websites die Download-Seite in einem Frame öffnen dürfen. Lassen Sie sie leer, um alle Websites zu erlauben. Besucher, die die Download-Seite direkt auf UFOLOAD öffnen, sind nicht eingeschränkt, genau wie bei der Wiedergabeseite.

Schritt 3: speichern und testen

1. Speichern Sie die Listen im Tab „Zugriff“.
2. Öffnen Sie in einem privaten Fenster eine Seite auf einer erlaubten Domain und prüfen Sie, dass das Video läuft. Prüfen Sie auch die Variante mit Subdomain.
3. Öffnen Sie dieselbe Einbettung von einer Domain, die nicht auf der Liste steht, zum Beispiel eine lokale Testseite unter einem anderen Hostnamen, und prüfen Sie, dass der Player den Hinweis „nicht verfügbar“ zeigt.
4. Testen Sie eine Länder- oder IP-Regel abgemeldet, aus einem Netz, auf das die Regel zutrifft, falls Sie eines haben.
5. Halten Sie die Referrer-Richtlinie Ihrer eigenen Seite auf einem sinnvollen Wert wie strict-origin-when-cross-origin. Eine Richtlinie no-referrer verbirgt den Host vor dem Player, der die Liste dann nicht durchsetzen kann.

Zusammen decken eine Einbettungsliste und kurzlebige signierte Links die meisten realen Fälle ab: Gelegentliches Hotlinking wird an der Tür gestoppt, und wer weitergeht, muss sich um einen Link bemühen, der abläuft. Wenn Werbung verfügbar ist und Sie sie im Player schalten, erklärt der Leitfaden zur Monetarisierung die Werbeformate und wie Werbepausen geplant werden. Die Liste aller Möglichkeiten des Players steht auf der Funktionsseite, und die Checkliste für Videohosting zeigt, welche Zugriffskontrollen Sie von jedem Anbieter verlangen sollten.