ADC

Configurer une action du répondeur

Après avoir activé la fonction de répondeur, vous devez configurer une ou plusieurs actions de 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 demande à un serveur Web. (L’appliance NetScaler remplace un serveur Web et fait office de serveur Web.) Utilisez ce type d’action pour définir manuellement une réponse HTML simple. Normalement, le texte d’une action Répondre avec consiste en un code d’erreur de 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épondez avec une page HTML. Envoie la page HTML désignée en tant que réponse. Vous pouvez choisir dans une liste déroulante de pages HTML précédemment chargées ou charger une nouvelle page HTML. Utilisez ce type d’action pour envoyer une page HTML importée en tant que réponse. L’appliance répond avec un en-tête personnalisé dans l’action Responder responsewithhtmlpage. Vous pouvez configurer jusqu’à huit en-têtes personnalisés. La page HTML importée est stockée dans le répertoire /var/download/responder.

  • Redirection. Redirige la demande vers une autre page Web ou un autre serveur Web. Une action de redirection peut rediriger les demandes initialement envoyées vers un site Web « fictif » qui existe dans le DNS, mais pour lequel il n’existe 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.

Configurez une action de répondeur à l’aide de l’interface de ligne de commande :

Affiche les paramètres actuels de l’action de répondeur spécifiée. Si aucun nom d’action n’est fourni, affichez la liste de toutes les actions du répondeur actuellement configurées sur l’appliance NetScaler, 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>
  • show responder action

Paramètres :

  • Nom. Nom de l’action du répondeur. Longueur maximale : 127

  • type. Type d’action du répondeur. Il peut s’agir de : (répondez avec).

  • target. Expression indiquant par quoi répondre.

  • htmlpage. Option spécifiant de répondre par une page HTML.

  • hits. Le nombre de fois où l’action a été effectuée.

  • referenceCount. Nombre de références à l’action.

  • undefHits. Le nombre de fois où l’action a abouti dans UNDEF.

  • comment. Tout type d’informations concernant cette action de répondeur.

  • builtin. Indicateur permettant de déterminer si l’action du répondeur est intégrée ou non.

Exemple :


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."
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done

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."
Hits: 0
Undef Hits: 0
Action Reference Count: 0
Done

<!--NeedCopy-->

Modifiez une action de répondeur existante à l’aide de l’interface de ligne de commande :

À 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>
  • 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."
        Hits: 0
        Undef Hits: 0
        Action Reference Count: 0
 Done

<!--NeedCopy-->

Supprimez une action de répondeur à l’aide de l’interface de ligne de commande :

À 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

<!--NeedCopy-->

Ajoutez des en-têtes personnalisés dans l’action responsewithhtmlpage responder à l’aide de la CLI :

Une appliance NetScaler peut désormais répondre avec des en-têtes personnalisés dans l’action du répondeur responsewithhtmlpage. Vous pouvez configurer jusqu’à huit en-têtes personnalisés. Auparavant, l’appliance répondait uniquement 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 de l’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ù,

name : nom de l’action du répondeur. Doit commencer par une lettre, un chiffre ou le caractère de soulignement (_) et ne doit contenir que des lettres, des chiffres et le trait d’union (-), le point (.), le hachage (#), l’espace (), à (@), égal (=), deux-points (:) et les 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 :

  1. respondwith <target> - Répondez à la demande avec l’expression spécifiée comme cible.
  2. respondwithhtmlpage - Répondez à la demande en utilisant l’objet de page HTML chargé spécifié comme cible.
  3. redirect - Redirige la demande vers l’URL spécifiée comme cible.
  4. sqlresponse_ok - Envoie une réponse SQL OK
  5. sqlresponse_error - Envoie une réponse d’erreur SQL. Il s’agit d’un argument obligatoire. Valeurs possibles : noop, respondwith, redirect, respondwithhtmlpage, sqlresponse_ok, sqlresponse_error

Cible : expression indiquant par quoi répondre. En général, une URL pour les stratégies de redirection ou une expression de syntaxe par défaut. Outre les expressions de syntaxe par défaut de NetScaler qui font référence aux informations contenues dans la demande, une expression de générateur de chaînes peut contenir du texte et du code HTML, ainsi que de simples codes d’échappement qui définissent de nouvelles lignes et de nouveaux paragraphes. Placez chaque élément d’expression du générateur de chaînes (une expression de syntaxe par défaut NetScaler ou une chaîne) entre guillemets doubles. Utilisez le signe 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 de page. Longueur maximale : 31

Commentaire : tout type d’information concernant 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 redirect action est 302 et pour respondwithhtmlpage est 200 Valeur minimale : 100 Valeur maximale : 599

ReasonPhrase : expression spécifiant la phrase de raison de la réponse HTTP. La phrase de raison peut être un littéral de chaîne avec des guillemets ou une expression PI. Pa exemple : "Invalid URL: " + HTTP.REQ.URL Maximum Length: 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)," ou 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.

