Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
MediaTailor risoluzione dei problemi dei parametri
AWS Elemental MediaTailor fornisce indicazioni per la risoluzione di problemi comuni relativi ai parametri, tra cui restrizioni dei caratteri MediaTailor, problemi di codifica degli URL ed errori degli alias di configurazione.
Errori di restrizione dei caratteri
I valori dei parametri che contengono caratteri non supportati possono causare errori o comportamenti imprevisti.
Sintomi comuni
I seguenti sintomi possono indicare problemi di limitazione dei caratteri:
-
Parametri non visualizzati nel manifesto URLs
-
Errori HTTP 400 durante l'inizializzazione della sessione
-
Valori dei parametri troncati o danneggiati
-
Richieste ADS non riuscite a causa di un formato non valido URLs
Fasi di risoluzione
Per risolvere gli errori di restrizione dei caratteri:
-
Rivedi i valori dei parametri per i caratteri non supportati:
:
,?
,,&
,=
%
/
-
Applica la corretta codifica URL per i caratteri speciali (vedi) MediaTailor riferimento ai parametri e limitazioni
-
Evita caratteri doppi come o
%%%
==
-
Considerate formati di parametri alternativi se URLs non è possibile utilizzare full
Esempio di codifica URL
Invece di usare:
manifest.redirect_url=https://example.com/path?param=value
Usa il formato con codifica URL:
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
Errori di limitazione della lunghezza
I parametri che superano i limiti di lunghezza possono essere troncati o causare errori.
Limiti di lunghezza
Si applicano i seguenti limiti di lunghezza (vedi MediaTailor riferimento ai parametri e limitazioni per i dettagli completi):
-
Parametri della query manifesto (totale): 2000 caratteri
-
Nomi dei parametri ADS: 10.000 caratteri
-
Valori dei parametri ADS: 25.000 caratteri
-
ADS URLs: 25.000 caratteri
Strategie di risoluzione
Per gestire i limiti di lunghezza:
-
Utilizzate nomi e valori di parametro più brevi, ove possibile
-
Dividi i valori dei parametri di grandi dimensioni in più parametri più piccoli
-
Usa alias di configurazione per mappare alias brevi a valori più lunghi (vedi) MediaTailor alias di configurazione e sostituzione dinamica delle variabili
-
Prendi in considerazione l'utilizzo di una memoria esterna per dati di grandi dimensioni con riferimenti ai parametri
Errori di alias di configurazione
I problemi relativi agli alias di configurazione possono causare errori HTTP 400 o valori di parametro imprevisti.
Errori comuni relativi agli alias di configurazione
I seguenti errori si verificano in genere con gli alias di configurazione:
-
Errore HTTP 400: valore dell'alias mancante o non valido
-
Le variabili di dominio non si risolvono correttamente
-
I parametri del giocatore non vengono sostituiti con valori alias
Lista di controllo per la risoluzione
Per risolvere gli errori relativi agli alias di configurazione:
-
Verifica che tutte le variabili di dominio siano definite come
ConfigurationAliases
-
Assicurati che le variabili dei parametri del giocatore utilizzino il
player_params.
prefisso -
Conferma che l'elenco dei valori con alias sia esaustivo per ogni parametro del giocatore
-
Verifica che le richieste di inizializzazione della sessione specifichino valori di alias validi
-
Convalida la struttura JSON del parametro ConfigurationAliases
Per una guida dettagliata alla risoluzione dei problemi, vedere. MediaTailor risoluzione dei problemi relativi agli alias di configurazione
Esempio Convalida degli alias di configurazione
Assicurati che la configurazione includa tutti gli alias richiesti:
"ConfigurationAliases": { "player_params.origin_domain": { "pdx": "abc.mediapackage.us-west-2.amazonaws.com", "iad": "xyz.mediapackage.us-east-1.amazonaws.com" // Must include all possible values used in session initialization } }
Problemi relativi al flusso di elaborazione dei parametri
La comprensione del flusso di elaborazione dei parametri aiuta a risolvere i problemi relativi all'inoltro e alla trasformazione dei parametri.
Ordine di elaborazione dei parametri
MediaTailor elabora i parametri nel seguente ordine:
-
convalida dei parametri di inizializzazione della sessione
-
Risoluzione degli alias di configurazione (se applicabile)
-
Filtraggio dei parametri (ADS vs origin vs manifest)
-
Codifica e formattazione degli URL
-
Applicazione dei parametri a URLs
Flusso dei parametri di debug
Per eseguire il debug dei problemi di elaborazione dei parametri:
-
Verifica che i parametri siano specificati correttamente nell'inizializzazione della sessione
-
Verifica che gli alias di configurazione si risolvano nei valori previsti
-
Conferma che i parametri siano visualizzati nel modo corretto URLs (manifest, ADS, origin)
-
La codifica URL di convalida è applicata correttamente
Esempio di flusso di parametri
Inizializzazione della sessione:
POST master.m3u8 { "playerParams": {"origin_domain": "pdx"}, "manifestParams": {"test": "123"} }
Dopo la risoluzione e l'elaborazione degli alias:
-
Richiesta di origine:
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
-
URL del manifesto:
/v1/master/.../index.m3u8?aws.sessionId=session&test=123
Considerazioni e best practice sulla sicurezza
MediaTailor implementa misure di sicurezza per la gestione dei parametri per prevenire problemi di sicurezza comuni.
Misure di sicurezza
MediaTailor implementa le seguenti misure di sicurezza:
-
Limitazioni delle dimensioni di input per prevenire il sovraccarico del database
-
Codifica e sanificazione corrette dell'input dell'utente
-
Codifica URL dell'input per prevenire il danneggiamento della risposta
Best practice
Segui queste best practice per una gestione sicura dei parametri:
-
Convalida i valori dei parametri sul lato client prima dell'invio
-
Utilizzate gli alias di configurazione per limitare i possibili valori dei parametri
-
Evita di includere informazioni sensibili nei parametri
-
Monitora l'utilizzo dei parametri per individuare modelli insoliti
-
Mantieni i valori dei parametri entro i limiti di lunghezza consigliati