Configurer les en-têtes de requête HTTP vers l'origine - - Centre de documentation Alibaba Cloud

Par défaut, Alibaba Cloud et DCDN transfèrent les en-têtes de requête, y compris ceux contenant l'adresse IP du client. Vous pouvez également configurer des en-têtes personnalisés. Pour réécrire les en-têtes HTTP dans les requêtes vers l'origine, modifiez les en-têtes de requête sortante. Cette fonctionnalité permet d'ajouter, de supprimer, de modifier ou de remplacer les en-têtes de requête HTTP vers l'origine afin de répondre à vos besoins métier.

Prérequis

Cette fonctionnalité n'est pas activée par défaut. Pour l'utiliser sur un domaine, vous devez d'abord soumettre une demande pour l'activer.

Contexte

Un en-tête de requête HTTP fait partie intégrante d'un message de requête HTTP et sert à transmettre des paramètres spécifiques à un serveur.

Lorsqu'un point de présence (POP) ou DCDN envoie une requête à un serveur d'origine pour récupérer des ressources, ce dernier peut accéder aux informations contenues dans l'en-tête de la requête vers l'origine. Utilisez cette fonctionnalité pour réécrire les informations d'en-tête HTTP dans les requêtes vers l'origine et transmettre des paramètres spécifiques à votre serveur d'origine.

Pour savoir comment un serveur d'origine récupère l'adresse IP réelle du client à partir de l'en-tête X-Forwarded-For dans une requête vers l'origine, consultez Obtenir l'adresse IP réelle d'un client.

Remarques d'utilisation

Une requête sortante est un message HTTP envoyé par DCDN à un serveur d'origine. La modification de la configuration des en-têtes de requête sortante affecte uniquement les messages HTTP envoyés par DCDN au serveur d'origine. Cette configuration n'a aucun impact sur les messages HTTP servis directement aux utilisateurs par les POP DCDN.
La modification des en-têtes de requête sortante n'est pas prise en charge pour les noms de domaine génériques.
Si cette fonctionnalité est configurée avec des conditions issues du moteur de règles, l'ordre d'exécution dépend de la priorité des conditions de règle, et non de l'ordre de configuration de la fonctionnalité.

Par défaut, Alibaba Cloud et DCDN incluent les en-têtes de requête HTTP suivants dans les requêtes vers l'origine. Aucune configuration supplémentaire n'est nécessaire.

En-tête HTTP vers l'origine	Description	Exemple
Ali-Cdn-Real-Ip	L'adresse IP réelle du client se connectant à un POP ou DCDN.	Ali-Cdn-Real-Ip:192.168.0.1
X-Forwarded-For	Les adresses IP du client et de tous les POP ou DCDN intermédiaires situés sur le chemin de la requête vers l'origine.	X-Forwarded-For:192.168.0.1, 172.16.0.1
X-Client-Scheme	Le protocole de couche applicative, tel que HTTP ou HTTPS, utilisé par un client pour envoyer une requête à un POP ou DCDN.	X-Client-Scheme:http
Host	Le nom de domaine du site d'origine ciblé par la requête vers l'origine.	Host:example.com
Via	Les noms de tous les POP ou DCDN traversés par la requête du client.	Via:cn2546-10.l1, cache1.cn2546-10, l2cn2547-7.l2, cache1.l2cn2547-7

Si vous définissez la valeur d'un en-tête de requête sortante sur une variable, celle-ci est résolue à sa valeur réelle lors de l'exécution. Les variables suivantes sont disponibles.

Paramètre	En-tête HTTP vers l'origine	Description	Exemple
Ali-Cdn-Real-Port	$http_Ali_Cdn_Real_Port	Ajoute le port réel du client à l'en-tête de requête vers l'origine afin de transmettre ces informations au serveur d'origine.	Ali-Cdn-Real-Port:80
Ali-Cdn-Real-Ip	$http_Ali_Cdn_Real_Ip	Ajoute l'adresse IP réelle du client à l'en-tête de requête vers l'origine afin de transmettre ces informations au serveur d'origine.	Ali-Cdn-Real-Ip:192.168.0.1
x_forwarded_for	$proxy_add_x_forwarded_for	Ajoute l'adresse IP du client et celles des serveurs proxy intermédiaires à l'en-tête X-Forwarded-For pour les transmettre au serveur d'origine.	X-Forwarded-For:192.168.0.1, 172.16.0.1

