Paramètres d'action de réécriture
Vous pouvez définir des paramètres afin d'implémenter une action de réécriture pour les demandes sortantes traitées par le serveur proxy. Les actions de réécriture définissent la manière dont le serveur récrit les éléments de l'adresse (uniform resource locator), tels que les URL dans une page HTML ou un lien de redirection dans la réponse. Les actions de réécriture servent souvent à masquer l'identité d'un serveur d'arrière-plan avec celle du serveur proxy.
Pour afficher cette page de la console d'administration, cliquez sur
.Nom de l'action
Spécifie un nom symbolique défini par l'utilisateur pour une action de réécriture.
Un nom d'action de réécriture doit être unique et ne peut pas contenir de caractère non valide. Les caractères suivants ne sont en revanche pas autorisés dans cette zone : # \ / , : ; " * ? < > | = + & % '.
Type d'action de réécriture
Indique le type d'action de réécriture à effectuer. Vous pouvez spécifier les types d'action de réécriture suivants : Réponse URL absolue, Rediriger un en-tête d'emplacement, Rediriger un code d'état, Réponse URL relative, Set-Cookie.
Type d'action | Description |
---|---|
Réponse URL absolue | Récrit l'identificateur URI absolu dans
l'attribut de marque de la réponse HTTP. Le serveur proxy analyse la réponse à la recherche d'un attribut correspondant à l'option A partir du masque. Si une correspondance A partir du masque apparaît, le serveur proxy récrit
la réponse en fonction de Vers le masque. Par exemple :
La balise <img src="http://someserver/1.jpg" /> est remplacé par <img src="http://someserver/prefix/1.jpg" />. |
Rediriger un en-tête d'emplacement | Récrit l'identificateur URI dans l'en-tête de délocalisation de la réponse HTTP. Par exemple :
L'en-tête d'emplacement "Location: http://www.ibm.com"
est remplacé par "Location: https://www.ibm.com".
|
Rediriger un code d'état | Indique le code d'état de redirection dans la première ligne d'un message de réponse, comme par exemple 301 ou 302. |
Réponse URL relative | Récrit une URL relative dans les attributs de marque d'une réponse. Le serveur proxy analyse la réponse à la recherche d'un attribut correspondant à l'option A partir du masque. En cas de correspondance avec l'option A partir du masque, le proxy récrit la réponse en fonction
de l'option vers le masque. Par exemple :
La balise <img src="myimages/1.jpg" /> est remplacée par <img src="prefix/myimages/1.jpg" />. |
Réponse URL relative : passive | Au lieu de récrire la réponse directement, le serveur proxy injecte un cookie dans l'en-tête de la réponse. Par exemple : si une requête pour "/myimages/1.jpg" est renvoyée du navigateur avec un cookie, le serveur proxy recrée une requête URI comme "/prefix/myimages/1.jpg". Cette fonction nécessite un navigateur prenant en charge les cookies. Une seule règle passive peut être définie par session. |
Domaine_Set-Cookie | Récrit l'attribut de domaine de l'en-tête set-cookie. Par exemple :
En-tête set-cookie : "Set-Cookie: JSESSIONID: abcdefg; domain="www.ibm.com"" est modifié en "Set-Cookie: JSESSIONID: abcdefg; domain="www.ibm.com.cn"" |
Chemin_Set-Cookie | Récrit l'attribut de chemin de l'en-tête set-cookie. Par exemple :
L'en-tête de définition de cookie "Set-Cookie:
JSESSIONID: abcdefg; domain="www.ibm.com"; path="/"" est remplacé par
"Set-Cookie: JSESSIONID: abcdefg; domain="www.ibm.com";
path="/prefix/"". |
A partir du masque
Indique le masque de l'URL original dans la réponse issue du serveur cible. Le masque peut comporter les caractères génériques suivants : *. Un masque d'URL peut comporter un ou plusieurs astérisques (*).
Vers le masque
Spécifie le masque résultant de la réécriture. Le masque peut comporter les caractères génériques suivants : *. Un masque d'URL peut comporter un ou plusieurs astérisques (*).
Activer une réécriture passive
Indique si la réécriture de l'URI est mise en différé ou non jusqu'à l'envoi par le client de la requête suivante pour cet URI. L'activation de la réécriture passive empêche le serveur proxy de récrire tous les liens dans la réponse avant le renvoi de la réponse au client.
Nom du cookie
Indique le cookie pour lequel les attributs de chemin ou de domaine sont récrits. Ce paramètre est valide uniquement lorsque l'action est de type chemin Set-cookie ou domaine set-cookie.
Limiter un masque URL
Indique de rechercher une URL de demande à récrire dans le message de réponse. La limitation du masque URL empêche le serveur proxy de récrire tous les masques URL dans le message de réponse d'une page déterminée, ce qui permet au serveur proxy d'ignorer l'analyse syntaxique des réponses des autres pages, s'il existe plusieurs pages. Ce paramètre est valide uniquement pour les actions de type Réponse URL absolue ou Réponse URL relative.
Limiter un domaine de cookie
Spécifie une contrainte de limite de réécriture du domaine de cookie à un ensemble de domaines spécifiés. Si aucun domaine n'est spécifié, tous les domaines sont récrits. Cette zone est uniquement valide lorsque l'action spécifiée est Définir le domaine du cookie.
Limiter un chemin de cookie
Spécifie une contrainte limitant la réécriture du chemin de cookie aux chemins spécifiés. Si aucun chemin n'est spécifié, tous les chemins sont récrits. Cette zone est uniquement valide lorsque l'action spécifiée est Définir le chemin du cookie.