Modifier les en-têtes de réponse du serveur d'origine - Edge Security Acceleration

Fonctionnement des en-têtes de réponse du serveur d'origine vers ESA

Cette fonctionnalité modifie les en-têtes de réponse spécifiés depuis l'origine selon des règles prédéfinies. Les modifications prennent effet avant que le serveur ESA ne traite l'objet. Si le contenu de la réponse est susceptible d'être mis en cache, les en-têtes modifiés sont stockés dans le cache avec la réponse.

Ce comportement diffère de la modification des en-têtes de réponse d'ESA vers le client. Lorsque vous modifiez les en-têtes ESA vers le client, les changements s'appliquent après qu'ESA a traité la réponse complète provenant du serveur d'origine ou du cache, et la réponse est immédiatement envoyée au client.

Modifier les en-têtes de réponse du serveur d'origine vers ESA

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.
Sélectionnez l'onglet Response Header, cliquez sur l'élément Origin to ESA, puis sur Add. Configurez ensuite les conditions de correspondance dans la section Match Conditions. Pour plus d'informations, consultez la rubrique Composants d'une expression de règle.

Dans la section Modify Response Headers, sélectionnez une action, saisissez un nom d'en-tête et une valeur d'en-tête, puis cliquez sur Submit.

Le tableau suivant décrit les actions et modes disponibles. Le paramètre Mode détermine comment la valeur de l'en-tête est spécifiée : Static utilise une valeur fixe que vous saisissez, tandis que Dynamic évalue une expression de règle à l'exécution.

Action

Mode

Description

Example

Add

Static

Ajoute l'en-tête de réponse spécifié à la réponse du serveur d'origine. Si un en-tête portant le même nom existe déjà, le nouvel en-tête l'écrase.

Pour ajouter un en-tête de réponse nommé x-code avec la valeur key1, définissez Header Name sur x-code et Header Value sur key1.

Add

Dynamic

La valeur de l'en-tête de réponse peut être une expression de règle.

Pour ajouter un en-tête de réponse nommé Client-Ip-Geo-Location avec la valeur dynamique ip.geoip.country qui enregistre le pays ou la région de l'adresse IP du client, définissez Header Name sur Client-Ip-Geo-Location et Header Value sur ip.geoip.country.

Modify

Static

Modifie la valeur d'un en-tête de réponse spécifié dans la réponse du serveur d'origine.

Pour changer la valeur de l'en-tête de réponse x-code en key2, définissez Header Name sur x-code et Header Value sur key2.

Modify

Dynamic

La valeur de l'en-tête de réponse peut être une expression de règle.

Pour changer la valeur de l'en-tête de réponse Client-Ip-Geo-Location en la valeur dynamique ip.geoip.country, définissez Header Name sur Client-Ip-Geo-Location et Header Value sur ip.geoip.country.

Delete

—

Supprime toutes les occurrences de l'en-tête correspondant au nom d'en-tête spécifié de la réponse du serveur d'origine. L'opération de suppression est identique pour les modes statique et dynamique.

Pour supprimer l'en-tête de réponse x-code, définissez Header Name sur x-code.

Remarque

Vous ne pouvez pas configurer un nom d'en-tête commençant par ali-swift, ali-esa-inner, x-swift ou x-site (la casse n'est pas prise en compte).
Vous pouvez spécifier plusieurs valeurs dans le champ Header Value. Séparez les valeurs par une virgule (,).
L'action Modify modifie un en-tête de réponse existant et prend effet uniquement si un en-tête portant le nom spécifié existe dans la réponse d'origine.

Paramètres des en-têtes de réponse

Parameter

Description

Example

Custom

Vous pouvez ajouter des en-têtes de réponse personnalisés. Un nom d'en-tête personnalisé doit répondre aux exigences suivantes : il est composé de lettres majuscules, de lettres minuscules, de chiffres et de traits d'union (-), et sa longueur est comprise entre 1 et 100 caractères.

Test-Header

Access-Control-Allow-Credentials

Indique si la réponse peut être exposée à la page. Valeurs : true (la réponse peut être exposée), toute autre valeur (la réponse ne peut pas être exposée).

true

Access-Control-Allow-Headers

Spécifie les en-têtes autorisés pour les requêtes cross-origin.

X-Custom-Header

Access-Control-Allow-Methods

Spécifie les méthodes autorisées pour les requêtes cross-origin. Séparez plusieurs méthodes par une virgule (,).

POST,GET

Access-Control-Allow-Origin

Spécifie quelles origines peuvent accéder à la ressource. Fait partie du mécanisme CORS (Cross-Origin Resource Sharing). Valeurs prises en charge : le caractère générique (*) permet l'accès depuis n'importe quelle origine — adapté aux ressources publiques, à utiliser avec prudence en production en raison des risques CSRF ; une origine unique telle que http://example.com — seules les requêtes provenant de cette origine sont autorisées.

*, http://www.aliyun.com

Access-Control-Expose-Headers

Spécifie les en-têtes auxquels les scripts côté client sont autorisés à accéder.

Content-Length

Access-Control-Max-Age

Spécifie la durée pendant laquelle les résultats d'une requête preflight peuvent être mis en cache, en secondes.

600

Cache-Control

Spécifie les directives de mise en cache pour les requêtes et les réponses.

no-cache

Content-Disposition

Suggère un nom de fichier par défaut si le client enregistre le contenu de la réponse sous forme de fichier.

examplefile.txt

Content-Type

Indique le type de média du contenu de la réponse.

text/plain

Pragma

En-tête HTTP/1.0 utilisé dans les réponses du serveur pour définir le comportement de mise en cache pour les clients.

no-cache

Exemple de configuration d'expression dynamique

L'exemple suivant montre comment utiliser la fonction regex_replace avec le champ http.response.headers pour remplacer des caractères spéciaux dans la valeur d'un en-tête de réponse provenant du serveur d'origine.

Scénario : Remplacer le symbole # par - dans la valeur de l'en-tête HTTP example dans la réponse du serveur d'origine vers le nœud ESA.

Configuration

Dans la section Modify Response Headers, configurez les paramètres suivants :

Parameter

Value

Rules

Dynamic

Transform Rules

Modify

Type

example

Operation

regex_replace(regex_replace(regex_replace(http.response.headers["example"], "#", "-"), "#", "-"), "#", "-")

Résultat

Value

En-tête de réponse d'origine

example:cat#dog#duck#sheep

En-tête modifié

example:cat-dog-duck-sheep

Documentation connexe

Les fonctionnalités liées aux règles varient en termes de priorité effective, de réentrance et de granularité effective. Pour plus de détails, consultez la rubrique Caractéristiques des fonctionnalités basées sur des règles.