MediaTailor guida alla risoluzione dei parametri

AWS Elemental MediaTailor fornisce indicazioni per la risoluzione di problemi comuni relativi ai parametri in MediaTailor, tra cui restrizioni dei caratteri, 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 limitazione dei caratteri:

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

2. Applica la corretta codifica URL per i caratteri speciali (vedi) MediaTailor riferimento ai parametri e limitazioni

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

4. Prendete in considerazione 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 di interrogazione del 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:

1. Se possibile, utilizzate nomi e valori di parametro più brevi

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

3. Utilizzate alias di configurazione per mappare alias brevi a valori più lunghi (vedete) MediaTailor panoramica degli alias di configurazione

4. 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:

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 in critical URLs (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, vedere. MediaTailor guida alla 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:

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 a URLs

Flusso dei parametri di debug

Per eseguire il debug dei problemi di elaborazione dei parametri:

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

2. Verifica che gli alias di configurazione si risolvano nei valori previsti

3. Conferma che i parametri siano visualizzati nel modo corretto URLs (manifest, ADS, origin)

4. 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:

1. Limitazioni delle dimensioni di input per prevenire il sovraccarico del database

2. Codifica e sanificazione corrette dell'input dell'utente

3. 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