View a markdown version of this page

MediaTailor guide de dépannage des paramètres - AWS Elemental MediaTailor
Erreurs de restriction de caractèresErreurs de limitation de longueurErreurs d'alias de configurationProblèmes de flux de traitement des paramètresConsidérations sur la sécurité et bonnes pratiques en la matière

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 dépannage des 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 de codage des 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 des caractères :

  • Paramètres n'apparaissant pas dans les URL du manifeste

  • Erreurs HTTP 400 lors de l'initialisation de la session

  • Valeurs de paramètres tronquées ou corrompues

  • Les requêtes ADS échouent en raison d'URL mal formées

É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 : :?,&,,=, % /

  2. Appliquer correctement URL-encoding pour les caractères spéciaux (voirMediaTailor référence des paramètres et limites)

  3. Évitez les caractères doubles tels que %%% ou ==

  4. Envisagez d'autres formats de paramètres si les URL complètes ne peuvent pas être utilisées

Exemple Exemple de codage d'URL

Au lieu d'utiliser : 

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

URL-encoded Format d'utilisation : 

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 des paramètres et limites pour plus de détails) :

  • Paramètres de requête du manifeste (total) : 2000 caractères

  • Noms des paramètres ADS : 10 000 caractères

  • Valeurs des paramètres ADS : 25 000 caractères

  • URL ADS : 25 000 caractères

Stratégies de résolution

Pour gérer les limites de longueur :

  1. Utilisez des noms de paramètres et des valeurs plus courts si possible

  2. Divisez les grandes valeurs de paramètres en plusieurs paramètres plus petits

  3. Utilisez des alias de configuration pour mapper des alias courts à des valeurs plus longues (voir) MediaTailor vue d'ensemble des alias de configuration

  4. 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 d'alias de configuration :

  1. Vérifiez que toutes les variables de domaine sont définies comme ConfigurationAliases

  2. Assurez-vous que les variables des paramètres du joueur utilisent un player_params. préfixe

  3. Vérifiez que la liste des valeurs aliasées est exhaustive pour les variables de domaine dans les URL critiques (VideoContentSourceUrl,AdSegmentUrlPrefix,ContentSegmentUrlPrefix)

  4. Vérifiez que les demandes d'initialisation de session spécifient des valeurs d'alias valides

  5. Valider la structure JSON du ConfigurationAliases paramètre

Pour obtenir des conseils de dépannage détaillés, consultezMediaTailor guide de dépannage des 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 de flux de traitement des paramètres

Comprendre le flux de traitement des paramètres permet de résoudre les problèmes liés à la transmission 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

  2. Résolution des alias de configuration (le cas échéant)

  3. Filtrage des paramètres (ADS, origine ou manifeste)

  4. Encodage et mise en forme des URL

  5. Application de paramètres aux URL

Flux de paramètres de débogage

Pour résoudre les problèmes liés au traitement des paramètres :

  1. Vérifiez que les paramètres sont correctement spécifiés lors de l'initialisation de la session

  2. Vérifiez que les alias de configuration sont résolus aux valeurs attendues

  3. Vérifiez que les paramètres apparaissent dans les URL correctes (manifeste, ADS, origine)

  4. Valider que le codage de l'URL est correctement appliqué

Exemple 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 d'éviter 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

  2. Encodage et nettoyage appropriés des entrées de l'utilisateur

  3. URL-encoding d'entrées pour éviter la corruption des réponses

Bonnes pratiques

Suivez ces bonnes pratiques pour une gestion sécurisée des paramètres :

  • Validez 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

  • Maintenez les valeurs des paramètres dans les limites de longueur recommandées