Ajouter des en-têtes de CloudFront demande

Vous pouvez configurer CloudFront pour ajouter des en-têtes HTTP spécifiques aux demandes CloudFront reçues des utilisateurs et transmises à votre fonction d'origine ou de périphérie. Les valeurs de ces en-têtes HTTP sont basées sur des caractéristiques de l'utilisateur ou sur la demande de l’utilisateur. Les en-têtes fournissent des informations sur le type d'appareil, l'adresse IP, l'emplacement géographique, le protocole de demande (HTTP ou HTTPS), la version HTTP, les détails de la connexion TLS et l’empreinte JA3 de l’utilisateur..

Avec ces en-têtes, votre origine ou votre fonction périphérique peut recevoir des informations sur l'utilisateur sans avoir besoin d'écrire votre propre code pour déterminer ces informations. Si votre origine renvoie des réponses différentes en fonction des informations contenues dans ces en-têtes, vous pouvez les inclure dans la clé de cache afin que les réponses soient CloudFront mises en cache séparément. Par exemple, votre origine peut répondre avec du contenu dans une langue spécifique en fonction du pays dans lequel se trouve le visualiseur, ou avec du contenu adapté à un type d'appareil spécifique. Votre origine peut également écrire ces en-têtes dans des fichiers journaux, que vous pouvez utiliser pour déterminer où se trouvent vos spectateurs, quels types d'appareils ils se trouvent, et plus encore.

Pour inclure ces en-têtes dans la clé de cache, utilisez une politique de cache. Pour plus d’informations, consultez Contrôlez la clé de cache à l'aide d'une politique et Comprendre la clé de cache.

Pour recevoir des en-têtes à l'origine sans les inclure dans la clé de cache, utilisez une politique de demande de l'origine. Pour plus d’informations, consultez Contrôlez les demandes d'origine à l'aide d'une politique.

En-têtes pour déterminer le type d’appareil de l’utilisateur

Vous pouvez ajouter les en-têtes suivants pour déterminer le type d'appareil de l'utilisateur. En fonction de la valeur de l'User-Agenten-tête, CloudFront définit la valeur de ces en-têtes sur true oufalse. Si un appareil entre dans plusieurs catégories, plusieurs valeurs peuvent être true. Par exemple, pour certaines tablettes, CloudFront définit à la fois CloudFront-Is-Mobile-Viewer et CloudFront-Is-Tablet-Viewer àtrue.

• CloudFront-Is-Android-Viewer— Réglé sur true quand CloudFront détermine que le spectateur est un appareil doté du système d'exploitation Android.

• CloudFront-Is-Desktop-Viewer— Réglé sur le true moment où CloudFront détermine que le lecteur est un appareil de bureau.

• CloudFront-Is-IOS-Viewer— Réglé sur true quand CloudFront détermine que le spectateur est un appareil doté d'un système d'exploitation mobile Apple, tel qu'un iPhone, un iPod touch et certains iPad.

• CloudFront-Is-Mobile-Viewer— Réglé sur le true moment où CloudFront détermine que le spectateur est un appareil mobile.

• CloudFront-Is-SmartTV-Viewer— Réglé sur le true moment où CloudFront détermine que le téléspectateur est un téléviseur intelligent.

• CloudFront-Is-Tablet-Viewer— Réglé sur le true moment où CloudFront détermine que le lecteur est une tablette.

En-têtes pour déterminer l'emplacement de l'utilisateur

Vous pouvez ajouter les en-têtes suivants pour déterminer la position du spectateur. CloudFront détermine les valeurs de ces en-têtes en fonction de l'adresse IP du spectateur. Pour les caractères non ASCII dans les valeurs de ces en-têtes, le CloudFront pourcentage code le caractère conformément à la section 1.2 de la RFC 3986.

• CloudFront-Viewer-Address : contient l'adresse IP de l'utilisateur et le port source de la demande. Par exemple, une valeur d'en-tête de 198.51.100.10:46532 signifie que l'adresse IP de l’utilisateur est 198.51.100.10 et que le port source de la demande est 46532.

• CloudFront-Viewer-ASN : contient le numéro de système autonome (ASN) de l'utilisateur.

  Note

  Vous pouvez ajouter CloudFront-Viewer-Address et CloudFront-Viewer-ASN dans une politique de demande d'origine, mais pas dans une politique de cache.

• CloudFront-Viewer-Country – Contient le code de pays à deux lettres du pays de l’utilisateur. Pour obtenir une liste des codes de pays, consultez ISO 3166-1 alpha-2.

• CloudFront-Viewer-City – Contient le nom de la ville de l’utilisateur.

Lorsque vous ajoutez les en-têtes suivants, CloudFront appliquez-les à toutes les demandes, à l'exception de celles qui proviennent du AWS réseau :

