En-têtes de type d'appareil En-têtes de localisation du visualiseur En-têtes pour déterminer la structure des en-têtes du spectateur En-têtes liés au TLS Autres CloudFront en-têtes

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, l'empreinte digitale et JA4 l'JA3 empreinte digitale du spectateur. Vous pouvez également configurer le comportement du cache de votre distribution pour transférer WebSocket les en-têtes. Pour de plus amples informations, veuillez consulter Utilisation WebSockets avec les CloudFront distributions.

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 de plus amples informations, veuillez consulter Contrôlez les demandes d'origine à l'aide d'une politique.

Rubriques

En-têtes de type d'appareil
En-têtes de localisation du visualiseur
En-têtes pour déterminer la structure des en-têtes du spectateur
En-têtes liés au TLS
Autres CloudFront en-têtes

En-têtes de type d'appareil

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 de localisation du visualiseur

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

Note

CloudFront-Viewer-CityCloudFront-Viewer-Metro-Code, et il CloudFront-Viewer-Postal-Code se peut qu'il ne soit pas disponible pour toutes les adresses IP. Certaines adresses IP ne peuvent pas être géolocalisées avec suffisamment de précision pour obtenir ces informations.

En-têtes pour déterminer la structure des en-têtes du spectateur

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.

Vous pouvez ajouter les en-têtes suivants pour déterminer l' JA3 empreinte digitale, JA4 l'empreinte digitale et les détails de connexion TLS du spectateur :

CloudFront-Viewer-JA3-Fingerprint— Contient l'JA3 empreinte digitale du spectateur. L' JA3 empreinte digitale peut vous aider à déterminer si la demande provient d'un client connu, s'il s'agit d'un logiciel malveillant ou d'un bot malveillant, ou d'une application attendue (inscrite sur la liste autorisée).
CloudFront-Viewer-JA4-Fingerprint— Contient l' JA4empreinte digitale du spectateur. Tout comme l' JA3 empreinte digitale, l'JA4 empreinte digitale peut vous aider à déterminer si la demande provient d'un client connu, s'il s'agit d'un logiciel malveillant ou d'un bot malveillant, ou d'une application attendue (liste autorisée). Vous pouvez utiliser l'empreinte digitale pour créer une base de données d'acteurs connus, bons et mauvais, à appliquer lors de l'inspection des requêtes HTTP. Vous pouvez ensuite inspecter la valeur d'en-tête sur les serveurs Web de votre application ou dans vos Lambda @Edge et CloudFront Functions pour comparer la valeur d'en-tête à une liste d'empreintes de logiciels malveillants connus afin de bloquer les clients malveillants.
CloudFront-Viewer-TLS— Contient la SSL/TLS version, the cipher, and information about the SSL/TLS poignée de main utilisée pour établir la connexion entre le spectateur 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.

Remarques

Les JA4 empreintes digitales JA3 et sont dérivées du paquet SSL/TLSClient Hello. Ils ne sont présents que pour les requêtes HTTPS.
Pour ces en-têtes liés au TLS, vous pouvez les ajouter à une politique de demande d'origine, mais pas à une politique de cache.

Autres CloudFront en-têtes

Vous pouvez ajouter les en-têtes suivants pour déterminer l'URI de demande d'origine du visualiseur, les paramètres et valeurs de la chaîne de requête initiale, le protocole et la version :

CloudFront-Error-Uri— Contient l'URI de demande d'origine qui a été reçue du visualiseur.
CloudFront-Error-Args— Contient les paramètres et les valeurs de la chaîne de requête d'origine.
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.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Utiliser des politiques de demande d'origine gérées

Découvrez comment les politiques de demande d'origine et les politiques de cache fonctionnent ensemble