Questa guida spiega come generare un token e i campi obbligatori e facoltativi per i token.
Per creare un token, devi comporre una stringa da firmare, che in questa guida chiamiamo valore firmato. Il valore firmato include parametri che descrivono i contenuti che stai proteggendo, la data/ora di scadenza del valore firmato e così via.
Utilizza il valore firmato durante la creazione di una stringa di token. Per creare una stringa di token, devi comporre i parametri per il token, ad esempio un codice HMAC (Hash-based Message Authentication Code) con chiave simmetrica del valore firmato.
Media CDN utilizza il token composto finale per proteggere i tuoi contenuti.
Crea un token
Crea un valore firmato concatenando una stringa che contiene i campi del token obbligatori e i campi del token facoltativi desiderati. Separa ogni campo ed eventuali parametri con un carattere tilde
~.Firma il valore firmato con una firma Ed25519 o un HMAC con chiave simmetrica.
Componi il token concatenando una stringa che contiene i campi del token obbligatori e facoltativi. Separa ogni campo e gli eventuali parametri con un carattere tilde
~.Quando si compone il token, i valori di ciascun parametro sono gli stessi tra il valore firmato e la stringa del token, con le seguenti eccezioni:
FullPathHeaders
Il seguente esempio di codice mostra come creare un token in modo programmatico:
Python
Per eseguire l'autenticazione in Media CDN, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per eseguire l'autenticazione in Media CDN, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Le sezioni seguenti descrivono i campi utilizzati dai token.
Campi dei token obbligatori
I seguenti campi sono obbligatori per ogni token:
Expires- Uno dei seguenti:
PathGlobsURLPrefixFullPath
- Uno dei seguenti:
Signaturehmac
Se non diversamente specificato, i nomi dei parametri e i relativi valori sono sensibili alle maiuscole.
La tabella seguente spiega ogni parametro:
| Nome campo/alias | Parametri token | Valore firmato |
|---|---|---|
|
Secondi interi trascorsi dall'epoca di Unix (1970-01-01T00:00:00Z) | Expires=EXPIRATION_TIME, dopodiché il token non è più valido. |
|
Un elenco di massimo cinque segmenti di percorso a cui concedere l'accesso. I segmenti possono essere delimitati da virgole (
I parametri di percorso, indicati con i punti e virgola ( Per questi motivi, assicurati che l'URL non contenga i seguenti caratteri speciali: |
PathGlobs=PATHS |
URLPrefix |
Un URL con codifica base64 sicuro per il web, incluso il protocollo Ad esempio, alcuni valori URLPrefix validi per `https://example.com/foo/bar.ts` sono `https://example.com`, `https://example.com/foo` e `https://example.com/foo/bar`. |
URLPrefix=BASE_64_URL_PREFIX |
FullPath |
Nessuno. Quando specifichi FullPath in un token, non duplicare il percorso specificato nel valore firmato. In un token, includi il nome del campo senza =. |
FullPath=FULL_PATH_TO_OBJECT |
Signature |
Una versione della firma sicura per il web con codifica Base64. | Non applicabile |
hmac |
Una versione con codifica Base64 sicura per il web del valore HMAC. | Non applicabile |
Sintassi con caratteri jolly PathGlobs
La tabella seguente spiega la sintassi dei caratteri jolly PathGlobs.
| Operatore | Corrisponde a | Esempi |
|---|---|---|
* (asterisco) |
Corrisponde a zero o più caratteri nel percorso dell'URL, inclusi i caratteri barra (/).
|
|
? (punto interrogativo) |
Corrisponde a un singolo carattere nel percorso dell'URL, esclusi i caratteri barra (/).
|
/videos/s?main.m3u8 corrisponde a
/videos/s1main.m3u8. Non corrisponde a /videos/s01main.m3u8 o /videos/s/main.m3u8.
|
I glob devono iniziare con un asterisco (*) o una barra (/) per i percorsi dell'URL.
Poiché * e /* corrispondono a tutti i percorsi degli URL, sconsigliamo di utilizzarli nei token firmati. Per la massima protezione, assicurati che i glob corrispondano ai contenuti a cui intendi concedere l'accesso.
Campi facoltativi del token
Se non diversamente specificato, i nomi dei parametri e i relativi valori sono sensibili alle maiuscole.
La seguente tabella spiega i nomi dei parametri, gli eventuali alias e i dettagli dei parametri facoltativi:
| Nome campo/alias | Parametri | Valore firmato |
|---|---|---|
|
Numero intero di secondi trascorsi dall'epoca di Unix (1970-01-01T00:00:00Z) | Starts=START_TIME |
IPRanges |
Un elenco di un massimo di cinque indirizzi IPv4 e IPv6 in formato CIDR per i quali questo URL è valido in formato base64 sicuro per il web. Ad esempio, per specificare gli intervalli IP "192.6.13.13/32,193.5.64.135/32", specifica Potrebbe non essere utile includere gli intervalli IP nei token quando i client rischiano di subire migrazioni WAN o nei casi in cui il percorso di rete verso il frontend dell'applicazione è diverso dal percorso di distribuzione.
Media CDN rifiuta i client con un codice Di seguito sono riportati i casi in cui Media CDN potrebbe rifiutare i client con un codice
Tutti questi fattori possono contribuire a far sì che un determinato client abbia un indirizzo IP non deterministico durante una sessione di riproduzione video. Se l'indirizzo IP client cambia dopo che hai concesso l'accesso e il client tenta di scaricare un segmento video nel buffer di riproduzione, riceve un |
IPRanges=BASE_64_IP_RANGES |
|
Una stringa arbitraria, utile per l'analisi dei log o il tracciamento della riproduzione. Per evitare di creare un token non valido, utilizza stringhe con codifica % o con codifica Base64 sicura per il web. I seguenti caratteri non devono essere utilizzati per
|
SessionID=SESSION_ID_VALUE |
|
Una stringa arbitraria, utile per l'analisi dei log. Per evitare di creare un token non valido, utilizza stringhe con codifica % o con codifica Base64 sicura per il web. I seguenti caratteri non devono essere utilizzati per
|
data=DATA_VALUE |
Headers |
Un elenco delimitato da virgole di massimo 10 nomi di campi di intestazione. I nomi delle intestazioni non fanno distinzione tra maiuscole e minuscole per le ricerche nella richiesta. I nomi delle intestazioni nei valori firmati sono sensibili alle maiuscole. Se un'intestazione non è presente, il valore è una stringa vuota. Ogni intestazione elencata in Per questo motivo, ti consigliamo di firmare le intestazioni personalizzate con valori opachi, ad esempio un identificatore di sessione o di dispositivo. Evita di firmare intestazioni i cui valori contengono comunemente virgole, ad esempio |
Headers=HEADER_1_NAME=HEADER_1_EXPECTED_VALUE,
HEADER_2_NAME=HEADER_2_EXPECTED_VALUE |
Esempi
Le sezioni seguenti mostrano esempi di generazione di token.
Esempio di utilizzo di FullPath
Considera l'esempio seguente utilizzando il campo FullPath:
- Elemento richiesto:
http://example.com/tv/my-show/s01/e01/playlist.m3u8 - Expiration time: 160000000
Il valore firmato è:
Expires=160000000~FullPath=/tv/my-show/s01/e01/playlist.m3u8
Per creare un token, firma il valore firmato con una firma Ed25519 o un HMAC con chiave simmetrica.
Di seguito sono riportati esempi di token creati da un valore firmato:
Firma Ed25519
Expires=160000000~FullPath~Signature=SIGNATURE_OF_SIGNED_VALUE
Dove SIGNATURE_OF_SIGNED_VALUE è la firma ED25519 del valore firmato creato in precedenza.
HMAC con chiave simmetrica
Expires=160000000~FullPath~hmac=HMAC_OF_SIGNED_VALUE
Dove HMAC_OF_SIGNED_VALUE è l'HMAC con chiave simmetrica del valore firmato creato in precedenza.
Negli esempi precedenti, FullPath viene fornito nel token, ma il valore non viene ripetuto dal percorso specificato nel valore firmato. In questo modo puoi firmare il percorso completo della richiesta senza duplicarla nel token.
Esempio di utilizzo di URLPrefix
Considera l'esempio seguente utilizzando il campo URLPrefix:
- Elemento richiesto:
http://example.com/tv/my-show/s01/e01/playlist.m3u8 - Expiration time: 160000000
Il valore firmato è:
Expires=160000000~URLPrefix=aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4
Nell'esempio precedente, abbiamo sostituito il percorso dell'elemento richiesto,
http://example.com/tv/my-show/s01/e01/playlist.m3u8 con il percorso dell'elemento
nel formato Base64 sicuro per il web,
aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4.
Per creare un token, firma il valore firmato con una firma Ed25519 o un HMAC con chiave simmetrica.
Di seguito sono riportati esempi di token creati da un valore firmato:
Firma Ed25519
Expires=160000000~URLPrefix=aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4~Signature=SIGNATURE_OF_SIGNED_VALUE
Dove SIGNATURE_OF_SIGNED_VALUE è la firma ED25519 del valore firmato creato in precedenza.
HMAC con chiave simmetrica
Expires=160000000~URLPrefix=aHR0cDovL2V4YW1wbGUuY29tL3R2L215LXNob3cvczAxL2UwMS9wbGF5bGlzdC5tM3U4~hmac=HMAC_OF_SIGNED_VALUE
Dove HMAC_OF_SIGNED_VALUE è l'HMAC con chiave simmetrica del valore firmato creato in precedenza.
Esempio di utilizzo di Headers
Considera l'esempio seguente utilizzando il campo Headers:
- Elemento richiesto:
http://example.com/tv/my-show/s01/e01/playlist.m3u8 - Expiration time: 160000000
- Valore PathGlobs:
* - Intestazioni della richiesta previste:
x-session-id: abcd1234x-client-version: 5.2.0
Il valore firmato è:
Expires=160000000~PathGlobs=*~Headers=x-session-id=abcd1234,x-client-version=5.2.0
Per creare un token, firma il valore firmato con una firma Ed25519 o un HMAC con chiave simmetrica.
Di seguito sono riportati esempi di token creati da un valore firmato:
Firma Ed25519
Expires=160000000~PathGlobs=*~Headers=x-session-id,x-client-version~Signature=SIGNATURE_OF_SIGNED_VALUE
Dove SIGNATURE_OF_SIGNED_VALUE è la firma ED25519 del valore firmato creato in precedenza.
HMAC con chiave simmetrica
Expires=160000000~PathGlobs=*~Headers=x-session-id,x-client-version~hmac=HMAC_OF_SIGNED_VALUE
Dove HMAC_OF_SIGNED_VALUE è l'HMAC con chiave simmetrica del valore firmato creato in precedenza.
Negli esempi precedenti, Headers=x-session-id,x-client-version viene fornito nel token, ma i valori dell'intestazione previsti non vengono ripetuti dal valore firmato. In questo modo puoi firmare coppie chiave-valore specifiche dell'intestazione della richiesta senza duplicare i valori nel token.