Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# MediaTailor guide de résolution des problèmes de paramètres
AWS Elemental MediaTailor fournit des conseils pour résoudre les problèmes courants liés aux paramètres, notamment les restrictions de caractères MediaTailor, les problèmes d'encodage d'URL et les erreurs d'alias de configuration.
## Erreurs de restriction de caractères
Les valeurs de paramètres contenant des caractères non pris en charge peuvent provoquer des erreurs ou des comportements inattendus.
**Symptômes courants**
Les symptômes suivants peuvent indiquer des problèmes de restriction de caractères :
+ Les paramètres n'apparaissent pas dans le manifeste URLs
+ Erreurs HTTP 400 lors de l'initialisation de la session
+ Valeurs de paramètres tronquées ou endommagées
+ Les requêtes ADS échouent en raison d'une malformation URLs
**Étapes de résolution**
Pour résoudre les erreurs de restriction de caractères :
1. Vérifiez les valeurs des paramètres pour les caractères non pris en charge : `:``?`,`&`,,`=`, `%` `/`
1. Appliquez un codage URL approprié pour les caractères spéciaux (voir) [MediaTailor référence et limites des paramètres](parameter-comprehensive-reference.md)
1. Évitez les caractères doubles tels que `%%%` ou `==`
1. Envisagez d'autres formats de paramètres si la version complète URLs ne peut pas être utilisée
**Example Exemple de codage d'URL**
Au lieu d'utiliser :
```
manifest.redirect_url=https://example.com/path?param=value
```
Utilisez un format URL codé :
```
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
```
## Erreurs de limitation de longueur
Les paramètres qui dépassent les limites de longueur peuvent être tronqués ou provoquer des erreurs.
**Limites de longueur**
Les limites de longueur suivantes s'appliquent (voir [MediaTailor référence et limites des paramètres](parameter-comprehensive-reference.md) pour plus de détails) :
+ Paramètres de requête du manifeste (total) : 2 000 caractères
+ noms des paramètres ADS : 10 000 caractères
+ Valeurs des paramètres ADS : 25 000 caractères
+ ADS URLs : 25.000 lettres
**Stratégies de résolution**
Pour gérer les limites de longueur :
1. Utilisez des noms et des valeurs de paramètres plus courts dans la mesure du possible
1. Divisez les grandes valeurs de paramètres en plusieurs paramètres plus petits
1. Utilisez des alias de configuration pour associer des alias courts à des valeurs plus longues (voir) [MediaTailor vue d'ensemble des alias de configuration](configuration-aliases-overview.md)
1. Envisagez d'utiliser un stockage externe pour les données volumineuses avec des références de paramètres
## Erreurs liées aux alias de configuration
Les problèmes d'alias de configuration peuvent entraîner des erreurs HTTP 400 ou des valeurs de paramètres inattendues.
**Erreurs d'alias de configuration courantes**
Les erreurs suivantes se produisent fréquemment avec les alias de configuration :
+ Erreur HTTP 400 : valeur d'alias manquante ou non valide
+ Les variables de domaine ne sont pas résolues correctement
+ Les paramètres du joueur ne sont pas remplacés par des valeurs d'alias
**Liste de contrôle de résolution**
Pour résoudre les erreurs liées aux alias de configuration :
1. Vérifiez que toutes les variables de domaine sont définies comme `ConfigurationAliases`
1. Assurez-vous que les variables des paramètres du joueur utilisent un `player_params.` préfixe
1. Vérifiez que la liste des valeurs aliasées est exhaustive pour les variables de domaine dans critical URLs (`VideoContentSourceUrl`,`AdSegmentUrlPrefix`,`ContentSegmentUrlPrefix`)
1. Vérifiez que les demandes d'initialisation de session spécifient des valeurs d'alias valides
1. Valider la structure JSON du ConfigurationAliases paramètre
Pour obtenir des conseils de dépannage détaillés, consultez[MediaTailor guide de résolution des problèmes liés aux alias de configuration](configuration-aliases-troubleshooting.md).
**Example Validation des alias de configuration**
Assurez-vous que votre configuration inclut tous les alias requis :
```
"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
}
}
```
## Problèmes de flux de traitement des paramètres
La compréhension du flux de traitement des paramètres permet de résoudre les problèmes liés au transfert et à la transformation des paramètres.
**Ordre de traitement des paramètres**
MediaTailor traite les paramètres dans l'ordre suivant :
1. Validation des paramètres d'initialisation de session
1. Résolution des alias de configuration (le cas échéant)
1. Filtrage des paramètres (ADS vs origine vs manifeste)
1. Encodage et formatage d'URL
1. Application de paramètres à URLs
**Flux de paramètres de débogage**
Pour résoudre les problèmes de traitement des paramètres :
1. Vérifiez que les paramètres sont correctement spécifiés lors de l'initialisation de la session
1. Vérifiez que les alias de configuration correspondent aux valeurs attendues
1. Vérifiez que les paramètres apparaissent correctement URLs (manifeste, ADS, origine)
1. Valider que le codage de l'URL est correctement appliqué
**Example Exemple de flux de paramètres**
Initialisation de la session :
```
POST master.m3u8
{
"playerParams": {"origin_domain": "pdx"},
"manifestParams": {"test": "123"}
}
```
Après la résolution et le traitement des alias :
+ Demande d'origine : `https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd`
+ URL du manifeste : `/v1/master/.../index.m3u8?aws.sessionId=session&test=123`
## Considérations sur la sécurité et bonnes pratiques en la matière
MediaTailor met en œuvre des mesures de sécurité pour la gestion des paramètres afin de prévenir les problèmes de sécurité courants.
**Mesures de sécurité**
MediaTailor met en œuvre les mesures de sécurité suivantes :
1. Limitations de taille d'entrée pour éviter le gonflement de la base de données
1. Encodage et nettoyage appropriés des entrées utilisateur
1. Encodage URL de l'entrée pour empêcher la corruption de la réponse
**Bonnes pratiques**
Suivez les meilleures pratiques suivantes pour une gestion sécurisée des paramètres :
+ Valider les valeurs des paramètres côté client avant de les envoyer
+ Utiliser des alias de configuration pour limiter les valeurs de paramètres possibles
+ Évitez d'inclure des informations sensibles dans les paramètres
+ Surveillez l'utilisation des paramètres pour détecter les modèles inhabituels
+ Maintenir les valeurs des paramètres dans les limites de longueur recommandées