Configuration d’une action de 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 serveur Web différent. Une action de redirection peut rediriger les demandes envoyées à l’origine vers un site Web « fictif » 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, affiche une liste de toutes les actions du 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).

  • target. 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.

  • comment. 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 répondait uniquement avec les en-têtes statiques « Content-Type:Text/HTMLContent-Length:<value> » et « ».

Remarque Dans la configuration d’en-tête personnalisée, vous pouvez également remplacer 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 d’action du répondeur. Les paramètres disponibles fonctionnent comme suit :

  1. respondwith<target> - Répondez à la requête avec l’expression spécifiée comme cible.
  2. respondwithhtmlpage - Répondez à la requête avec l’objet de page HTML téléchargé spécifié comme cible.
  3. redirect - Rediriger la requête vers l’URL spécifiée comme cible.
  4. sqlresponse_ok - Envoyer une réponse SQL OK.
  5. sqlresponse_error - Envoyer une réponse ERROR SQL. C’est un argument obligatoire. Valeurs possibles : noop, respondwith, redirection, respondwithhtmlpage, sqlresponse_ok, sqlresponse_error

cible. 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. En plus des expressions de syntaxe par défaut Citrix ADC qui font référence aux informations de la requête, une expression stringbuilder peut contenir du texte et du 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 ou 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 pour le type d’action de redirection est 302 et pour respondwithhtmlpage est 200 Valeur minimale : 100 Valeur maximale : 599

Phrase de raisonnement. 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

en-têtes. 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 qui est évaluée lors 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 :

  1. Accédez à AppExpert > Répondeur > Actions.
  2. 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.
  3. Cliquez sur Créer ou sur OK, selon que vous créez une action ou modifiez une action existante.
  4. Cliquez sur Fermer. Un message apparaît dans la barre d’état indiquant que la fonction a été activée.
  5. 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

  1. Dans la boîte de dialogue Créer une action du répondeur ou Configurer une action du répondeur, cliquez sur Ajouter.

  2. 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. Le(s) site(s) 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.
  3. 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.
  4. 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.

Configuration d’une action de répondeur