ADC

Configurer un sélecteur

Un sélecteur est un filtre permettant d’identifier les demandes. Il comprend jusqu’à cinq expressions de syntaxe par défaut individuelles qui identifient les attributs de la demande tels que l’adresse IP du client et l’URL de la demande. Chaque expression est une expression syntaxique par défaut non composée et est considérée comme étant en relation ET avec les autres expressions. Voici quelques exemples d’expressions de sélection :

  • HTTP.REQ.URL
  • CLIENT.IP.SRC
  • HTTP.RES.BODY(1000).AFTER_STR("<string>").BEFORE_STR("<string>")"
  • CLIENT.IP.SRC.SUBNET(24)

Les sélecteurs sont utilisés dans les configurations de limitation de débit et d’analyse des actions. Un sélecteur est facultatif dans une configuration de limitation de débit, mais il est requis dans une configuration d’analyse des actions.

L’ordre dans lequel vous spécifiez les paramètres est significatif. Par exemple, si vous configurez une adresse IP et un domaine (dans cet ordre) dans un sélecteur, puis que vous spécifiez le domaine et l’adresse IP (dans l’ordre inverse) dans un autre sélecteur, Citrix ADC considère ces valeurs comme uniques. Cela peut entraîner le comptage deux fois de la même transaction. De plus, si plusieurs stratégies invoquent le même sélecteur, Citrix ADC peut, là encore, compter la même transaction plusieurs fois.

Si vous modifiez une expression dans un sélecteur, une erreur peut s’afficher si une stratégie qui l’appelle est liée à une nouvelle étiquette de stratégie ou à un nouveau point de liaison. Par exemple, supposons que vous créiez un sélecteur nommé MyLimitSelector1, que vous l’appeliez à partir de MyLimitID1 et que vous invoquez l’identificateur à partir d’une stratégie DNS nommée DNSRateLimit1. Si vous modifiez l’expression dans MyLimitSelector1, vous risquez de recevoir une erreur lors de la liaison de DNSRateLimit1 à un nouveau point de liaison. La solution de contournement consiste à modifier ces expressions avant de créer les stratégies qui les invoquent.

L’appliance Citrix ADC fournit des sélecteurs intégrés pour certains des cas d’utilisation les plus courants.

Vous pouvez également configurer un sélecteur avec des expressions qui identifient les attributs de demande de votre choix. Par exemple, vous pouvez créer un enregistrement pour une demande qui arrive avec un en-tête spécifique. Pour évaluer l’en-tête, vous pouvez l’ HTTP.REQ.HEADER("<header_name>") ajouter au sélecteur que vous souhaitez utiliser.

Pour configurer un sélecteur à l’aide de l’interface de ligne de commande :

À l’invite de commandes, tapez les commandes suivantes pour configurer un sélecteur et vérifier la configuration :

  • add stream selector <name> <rule> ...
  • show stream selector

Exemple

> add stream selector myselector HTTP.REQ.URL CLIENT.IP.SRC
 Done
> show stream selector myselector
    Name: myselector
    Expressions:
        1) HTTP.REQ.URL
        2) CLIENT.IP.SRC
 Done
>
<!--NeedCopy-->

Pour modifier ou supprimer un sélecteur à l’aide de l’interface de ligne de commande :

  • Pour modifier un sélecteur, tapez la commande set stream selector, le nom du sélecteur et le paramètre de règle avec les expressions. Saisissez les expressions existantes que vous souhaitez conserver, ainsi que les nouvelles expressions que vous souhaitez ajouter.
  • Pour supprimer un sélecteur, tapez la commande rm stream selector et le nom du sélecteur.

Pour configurer un sélecteur à l’aide de l’interface graphique :

  1. Accédez à AppExpert > Action Analytics > Selectors.
  2. Dans le volet d’informations, effectuez l’une des opérations suivantes :
    • Pour créer un sélecteur, cliquez sur Ajouter.
    • Pour modifier un sélecteur, sélectionnez-le, puis cliquez sur Modifier.
  3. Dans la page Créer un sélecteur ou Configurer le sélecteur, définissez les paramètres suivants :
    • Nom. Pour ajouter un nom au sélecteur, saisissez-le dans le champ Nom . Le nom doit commencer par un caractère ASCII, alphanumérique ou un trait de soulignement. Le nom doit contenir uniquement des caractères alphanumériques ASCII, soulignement, hachage, point, espace, deux-points, at, égal et trait d’union.
    • Expressions. Pour ajouter l’expression à la configuration du sélecteur, cliquez sur Insérer. Pour supprimer une expression de la configuration du sélecteur, dans la zone Expression, sélectionnez l’expression, puis cliquez sur Supprimer. Remarque : Dans la zone Expressions, saisissez un paramètre valide. Par exemple, saisissez HTTP. Ensuite, saisissez une période après ce paramètre. Un menu déroulant apparaît. Le contenu de ce menu fournit les mots-clés qui peuvent suivre le mot-clé initial que vous avez saisi. Pour sélectionner le mot-clé suivant dans ce préfixe d’expression, double-cliquez sur la sélection dans le menu déroulant. La zone de texte Expressions affiche les premier et deuxième mots-clés du préfixe d’expression, par exemple HTTP.REQ. Continuez à ajouter des composants d’expression jusqu’à ce que l’expression complète soit formée.
  4. Cliquez sur Insérer.
  5. Continuez à ajouter jusqu’à cinq expressions non composées.
  6. Cliquez sur Créer, puis sur Fermer.
Configurer un sélecteur