Configurez 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.

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 de répondeur ou Configurer une action de 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 certains aspects de la demande qui se rapportent au protocole HTTP.
    • SYS. Un ou plusieurs sites Web protégés. Sélectionnez cette option si vous souhaitez examiner certains aspects de la demande qui concernent le destinataire de la demande.
    • CLIENT. L’ordinateur qui a envoyé la demande. Choisissez cette option si vous souhaitez examiner certains aspects de l’expéditeur de la demande.
    • ANALYTICS. Les données analytiques associées à la demande. Sélectionnez cette option si vous souhaitez examiner les métadonnées de la demande.
    • SIP. Une demande SIP. Choisissez cette option si vous souhaitez examiner certains aspects 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 de votre expression. Les choix dépendent du choix que vous avez effectué à l’étape précédente et sont adaptés au contexte. Une fois que vous avez 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 qu’elle invoque une action de répondeur lorsqu’une requête HTTP arrive à son heure d’attente. Pour configurer cette fonctionnalité, vous devez d’abord créer l’action de répondeur que vous souhaitez appeler. Configurez ensuite l’action de temporisation HTTP globale pour répondre à un délai d’expiration avec cette action de répondeur.

Configurez l’action HTTP globale à l’aide de l’interface de ligne de commande :

À 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 d’une page HTML

Lorsqu’une appliance NetScaler répond par un message personnalisé, nous pouvons répondre par un fichier HTML. Vous pouvez importer le fichier à l’aide de la commande import responder htmlpage, puis utiliser ce fichier dans la commande add responder action <act name> respondwithhtmlpage <file name>. Vous pouvez également importer le fichier via l’interface graphique de NetScaler. Vous pouvez importer la page HTML souhaitée dans le dossier de l’appliance et la télécharger pendant l’exécution du répondeur.

Importer une page HTML à l’aide de l’interface de ligne de commande

À 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ù, un certificat CA est utilisé pour vérifier le certificat client. Le certificat doit être importé à l’aide de la commande CLI import ssl certfile ou d’une commande équivalente via une API ou une interface graphique. Si aucun nom de certificat n’est configuré, les certificats CA racine par défaut sont utilisés pour la vérification du certificat.

Importer une page HTML depuis le système de fichiers local

Vous pouvez également importer une page HTML depuis le système de fichiers local. Pour importer, copiez le fichier à l’aide de SCP ou de toute autre manière dans le répertoire /var/tmp/, puis importez-le à l’aide du mot clé « local : ». Par exemple :

import responder htmlpage local:my_local_file.html my_local_file

my_local_file.html se trouve dans le répertoire « /var/tmp/ ».

Remarque

 : le mot clé « local : » recherche uniquement le fichier dans le répertoire « /var/tmp/ ». Pour les partitions autres que celles par défaut, vous devez copier le fichier dans le répertoire tmp spécifique à la partition qui se trouve dans /var/partitions/<partition name>/tmp.

Importer une page HTML à l’aide de l’interface graphique

  1. Accédez à AppExpert > Répondeur > Importations de pages HTML.
  2. Dans le volet de détails Importations HTML du répondeur, cliquez sur Ajouter.
  3. Dans la page Objet d’importation de page HTML, définissez les paramètres suivants :

    1. Nom. Nom de la page HTML.
    2. Importer depuis. Importé à partir d’un fichier, d’un texte ou d’un texte.
    3. URL. Sélectionnez cette option pour entrer l’emplacement URL du fichier HTML.
    4. Dossier. Sélectionnez le fichier HTML dans le répertoire de l’appliance.
    5. Texte. Sélectionnez le fichier HTML sous forme de texte.
  4. Cliquez sur Continuer.
  5. Vérifiez les détails de la page HTML du répondeur.
  6. Cliquez sur Terminé.

    Importation de pages HTML

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 .

Modifier le fichier de page HTML du répondeur

Configurer une action du répondeur