Configurer l’action du répondeur
Après avoir activé la fonction de répondeur, vous devez configurer une ou plusieurs actions pour le traitement des demandes. Le répondeur prend en charge les types d’actions suivants :
-
Répondez avec. Envoie la réponse définie par l’expression Target sans transférer la requête à un serveur Web. (L’appliance Citrix ADC remplace et agit en tant que serveur Web.) Utilisez ce type d’action pour définir manuellement une réponse HTML simple. Normalement, le texte d’une réponse avec action se compose d’un code d’erreur du serveur Web et une brève page HTML.
-
Répondez avec SQL OK. Envoie la réponse SQL OK désignée définie par l’expression Target. Utilisez ce type d’action pour envoyer une réponse SQL OK à une requête SQL.
-
Répondez avec une erreur SQL. Envoie la réponse d’erreur SQL désignée définie par l’expression Target. Utilisez ce type d’action pour envoyer une réponse d’erreur SQL à une requête SQL.
-
Répondre avec la page HTML. Envoie la page HTML désignée comme réponse. Vous pouvez choisir parmi une liste déroulante de pages HTML précédemment téléchargées ou charger une nouvelle page HTML. Utilisez ce type d’action pour envoyer une page HTML importée comme réponse. L’appliance répond avec un en-tête personnalisé dans l’action responsewithhtmlpage du répondeur. Vous pouvez configurer jusqu’à huit en-têtes personnalisés.
-
Redirection. Redirige la demande vers une page Web ou un autre serveur Web. Une action de redirection peut rediriger les requêtes envoyées à l’origine vers un site Web « fictice » existant dans DNS, mais pour lequel il n’y a pas de serveur web réel, vers un site Web réel. Il peut également rediriger les demandes de recherche vers une URL appropriée. Normalement, la cible de redirection d’une action de redirection consiste en une URL complète.
Pour configurer une action de répondeur à l’aide de la ligne de commande Citrix ADC :
Affiche les paramètres actuels de l’action du répondeur spécifiée. Si aucun nom d’action n’est fourni, affichez une liste de toutes les actions de répondeur actuellement configurées sur l’appliance Citrix ADC, avec des paramètres abrégés.
À l’invite de commandes, tapez les commandes suivantes pour configurer une action de répondeur et vérifier la configuration :
add responder action <name> <type> <target> [-bypassSafetyCheck (YES | NO) ]show responder action
Paramètres :
-
Nom. Nom de l’action du répondeur. Longueur maximale : 127
-
type. Type d’action du répondeur. Cela peut être : (respondwith).
-
cible. Expression spécifiant quoi répondre avec
-
htmlpage. Option spécifiant de répondre avec htmlpage
-
bypassSafetyCheck. Vérification de sécurité pour autoriser les expressions non sécurisées. Remarque : Cet attribut est obsolète.
-
hits. Nombre de fois où l’action a été entreprise.
-
referenceCount. Nombre de références à l’action.
-
undefHits. Le nombre de fois où l’action a abouti à UNDEF.
-
commentaire. Tout type d’information sur cette action du répondeur.
-
builtin. Indicateur pour déterminer si l’action du répondeur est intégrée ou non
Exemple :
To create a responder action that displays a “Not Found” error page for URLs that do not exist:
> add responder action act404Error respondWith '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done
> show responder action
1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done
To create a responder action that displays a “Not Found” error page for URLs that do not exist:
add responder action act404Error respondWith '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done
> show responder action
1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done
Pour modifier une action de répondeur existante à l’aide de la ligne de commande Citrix ADC :
À l’invite de commandes, tapez la commande suivante pour modifier une action de répondeur existante et vérifier la configuration :
set responder action <name> -target <string> [-bypassSafetyCheck ( YES | NO )]show responder action
Exemple :
set responder action act404Error -target '"HTTP/1.1 404 Not Found\r\n\r\n"+ HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."'
Done
> show responder action
1) Name: act404Error
Operation: respondwith
Target: "HTTP/1.1 404 Not Found" + HTTP.REQ.URL.HTTP_URL_SAFE + " does not exist on the web server."
BypassSafetyCheck : NO
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done
Pour supprimer une action de répondeur à l’aide de la ligne de commande Citrix ADC :
À l’invite de commandes, tapez la commande suivante pour supprimer une action de répondeur et vérifier la configuration :
rm responder action <name>show responder action
Exemple :
rm responder action act404Error
Done
> show responder action
Done
Pour ajouter des en-têtes personnalisés dans l’action du répondeur responsewithhtmlpage à l’aide de la ligne de commande Citrix ADC :
Une appliance Citrix ADC peut désormais répondre avec des en-têtes personnalisés dans l’action responsewithhtmlpage répondeur. Vous pouvez configurer jusqu’à huit en-têtes personnalisés. Auparavant, l’appliance ne répondait qu’avec des en-têtes statiques Content-type:text/html et Content-Length:<value>.
Remarque :
Dans la configuration d’en-tête personnalisée, vous pouvez également écraser la valeur d’en-tête « Content-Type ».
À l’invite de commandes, tapez la commande suivante :
add responder action <name> <type> (<target> | <htmlpage>) [-comment <string>] [-responseStatusCode <positive_integer>] [-reasonPhrase <expression>] [-headers <name(value)> ...]
Où,
de l’utilisateur. Nom de l’action du répondeur. Doit commencer par une lettre, un nombre ou le caractère de soulignement (_), et ne doit contenir que des lettres, des chiffres et le tiret (-), point (.) hachage (#), espace (), à (@), égal à (=), deux-points ( :) et caractères de soulignement. Peut être modifié après l’ajout de la stratégie de répondeur.
Type. Type d’action du répondeur. Les paramètres disponibles fonctionnent comme suit :
- respondwith
<target>- Répondez à la requête avec l’expression spécifiée comme cible. - respondwithhtmlpage - Répondez à la requête avec l’objet de page HTML téléchargé spécifié comme cible.
- redirect - Rediriger la requête vers l’URL spécifiée comme cible.
- sqlresponse_ok - Envoyer une réponse SQL OK.
- sqlresponse_error - Envoyer une réponse ERROR SQL. Il s’agit d’un argument obligatoire. Valeurs possibles : noop, respondwith, redirection, respondwithhtmlpage, sqlresponse_ok, sqlresponse_error
Target. Expression spécifiant quoi répondre. Généralement une URL pour les stratégies de redirection ou une expression de syntaxe par défaut. Outre les expressions de syntaxe par défaut Citrix ADC qui font référence aux informations contenues dans la demande, une expression stringbuilder peut contenir du texte et du code HTML, ainsi que des codes d’échappement simples qui définissent de nouvelles lignes et paragraphes. Placez chaque élément d’expression stringbuilder (soit une expression de syntaxe par défaut Citrix ADC, soit une chaîne) entre guillemets doubles. Utilisez le caractère plus (+) pour joindre les éléments.
htmlpage. Pour les stratégies respondwithhtmlpage, nom de l’objet de page HTML à utiliser comme réponse. Vous devez d’abord importer l’objet page. Longueur maximale : 31
Commentaire. Tout type d’information sur cette action du répondeur. Longueur maximale : 255
responseStatusCode. Code d’état de réponse HTTP, par exemple 200, 302, 404, etc. La valeur par défaut du type d’action de redirection est 302 et pour respondwithhtmlpage 200 Valeur minimale : 100 Valeur maximale : 599
reasonPhrase. Expression spécifiant la phrase de motif de la réponse HTTP. La phrase de raison peut être une chaîne littérale avec des guillemets ou une expression PI. Par exemple : « URL non valide :” + HTTP.REQ.URL Longueur maximale : 8191
Headers. Un ou plusieurs en-têtes à insérer dans la réponse HTTP. Chaque en-tête est spécifié comme « name (expr) », où expr est une expression évaluée au moment de l’exécution pour fournir la valeur de l’en-tête nommé. Vous pouvez configurer un maximum de huit en-têtes pour une action de répondeur.
Pour configurer une action de répondeur à l’aide de l’interface graphique :
- Accédez à AppExpert > Répondeur > Actions.
- Dans le volet d’informations, effectuez l’une des opérations suivantes :
- Pour créer une action, cliquez sur Ajouter.
- Pour modifier une action existante, sélectionnez-la, puis cliquez sur Ouvrir.
- Cliquez sur Créer ou OK, selon que vous créez une action ou modifiez une action existante.
- Cliquez sur Fermer. Un message apparaît dans la barre d’état indiquant que la fonction a été activée.
- Pour supprimer une action de répondeur, sélectionnez-la, puis cliquez sur Supprimer. Un message apparaît dans la barre d’état indiquant que la fonctionnalité a été désactivée.
Pour ajouter une expression à l’aide de la boîte de dialogue Ajouter une expression
-
Dans la boîte de dialogue Créer une action du répondeur ou Configurer une action du répondeur, cliquez sur Ajouter.
- Dans la boîte de dialogue Ajouter une expression, dans la première zone de liste, choisissez le premier terme de votre expression.
- HTTP. Le protocole HTTP. Choisissez cette option si vous souhaitez examiner un aspect de la demande qui concerne le protocole HTTP.
- SYS. Un ou plusieurs sites Web protégés. Choisissez cette option si vous souhaitez examiner un aspect de la demande qui concerne le destinataire de la demande.
- CLIENT. Ordinateur qui a envoyé la demande. Choisissez cette option si vous souhaitez examiner un aspect de l’expéditeur de la demande.
- ANALYTICS. Données analytiques associées à la demande. Choisissez cette option si vous souhaitez examiner les métadonnées de demande.
- SIP. Une demande SIP. Choisissez cette option si vous souhaitez examiner un aspect d’une demande SIP. Lorsque vous faites votre choix, la zone de liste la plus à droite répertorie les termes appropriés pour la partie suivante de votre expression.
- Dans la deuxième zone de liste, choisissez le deuxième terme pour votre expression. Les choix dépendent du choix que vous avez fait à l’étape précédente et sont adaptés au contexte. Après avoir fait votre deuxième choix, la fenêtre d’aide située sous la fenêtre Construire une expression (qui était vide) affiche de l’aide décrivant le but et l’utilisation du terme que vous venez de choisir.
- Continuez à choisir des termes dans les zones de liste qui apparaissent à droite de la zone de liste précédente, ou à taper des chaînes ou des nombres dans les zones de texte qui s’affichent pour vous inviter à entrer une valeur, jusqu’à ce que votre expression soit terminée.
Configuration de l’action HTTP globale
Vous pouvez configurer l’action HTTP globale pour appeler une action de répondeur lorsqu’une requête HTTP expire. Pour configurer cette fonctionnalité, vous devez d’abord créer l’action de répondeur que vous souhaitez appeler. Ensuite, vous configurez l’action de délai d’attente HTTP global pour répondre à un délai d’attente avec cette action de répondeur.
Pour configurer l’action HTTP globale à l’aide de la ligne de commande Citrix ADC :
À l’invite de commandes, tapez la commande suivante :
set ns httpProfile -reqTimeoutAction <responder action name>save ns config
Pour,<responder action name> remplacez le nom de l’action du répondeur.
Configurer l’importation de pages HTML
Lorsqu’une appliance Citrix ADC répond avec un message personnalisé, nous pouvons répondre avec un fichier HTML. Vous pouvez importer le fichier à l’aide de la import responder htmlpage commande, puis utiliser ce fichier dans la add responder action <act name> respondwithhtmlpage <file name> commande. Vous pouvez également importer le fichier via l’interface graphique Citrix ADC. Vous pouvez importer une page HTML souhaitée dans le dossier de l’appliance et la charger pendant l’exécution du répondeur.
Importer la page HTML à l’aide de la CLI
À l’invite de commandes, tapez :
import responder htmlpage [<src>] <name> [-comment <string>] [-overwrite][-CAcertFile <string>]
Exemple :
import responder htmlpage http://www.example.com/page.html my-responder-page -CAcertFile my_root_ca_cert
Où, certificat de l’autorité de certification est utilisé pour vérifier le certificat client. Le certificat doit être importé en utilisant la commande CLI « import ssl certfile » ou l’équivalent via API ou GUI. Si le nom du certificat n’est pas configuré, les certificats d’autorité de certification racine par défaut sont utilisés pour la vérification du certificat.
Importer la page HTML à l’aide de l’interface graphique Citrix ADC
- Accédez à AppExpert > Répondeur > Importations de page HTML.
- Dans le volet de détails Importations HTML du répondeur, cliquez sur Ajouter.
-
Dans la page Importer un objet de page HTML, définissez les paramètres suivants :
- Nom. Nom de la page HTML.
- Importer à partir de. Importé à partir d’un fichier, du texte ou du texte.
- URL. Sélectionnez cette option pour entrer l’emplacement URL du fichier HTML.
- Dossier. Sélectionnez le fichier HTML dans le répertoire de l’appliance.
- Texte. Sélectionnez le fichier HTML sous la forme d’un texte.
- Cliquez sur Continuer.
- Vérifiez les détails de la page HTML du répondeur.
-
Cliquez sur Terminé.
Pour modifier une page HTML, vous pouvez sélectionner un fichier et cliquer sur Modifier le fichier de page HTML du répondeur dans la liste déroulante Sélectionner une action.
