View a markdown version of this page

MediaTailor guida alla risoluzione dei problemi relativi ai parametri - AWS Elemental MediaTailor
Errori di restrizione dei caratteriErrori di limitazione della lunghezzaErrori relativi agli alias di configurazioneProblemi relativi al flusso di elaborazione dei parametriConsiderazioni e best practice relative alla sicurezza

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 guida alla risoluzione dei problemi relativi ai parametri

AWS Elemental MediaTailor fornisce indicazioni per la risoluzione dei problemi più comuni relativi ai parametri in MediaTailor, tra cui restrizioni di caratteri, problemi di codifica degli URL ed errori di configurazione degli alias.

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 che non compaiono negli URL manifesti

  • Errori HTTP 400 durante l'inizializzazione della sessione

  • Valori dei parametri troncati o danneggiati

  • Richieste ADS non riuscite a causa di URL non validi

Passaggi di risoluzione

Per risolvere gli errori di restrizione dei caratteri:

  1. Controlla i valori dei parametri per i caratteri non supportati::,?,,&, = % /

  2. Applica il URL-encoding codice corretto per i caratteri speciali (vediMediaTailor riferimenti e limitazioni dei parametri)

  3. Evita caratteri doppi come %%% o ==

  4. Prendi in considerazione formati di parametri alternativi se non è possibile utilizzare URL completi

Esempio Esempio di codifica degli URL

Invece di usare: 

manifest.redirect_url=https://example.com/path?param=value

Usa il URL-encoded formato: 

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 riferimenti e limitazioni dei parametri per i dettagli completi):

  • Parametri di interrogazione del manifesto (totale): 2000 caratteri

  • Nomi dei parametri ADS: 10.000 caratteri

  • Valori dei parametri ADS: 25.000 caratteri

  • URL ADS: 25.000 caratteri

Strategie di risoluzione

Per gestire i limiti di lunghezza:

  1. Usa nomi e valori dei parametri più brevi laddove possibile

  2. Dividi valori di parametri di grandi dimensioni in più parametri più piccoli

  3. Usa gli alias di configurazione per mappare alias brevi su valori più lunghi (vedi) MediaTailor panoramica degli alias di configurazione

  4. Prendi in considerazione l'utilizzo di uno storage esterno per dati di grandi dimensioni con riferimenti a parametri

Errori relativi agli 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

Gli errori seguenti si verificano in genere con gli alias di configurazione:

  • Errore HTTP 400: valore 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:

  1. Verifica che tutte le variabili di dominio siano definite come ConfigurationAliases

  2. Assicurati che le variabili dei parametri del giocatore utilizzino il player_params. prefisso

  3. Verifica che l'elenco dei valori con alias sia esaustivo per le variabili di dominio negli URL critici (,,) VideoContentSourceUrl AdSegmentUrlPrefix ContentSegmentUrlPrefix

  4. Verifica che le richieste di inizializzazione della sessione specifichino valori di alias validi

  5. Convalida la struttura JSON del parametro ConfigurationAliases

Per una guida dettagliata alla risoluzione dei problemi, consulta. MediaTailor guida alla risoluzione dei problemi relativi agli alias di configurazione

Esempio Convalida degli alias di configurazione

Assicurati che la tua 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:

  1. convalida dei parametri di inizializzazione della sessione

  2. Risoluzione degli alias di configurazione (se applicabile)

  3. Filtraggio dei parametri (ADS vs origin vs manifest)

  4. Codifica e formattazione degli URL

  5. Applicazione dei parametri agli URL

Debugging del flusso dei parametri

Per eseguire il debug dei problemi di elaborazione dei parametri:

  1. Verifica che i parametri siano specificati correttamente durante l'inizializzazione della sessione

  2. Verifica che gli alias di configurazione corrispondano ai valori previsti

  3. Conferma che i parametri vengano visualizzati negli URL corretti (manifest, ADS, origin)

  4. La codifica URL di convalida è applicata correttamente

Esempio 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 manifesto: /v1/master/.../index.m3u8?aws.sessionId=session&test=123

Considerazioni e best practice relative alla 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:

  1. Limitazioni delle dimensioni di input per evitare il sovraffollamento del database

  2. Codifica e sanificazione corrette degli input dell'utente

  3. URL-encoding 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 pattern insoliti

  • Mantieni i valori dei parametri entro i limiti di lunghezza consigliati