Procédure

Connectez-vous à la console DCDN.
Dans le volet de navigation de gauche, cliquez sur Domain Names.
Sur la page Domain Names, recherchez le nom de domaine à gérer et cliquez sur Configure dans la colonne Actions.
Dans le volet de navigation du domaine, cliquez sur Origin Fetch.
Cliquez sur l'onglet Modify Outgoing Request Header.
Dans l'onglet Modify Outgoing Request Header, cliquez sur Add.

Configurez les paramètres de modification de l'en-tête.

Important

Si plusieurs opérations contradictoires ciblent le même en-tête de requête vers l'origine, seule celle ayant la priorité la plus élevée est exécutée. L'ordre de priorité, du plus élevé au plus bas, est le suivant : Replace > Add > Change/Delete. Par exemple, si vous configurez à la fois une opération Add et une opération Delete pour le même en-tête, seule l'opération Add s'exécute.

Ajouter un en-tête de requête

Paramètre	Exemple	Description
Opération	Add	Ajoute l'en-tête spécifié aux requêtes HTTP vers l'origine.
En-tête de requête	En-tête personnalisé	Sélectionnez un en-tête de requête prédéfini ou choisissez Custom header.
Nom de l'en-tête de requête	x-code	Le nom de l'en-tête de requête personnalisé. Dans cet exemple, `x-code`.
Valeur de l'en-tête	key1	Spécifiez une ou plusieurs valeurs. Séparez les valeurs multiples par une virgule (,).
Valeur de l'en-tête	key1, key2
Autoriser les doublons	Yes	Yes : Autorise l'ajout d'en-têtes de requête en double. Par exemple, `x-code:key1` et `x-code:key2`. No : Si vous ajoutez un en-tête portant le même nom qu'un en-tête existant, la nouvelle valeur écrase l'ancienne. Par exemple, si vous ajoutez d'abord `x-code:key1` puis `x-code:key2`, l'en-tête final devient `x-code:key2`.

Supprimer un en-tête de requête

Paramètre	Exemple	Description
Opération	Delete	Supprime toutes les valeurs d'en-tête correspondant au nom d'en-tête spécifié, y compris les doublons éventuels.
En-tête de requête	En-tête personnalisé	Sélectionnez un en-tête de requête prédéfini ou choisissez Custom header.
Nom de l'en-tête de requête	x-code	Le nom de l'en-tête de requête personnalisé. Dans cet exemple, `x-code`.

Modifier un en-tête de requête

Paramètre	Exemple	Description
Opération	Change	Modifie la valeur d'un en-tête. Cette opération n'est pas autorisée si plusieurs en-têtes portent le même nom.
En-tête de requête	En-tête personnalisé	Sélectionnez un en-tête de requête prédéfini ou choisissez Custom header.
Nom de l'en-tête de requête	x-code	Le nom de l'en-tête de requête personnalisé. Dans cet exemple, `x-code`.
Remplacer par	key1, key3	Spécifiez une ou plusieurs valeurs. Séparez les valeurs multiples par une virgule (,).

Remplacer un en-tête de requête

Paramètre	Exemple	Description
Opération	Replace	Remplace une partie de la valeur d'un en-tête à l'aide d'une expression régulière. Cette opération n'est pas autorisée si plusieurs en-têtes portent le même nom.
En-tête de requête	En-tête personnalisé	Sélectionnez un en-tête de requête prédéfini ou choisissez Custom header.
Nom de l'en-tête de requête	x-code	Le nom de l'en-tête de requête personnalisé. Dans cet exemple, `x-code`.
Rechercher	key	Une expression régulière permettant de trouver la valeur à remplacer.
Remplacer par	abc	La chaîne destinée à remplacer le texte correspondant. Les références arrières d'expressions régulières sont prises en charge.
Correspondance	Match All	Match All : Remplace toutes les valeurs correspondantes. Par exemple, si vous remplacez « key » par « abc » dans `x-code:key1,key2,key3`, le résultat est `x-code:abc1,abc2,abc3`. Match the First Only : Remplace uniquement la première valeur correspondante. Par exemple, si vous remplacez « key » par « abc » dans `x-code:key1,key2,key3`, le résultat est `x-code:abc1,key2,key3`.

Cliquez sur OK.

API associée

BatchSetDcdnDomainConfigs