Configurer le transfert Host d'en-têtes - AWS Elemental MediaTailor

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.

Configurer le transfert Host d'en-têtes

Par défaut, Amazon CloudFront ne transmet pas l'Hosten-tête aux sources situées en aval. Cependant, AWS Elemental MediaTailor nécessite que l'Hosten-tête fonctionne correctement. Vous devez configurer votre CloudFront distribution pour transférer l'Hosten-tête à MediaTailor.

Important

Cette configuration est essentielle au bon MediaTailor fonctionnement. Sans l'Hosten-tête, MediaTailor impossible de traiter les demandes ou de générer des manifestes avec le CDN URLs correct.

Méthodes pour transférer l'Hosten-tête

Configurez le transfert d'Hosten-têtes à l'aide de l'une des méthodes suivantes :

Politique de demande d'origine (recommandée)

Utilisez une politique de demande d'origine gérée ou personnalisée qui inclut l'en-tête Host.

Valeurs transmises héritées

Configurez les valeurs transmises directement dans le comportement du cache. Disponible pour les distributions existantes, mais déconseillé pour les nouvelles.

Utilisation de la politique de demande d'origine (recommandé)

L'approche recommandée consiste à utiliser une politique de demande d'origine qui transmet l'en-tête Host :

Pour configurer le transfert Host d'en-têtes avec la politique de demande d'origine
  1. Dans la CloudFront console, sélectionnez votre distribution.

  2. Choisissez l’onglet Comportements.

  3. Sélectionnez le comportement que vous souhaitez modifier ou créez-en un nouveau.

  4. Pour la politique de demande Origin, deux options s'offrent à vous :

    1. Option 1 (recommandée) : Sélectionnez une politique AllViewergérée, qui transmet tous les en-têtes du visualiseur, y compris Host.

    2. Option 2 : créer une politique de demande d'origine personnalisée qui inclut spécifiquement l'Hosten-tête :

      1. Choisissez Create Policy (Créer une politique).

      2. Dans la section En-têtes, sélectionnez Inclure les en-têtes suivants.

      3. Ajoutez Host à la liste des en-têtes.

      4. Incluez également les autres en-têtes obligatoires : User-AgentAccept-Encoding, etX-Forwarded-For.

      5. Enregistrez la politique et appliquez-la à votre comportement.

  5. Enregistrez vos modifications.

Utilisation des anciennes valeurs transmises

Si vous utilisez une distribution existante avec une ancienne configuration de valeurs transférées, vous pouvez ajouter le transfert Host d'en-tête :

Pour configurer le transfert Host d'en-têtes avec les anciennes valeurs transférées
  1. Dans la CloudFront console, sélectionnez votre distribution.

  2. Choisissez l’onglet Comportements.

  3. Sélectionnez le comportement que vous souhaitez modifier.

  4. Dans la section Clé de cache et demandes d'origine, sélectionnez Paramètres de cache hérités.

  5. Dans le menu déroulant En-têtes, sélectionnez Whitelist.

  6. Ajoutez les en-têtes suivants à la liste blanche :

    • Host

    • User-Agent

    • Accept-Encoding

    • X-Forwarded-For

  7. Enregistrez vos modifications.

Note

L'ancienne approche des valeurs transmises n'est pas recommandée pour les nouvelles distributions. Envisagez de migrer vers les politiques de demande d'origine pour améliorer les performances et faciliter la gestion.

Vérifier le transfert Host d'en-tête

Après avoir configuré le transfert d'Hosten-têtes, vérifiez qu'il fonctionne correctement :

Pour vérifier le transfert Host d'en-têtes
  1. Attendez que vos modifications CloudFront de distribution soient déployées (cela peut prendre plusieurs minutes).

  2. Soumettez une demande de test à votre CloudFront distribution pour obtenir un manifeste.

  3. Vérifiez que le manifeste est renvoyé avec succès et qu'il contient le CDN URLs attendu.

  4. Surveillez MediaTailor les journaux pour vous assurer que les demandes sont traitées correctement.

Si vous rencontrez des problèmes, consultez la documentation de dépannage du CDN pour obtenir des conseils.

Ressources supplémentaires

Pour plus d'informations sur le transfert d' CloudFront en-têtes, consultez les ressources suivantes :