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 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, procédez comme suit :
-
Vérifiez les valeurs des paramètres pour les caractères non pris en charge :
:
?
,&
,,=
,%
/
-
Appliquez un codage URL approprié pour les caractères spéciaux (voir) MediaTailor référence et limites des paramètres
-
Évitez les caractères doubles tels que
%%%
ou==
-
Envisagez d'autres formats de paramètres si la version complète URLs ne peut pas être utilisée
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 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 :
-
Utilisez des noms et des valeurs de paramètres plus courts dans la mesure du possible
-
Divisez les grandes valeurs de paramètres en plusieurs paramètres plus petits
-
Utilisez des alias de configuration pour associer des alias courts à des valeurs plus longues (voir) MediaTailor alias de configuration et remplacement dynamique des variables
-
Envisagez d'utiliser un stockage externe pour les données volumineuses avec des références de paramètres
Erreurs d'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 :
-
Vérifiez que toutes les variables de domaine sont définies comme
ConfigurationAliases
-
Assurez-vous que les variables des paramètres du joueur utilisent un
player_params.
préfixe -
Vérifiez que la liste des valeurs aliasées est exhaustive pour chaque paramètre du joueur
-
Vérifiez que les demandes d'initialisation de session spécifient des valeurs d'alias valides
-
Valider la structure JSON du ConfigurationAliases paramètre
Pour obtenir des conseils de dépannage détaillés, consultezMediaTailor résolution des problèmes liés aux alias de configuration.
Exemple 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 liés au 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 :
-
Validation des paramètres d'initialisation de session
-
Résolution des alias de configuration (le cas échéant)
-
Filtrage des paramètres (ADS vs origine vs manifeste)
-
Encodage et formatage d'URL
-
Application de paramètres à URLs
Flux de paramètres de débogage
Pour résoudre les problèmes liés au traitement des paramètres, procédez comme suit :
-
Vérifiez que les paramètres sont correctement spécifiés lors de l'initialisation de la session
-
Vérifiez que les alias de configuration correspondent aux valeurs attendues
-
Vérifiez que les paramètres apparaissent correctement URLs (manifeste, ADS, origine)
-
Valider que le codage de l'URL est correctement appliqué
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 relatives à la sécurité et meilleures pratiques
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 :
-
Limitations de taille d'entrée pour éviter le gonflement de la base de données
-
Encodage et nettoyage appropriés des entrées utilisateur
-
Encodage URL de l'entrée pour empêcher la corruption de la réponse
Bonnes pratiques
Suivez ces bonnes pratiques 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