In dieser Anleitung wird erklärt, wie Sie ein Token generieren und welche Felder für Tokens erforderlich und optional sind.
Wenn Sie ein Token erstellen möchten, müssen Sie einen zu signierenden String erstellen, der in dieser Anleitung als signierter Wert bezeichnet wird. Der signierte Wert enthält Parameter, die den zu schützenden Inhalt, die Ablaufzeit des signierten Werts usw. beschreiben.
Sie verwenden den signierten Wert beim Erstellen eines Tokenstrings. Zum Erstellen eines Tokenstrings erstellen Sie die Parameter für das Token, z. B. einen Hash-basierten Nachrichtenauthentifizierungscode (HMAC) mit Symmetrieschlüssel des signierten Werts.
Media CDN verwendet das endgültige zusammengesetzte Token, um Ihre Inhalte zu schützen.
Token erstellen
Erstellen Sie einen signierten Wert, indem Sie einen String verketten, der die erforderlichen Tokenfelder und die gewünschten optionalen Tokenfelder enthält. Trennen Sie die einzelnen Felder und Parameter durch eine Tilde
~.Signieren Sie den signierten Wert entweder mit einer Ed25519-Signatur oder einem HMAC mit symmetrischem Schlüssel.
Erstellen Sie das Token, indem Sie einen String verketten, der die erforderlichen und optionalen Tokenfelder enthält. Trennen Sie die einzelnen Felder und Parameter durch eine Tilde (
~).Beim Erstellen des Tokens sind die Werte für jeden der Parameter zwischen dem signierten Wert und dem Tokenstring identisch, mit folgenden Ausnahmen:
FullPathHeaders
Das folgende Codebeispiel zeigt, wie Sie ein Token programmatisch erstellen:
Python
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Media CDN zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Media CDN zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
In den folgenden Abschnitten werden die von Tokens verwendeten Felder beschrieben.
Erforderliche Tokenfelder
Die folgenden Felder sind für jedes Token erforderlich:
Expires- Eines der folgenden Elemente:
PathGlobsURLPrefixFullPath
- Eine der folgenden Optionen:
Signaturehmac
Wenn nicht anders angegeben, wird bei Parameternamen und ihren Werten die Groß-/Kleinschreibung beachtet.
In der folgenden Tabelle werden die einzelnen Parameter erläutert:
| Feldname/Aliasse | Tokenparameter | Signierter Wert |
|---|---|---|
|
Ganzzahlsekunden, die seit der Unix-Epoche verstrichen sind (1970-01-01T00:00:00Z) | Expires=EXPIRATION_TIME, danach ist das Token nicht mehr gültig. |
|
Eine Liste mit bis zu fünf Pfadsegmenten, für die Zugriff gewährt werden soll. Die Segmente können entweder durch Kommas (
Pfadparameter, die mit Semikolons ( Achte daher darauf, dass deine URL die folgenden Sonderzeichen nicht enthält: |
PathGlobs=PATHS |
URLPrefix |
Eine websichere base64-codierte URL, einschließlich des Protokolls Gültige URLPrefix-Werte für „https://example.com/foo/bar.ts“ sind beispielsweise „https://example.com“, „https://example.com/foo“ und „https://example.com/foo/bar“. |
URLPrefix=BASE_64_URL_PREFIX |
FullPath |
Keine. Wenn Sie FullPath in einem Token angeben, duplizieren Sie nicht den Pfad, den Sie im signierten Wert angegeben haben. Geben Sie in einem Token den Feldnamen ohne = an. |
FullPath=FULL_PATH_TO_OBJECT |
Signature |
Eine websichere, mit Base64 verschlüsselte Version der Signatur. | Nicht zutreffend |
hmac |
Eine websichere, mit Base64 verschlüsselte Version des HMAC-Werts. | Nicht zutreffend |
PathGlobs-Platzhaltersyntax
In der folgenden Tabelle wird die Platzhaltersyntax für PathGlobs erläutert.
| Operator | Stimmt überein mit | Beispiele |
|---|---|---|
* (Sternchen) |
Entspricht null oder mehr Zeichen im Pfad der URL, einschließlich Schrägstrichen (/).
|
|
? (Fragezeichen) |
Entspricht einem einzelnen Zeichen im Pfad der URL, ausgenommen Schrägstriche (/).
|
/videos/s?main.m3u8 entspricht /videos/s1main.m3u8. Sie stimmt weder mit /videos/s01main.m3u8 noch mit /videos/s/main.m3u8 überein.
|
Globs müssen für URL-Pfade entweder mit einem Sternchen (*) oder einem Schrägstrich (/) beginnen.
Da * und /* mit allen URL-Pfaden übereinstimmen, empfehlen wir, keines der beiden in Ihren signierten Tokens zu verwenden. Für maximalen Schutz sollten Sie darauf achten, dass Ihre Globs mit den Inhalten übereinstimmen, auf die Sie Zugriff gewähren möchten.
Optionale Tokenfelder
Wenn nicht anders angegeben, wird bei Parameternamen und ihren Werten die Groß-/Kleinschreibung beachtet.
In der folgenden Tabelle werden Parameternamen, Aliasse und Details für optionale Parameter erläutert:
| Feldname/Aliasse | Parameter | Signierter Wert |
|---|---|---|
|
Ganzzahlsekunden seit der Unix-Epoche (1970-01-01T00:00:00Z) | Starts=START_TIME |
IPRanges |
Eine Liste mit bis zu fünf IPv4- und IPv6-Adressen im CIDR-Format, für die diese URL im websicheren Base64-Format gültig ist. Geben Sie beispielsweise Die Aufnahme von IPRanges in die Tokens ist möglicherweise nicht sinnvoll, wenn Kunden von WAN-Migrationen bedroht sind oder wenn der Netzwerkpfad zu Ihrem Anwendungs-Frontend ein anderer ist als der Bereitstellungspfad.
Media CDN lehnt Clients mit dem Code In den folgenden Fällen kann es vorkommen, dass Media CDN Clients mit dem Code
All diese Faktoren können dazu beitragen, dass ein bestimmter Client während einer Videowiedergabesitzung eine nicht-deterministische IP-Adresse hat. Wenn sich die Client-IP-Adresse nach der Zugriffserteilung ändert und der Client dann versucht, ein Videosegment in seinen Wiedergabepuffer herunterzuladen, erhält er von Media CDN den Fehler |
IPRanges=BASE_64_IP_RANGES |
|
Ein beliebiger String, der für die Loganalyse oder das Wiedergabe-Tracing nützlich ist. Verwenden Sie %-codierte oder websichere base64-codierte Strings, um ein ungültiges Token zu vermeiden. Die folgenden Zeichen dürfen nicht für |
SessionID=SESSION_ID_VALUE |
|
Ein beliebiger String, der für die Loganalyse nützlich ist. Verwenden Sie %-codierte oder websichere base64-codierte Strings, um die Erstellung eines ungültigen Tokens zu vermeiden. Die folgenden Zeichen dürfen nicht für |
data=DATA_VALUE |
Headers |
Eine durch Kommas getrennte Liste mit bis zu 10 Headerfeldnamen. Bei Headernamen wird die Groß-/Kleinschreibung für Suchvorgänge in der Anfrage nicht berücksichtigt. Bei Headernamen in den signierten Werten wird zwischen Groß- und Kleinschreibung unterschieden. Wenn ein Header fehlt, ist der Wert ein leerer String. Jeder in Daher empfehlen wir, benutzerdefinierte Header mit intransparenten Werten wie einer Sitzungs- oder Gerätekennung zu signieren. Vermeiden Sie das Signieren von Headern, deren Werte häufig Kommas enthalten, z. B. |
Headers=HEADER_1_NAME=HEADER_1_EXPECTED_VALUE,
HEADER_2_NAME=HEADER_2_EXPECTED_VALUE |
Beispiele
In den folgenden Abschnitten finden Sie Beispiele für das Generieren von Tokens.
Beispiel mit FullPath
Betrachten Sie das folgende Beispiel mit dem Feld FullPath:
- Angeforderter Artikel:
http://example.com/tv/my-show/s01/e01/playlist.m3u8 - Ablaufzeit: 160000000
Der signierte Wert ist:
Expires=160000000~FullPath=/tv/my-show/s01/e01/playlist.m3u8
Wenn Sie ein Token erstellen möchten, signieren Sie den signierten Wert entweder mit einer Ed25519-Signatur oder einem HMAC mit symmetrischem Schlüssel.
Im Folgenden finden Sie Beispiel-Tokens, die aus einem signierten Wert erstellt wurden:
Ed25519-Signatur
Expires=160000000~FullPath~Signature=SIGNATURE_OF_SIGNED_VALUE
Dabei ist SIGNATURE_OF_SIGNED_VALUE die ED25519-Signatur des zuvor erstellten signierten Werts.
Symmetrischer Schlüssel-HMAC
Expires=160000000~FullPath~hmac=HMAC_OF_SIGNED_VALUE
Dabei ist HMAC_OF_SIGNED_VALUE der symmetrische HMAC-Schlüssel des zuvor erstellten signierten Werts.
In den vorherigen Beispielen wird FullPath im Token angegeben, der Wert wird jedoch nicht aus dem im signierten Wert angegebenen Pfad wiederholt. So können Sie den vollständigen Pfad der Anfrage signieren, ohne die Anfrage im Token zu duplizieren.
Beispiel mit URLPrefix
Betrachten Sie das folgende Beispiel mit dem Feld URLPrefix:
- Angeforderter Artikel:
http://example.com/tv/my-show/s01/e01/playlist.m3u8 - Ablaufzeit: 160000000
Der signierte Wert ist:
Expires=160000000~URLPrefix=aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4
Im vorherigen Beispiel haben wir den Pfad zum angeforderten Element http://example.com/tv/my-show/s01/e01/playlist.m3u8 durch den Pfad zum Element im websicheren Base64-Format aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4 ersetzt.
Wenn Sie ein Token erstellen möchten, signieren Sie den signierten Wert entweder mit einer Ed25519-Signatur oder einem HMAC mit symmetrischem Schlüssel.
Im Folgenden finden Sie Beispiel-Tokens, die aus einem signierten Wert erstellt wurden:
Ed25519-Signatur
Expires=160000000~URLPrefix=aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4~Signature=SIGNATURE_OF_SIGNED_VALUE
Dabei ist SIGNATURE_OF_SIGNED_VALUE die ED25519-Signatur des zuvor erstellten signierten Werts.
Symmetrischer Schlüssel-HMAC
Expires=160000000~URLPrefix=aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4~hmac=HMAC_OF_SIGNED_VALUE
Dabei ist HMAC_OF_SIGNED_VALUE der symmetrische HMAC-Schlüssel des zuvor erstellten signierten Werts.
Beispiel mit Headers
Betrachten Sie das folgende Beispiel mit dem Feld Headers:
- Angeforderter Artikel:
http://example.com/tv/my-show/s01/e01/playlist.m3u8 - Ablaufzeit: 160000000
- PathGlobs-Wert:
* - Erwartete Anfrageheader:
x-session-id: abcd1234x-client-version: 5.2.0
Der signierte Wert ist:
Expires=160000000~PathGlobs=*~Headers=x-session-id=abcd1234,x-client-version=5.2.0
Wenn Sie ein Token erstellen möchten, signieren Sie den signierten Wert entweder mit einer Ed25519-Signatur oder einem HMAC mit symmetrischem Schlüssel.
Im Folgenden finden Sie Beispiel-Tokens, die aus einem signierten Wert erstellt wurden:
Ed25519-Signatur
Expires=160000000~PathGlobs=*~Headers=x-session-id,x-client-version~Signature=SIGNATURE_OF_SIGNED_VALUE
Dabei ist SIGNATURE_OF_SIGNED_VALUE die ED25519-Signatur des zuvor erstellten signierten Werts.
Symmetrischer Schlüssel-HMAC
Expires=160000000~PathGlobs=*~Headers=x-session-id,x-client-version~hmac=HMAC_OF_SIGNED_VALUE
Dabei ist HMAC_OF_SIGNED_VALUE der symmetrische HMAC-Schlüssel des zuvor erstellten signierten Werts.
In den vorherigen Beispielen wird Headers=x-session-id,x-client-version im Token angegeben, die erwarteten Headerwerte werden jedoch nicht aus dem signierten Wert wiederholt. So können Sie bestimmte Schlüssel/Wert-Paare im Anfrageheader signieren, ohne die Werte im Token zu duplizieren.