Modifier les en-têtes de requête entrante - Edge Security Acceleration

Ajoutez, modifiez ou supprimez des en-têtes de requête entrante spécifiques sur le nœud edge afin de contrôler ce que reçoit votre backend. Vous pouvez par exemple injecter des en-têtes Accept-Encoding ou Accept-Language pour personnaliser l'expérience des visiteurs et suivre leur comportement d'utilisation.

Présentation

La fonctionnalité de modification des en-têtes de requête entrante permet d'ajouter, de modifier ou de supprimer des en-têtes de requête sur les nœuds edge avant qu'ils n'atteignent votre origine. Elle vous permet ainsi de :

Contrôler le routage vers l'origine — Ajoutez ou modifiez des en-têtes pour définir la manière dont les serveurs d'origine traitent les requêtes.
Enrichir les journaux du backend — Transmettez des informations client (telles que les adresses IP source) via des en-têtes personnalisés à des fins de journalisation et d'analyse.
Supprimer les en-têtes non pertinents — Éliminez les en-têtes inutiles de la requête d'origine pour réduire la surcharge réseau et renforcer la sécurité.

Configurer les en-têtes de requête entrante

Prérequis

Avant de commencer, assurez-vous d'avoir :

Créé un site dans la console ESA. Pour plus d'informations, consultez Priorité des règles.
Activé la fonctionnalité Rules pour votre site.

Étapes

Dans la console ESA, sélectionnez Websites, puis dans la colonne Websites, cliquez sur le site cible.
Dans le volet de navigation de gauche, choisissez Websites > Website.
Cliquez sur Modify request header > Client to ESA > Create Rule.

Dans la zone Add Request Header Modification Rule, configurez les champs suivants :

Rule Name : Saisissez un nom personnalisé pour la règle.
If requests match... : Sélectionnez la condition déterminant les requêtes auxquelles la règle s'applique.
- All Requests : La règle s'applique à toutes les requêtes du site actuel.
- Filtered Requests : La règle ne s'applique qu'au trafic correspondant à une expression personnalisée. Configurez une expression pour filtrer le trafic.

Modify Request Header : Spécifiez l'action à appliquer aux requêtes correspondantes. Reportez-vous au tableau suivant pour choisir le type d'opération et le mode.

Opération	Mode	Description	Exemple
Add	Static	Garantit la présence de l'en-tête de requête spécifié dans la requête envoyée à l'origine. Crée l'en-tête s'il n'existe pas ou écrase l'en-tête existant portant le même nom.	Pour ajouter un en-tête de requête nommé `x-code` avec la valeur `key1`, saisissez : - Header Name : `x-code` - Header Value : `key1`
Add	Dynamic	La valeur de l'en-tête peut être définie par une expression.	Pour ajouter un en-tête de requête nommé `True-Client-IP` avec la valeur `ip.src` afin d'enregistrer l'adresse IP source du client, saisissez : - Header Name : `True-Client-IP` - Header Value : `ip.src`
Modify	Static	Modifie la valeur d'un en-tête de requête spécifié dans la requête envoyée à l'origine. Cette action ne prend effet que si un en-tête portant le nom spécifié existe déjà ; sinon, aucune modification n'est effectuée.	Pour remplacer la valeur de l'en-tête de requête nommé `x-code` par `key2` dans la requête envoyée à l'origine, saisissez : - Header Name : `x-code` - Header Value : `key2`
Modify	Dynamic	La valeur de l'en-tête peut être définie par une expression.	Pour attribuer à l'en-tête de requête nommé `True-Client-IP` la valeur `ip.src` dans la requête envoyée à l'origine (définissant ainsi sa valeur sur l'adresse IP source du client), saisissez : - Header Name : `True-Client-IP` - Header Value : `ip.src`
Delete		Supprime de la requête envoyée à l'origine tous les en-têtes correspondant au Header Name spécifié, y compris les doublons éventuels.	Pour supprimer l'en-tête de requête nommé `x-code`, saisissez le Header Name : `x-code`.

Remarque

Les noms d'en-tête de requête commençant par ali-swift, ali-esa-inner, x-swift ou x-site ne peuvent pas être configurés (insensibles à la casse).
Pour spécifier plusieurs valeurs dans le champ Header Value, séparez-les par une virgule (,).
L'opération Delete fonctionne de manière identique en mode Static et Dynamic. L'opération Modify ne prend effet que si la requête d'origine contient un en-tête portant le nom spécifié ; dans le cas contraire, aucune action n'est exécutée.
Au sein d'une même règle, les opérations multiples sont exécutées de façon séquentielle. Si différentes opérations ciblent le même nom d'en-tête, la dernière opération écrase les précédentes.

Exemples de configuration d'expressions dynamiques

Cet exemple illustre l'ajout d'une expression dynamique permettant de transmettre l'adresse IP source du client dans un en-tête de requête personnalisé.

Ajouter une expression dynamique pour True-Client-IP-IN

Procédure

Dans la console ESA, sélectionnez Websites, puis dans la colonne Website, cliquez sur le site cible.
Dans le volet de navigation de gauche, choisissez Rules > Transform Rules.
Cliquez sur Websites > Client to ESA > Website.
Dans la zone Add Incoming Request Header, configurez les champs suivants :
- Rule Name : Saisissez add-client-ip-in.
- Match Condition : Sélectionnez All Requests pour appliquer la règle à toutes les requêtes du site actuel.
- Header Operation :
  - Type : Dynamic
  - Operation : Add
  - Header Name : True-Client-IP-IN
  - Header Value : ip.src

Vérification du résultat

Une fois la configuration terminée, l'en-tête true-client-ip-in contient l'adresse IP source du client.

Result verification