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 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
**Passaggi di risoluzione**
Per risolvere gli errori di restrizione dei caratteri:
1. Rivedi i valori dei parametri per i caratteri non supportati:`:`,`?`,,`&`, `=` `%` `/`
1. Applica la corretta codifica URL per i caratteri speciali (vedi) [MediaTailor riferimento ai parametri e limitazioni](parameter-comprehensive-reference.md)
1. Evita caratteri doppi come o `%%%` `==`
1. Prendete in considerazione formati di parametri alternativi se URLs non è possibile utilizzare full
**Example 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](parameter-comprehensive-reference.md) 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:
1. Se possibile, utilizzate nomi e valori di parametro più brevi
1. Dividi i valori dei parametri di grandi dimensioni in più parametri più piccoli
1. Utilizzate alias di configurazione per mappare alias brevi a valori più lunghi (vedete) [MediaTailor panoramica degli alias di configurazione](configuration-aliases-overview.md)
1. 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`
1. Assicurati che le variabili dei parametri del giocatore utilizzino il `player_params.` prefisso
1. Verifica che l'elenco dei valori con alias sia esaustivo per le variabili di dominio in critical URLs (`VideoContentSourceUrl`,,) `AdSegmentUrlPrefix` `ContentSegmentUrlPrefix`
1. Verifica che le richieste di inizializzazione della sessione specifichino valori di alias validi
1. 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](configuration-aliases-troubleshooting.md)
**Example 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
1. Risoluzione degli alias di configurazione (se applicabile)
1. Filtraggio dei parametri (ADS vs origin vs manifest)
1. Codifica e formattazione degli URL
1. 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
1. Verifica che gli alias di configurazione si risolvano nei valori previsti
1. Conferma che i parametri siano visualizzati nel modo corretto URLs (manifest, ADS, origin)
1. La codifica URL di convalida è applicata correttamente
**Example 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 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 prevenire il sovraccarico del database
1. Codifica e sanificazione corrette dell'input dell'utente
1. 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