• CloudFront-Viewer-Country-Name – Contient le nom du pays de l’utilisateur.

• CloudFront-Viewer-Country-Region – Contient un code (jusqu’à trois caractères) représentant la région de l’utilisateur. La région est la subdivision de premier niveau (la plus large ou la moins spécifique) du code ISO 3166-2.

• CloudFront-Viewer-Country-Region-Name – Contient le nom de la région de l’utilisateur. La région est la subdivision de premier niveau (la plus large ou la moins spécifique) du code ISO 3166-2.

• CloudFront-Viewer-Latitude – Contient la latitude approximative de l’utilisateur.

• CloudFront-Viewer-Longitude – Contient la longitude approximative de l'utilisateur.

• CloudFront-Viewer-Metro-Code – Contient le code régional de l'utilisateur. Ceci n'est présent que lorsque l'utilisateur est aux États-Unis.

• CloudFront-Viewer-Postal-Code – Contient le code postal de l'utilisateur.

• CloudFront-Viewer-Time-Zone Contient le fuseau horaire de l'utilisateur, au format de base de données de fuseau horaire IANA (par exemple, America/Los_Angeles).

En-têtes pour déterminer la structure de l'en-tête de l'utilisateur

Vous pouvez ajouter les en-têtes suivants pour identifier l’utilisateur en fonction des en-têtes qu'il envoie. Par exemple, différents navigateurs peuvent envoyer des en-têtes HTTP dans un certain ordre. Si le navigateur spécifié dans l'en-tête User-Agent ne correspond pas à l'ordre d'en-tête attendu par ce navigateur, vous pouvez refuser la demande. De plus, si la valeur CloudFront-Viewer-Header-Count ne correspond pas au nombre d'en-têtes de CloudFront-Viewer-Header-Order, vous pouvez refuser la demande.

• CloudFront-Viewer-Header-Order : contient les noms d'en-tête de l'utilisateur dans l'ordre demandé, séparés par deux points. Par exemple : CloudFront-Viewer-Header-Order: Host:User-Agent:Accept:Accept-Encoding. Les en-têtes dépassant la limite de 7 680 caractères sont tronqués.

• CloudFront-Viewer-Header-Count : contient le nombre total d'en-têtes de l'utilisateur.

Autres CloudFront en-têtes

Vous pouvez ajouter les en-têtes suivants pour déterminer le protocole, la version, l'empreinte JA3 et les détails de connexion TLS de l'utilisateur :

• CloudFront-Forwarded-Proto – Contient le protocole de la demande de l’utilisateur (HTTP ou HTTPS).

• CloudFront-Viewer-Http-Version – Contient la version HTTP de la demande de l’utilisateur.

• CloudFront-Viewer-JA3-Fingerprint : contient l'empreinte JA3 de l’utilisateur. L'empreinte JA3 peut vous aider à déterminer si la demande provient d'un client connu, s'il s'agit d'un logiciel malveillant, d'un bot malveillant ou d'une application attendue (répertoriée dans la liste des applications autorisées). Cet en-tête repose sur le paquet Client Hello SSL/TLS de l'utilisateur et n'est présent que pour les demandes HTTPS.

  Note

  Vous pouvez ajouter CloudFront-Viewer-JA3-Fingerprint dans une politique de demande d’origine, mais pas dans une politique de cache.

• CloudFront-Viewer-TLS— Contient la version SSL/TLS, le code et des informations sur le handshake SSL/TLS utilisé pour la connexion entre le lecteur et. CloudFront Spécifiez la valeur au format suivant :

  SSL/TLS_version:cipher:handshake_information

  Pour handshake_information, l'en-tête peut contenir les valeurs suivantes :

  • fullHandshake – Une liaison complète a été effectuée pour la session SSL/TLS.

  • sessionResumed – Une session SSL/TLS précédente a été reprise.

  • connectionReused – Une connexion SSL/TLS précédente a été réutilisée.

  Voici quelques exemples de valeurs pour cet en-tête.

  TLSv1.3:TLS_AES_128_GCM_SHA256:sessionResumed

  TLSv1.2:ECDHE-ECDSA-AES128-GCM-SHA256:connectionReused

  TLSv1.1:ECDHE-RSA-AES128-SHA256:fullHandshake

  TLSv1:ECDHE-RSA-AES256-SHA:fullHandshake

  Pour obtenir la liste complète des versions SSL/TLS possibles et des chiffrements pouvant figurer dans cette valeur d'en-tête, reportez-vous à la section Protocoles et chiffrements pris en charge entre les utilisateurs et CloudFront.

  Note

  Vous pouvez ajouter CloudFront-Viewer-TLS dans une politique de demande d’origine, mais pas dans une politique de cache.