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, procédez comme suit :

1. Vérifiez les valeurs des paramètres pour les caractères non pris en charge : :?,&,,=, % /

2. Appliquez un codage URL approprié pour les caractères spéciaux (voir) MediaTailor référence et limites des paramètres

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

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

1. Utilisez des noms et des valeurs de paramètres plus courts dans la mesure du possible

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

3. Utilisez des alias de configuration pour associer 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 liées aux 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 critical URLs (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 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 :

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 vs origine vs manifeste)

4. Encodage et formatage d'URL

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

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 correspondent aux valeurs attendues

3. Vérifiez que les paramètres apparaissent correctement URLs (manifeste, ADS, origine)

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

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 utilisateur

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