ADC

Configuration d’un ensemble de modèles

Pour configurer un ensemble de modèles, vous devez spécifier les chaînes qui doivent servir de modèles. Vous pouvez attribuer manuellement une valeur d’indice unique à chacun de ces modèles ou autoriser l’attribution automatique des valeurs d’indice.

Remarque :

Les ensembles de modèles font la distinction entre majuscules et minuscules (sauf si vous spécifiez l’expression à ignorer). Par conséquent, le modèle de chaîne « product1 », par exemple, n’est pas le même que le modèle de chaîne « Product1 ».

Points à retenir sur les valeurs d’index :

  • Vous ne pouvez pas lier la même valeur d’indice à plusieurs modèles.
  • Une valeur d’indice attribuée automatiquement est supérieure d’un chiffre à la valeur d’indice la plus élevée des modèles existants dans l’ensemble de modèles. Par exemple, si la valeur d’indice la plus élevée des modèles existants dans un ensemble de modèles est 104, la prochaine valeur d’indice automatiquement attribuée est 105.
  • Si vous ne spécifiez pas d’indice pour le premier modèle, la valeur d’indice 1 est automatiquement attribuée à ce modèle.
  • Les valeurs d’index ne sont pas régénérées automatiquement si un ou plusieurs modèles sont supprimés ou modifiés. Par exemple, si l’ensemble contient cinq modèles, avec des index compris entre 1 et 5, et si le modèle avec un indice de 3 est supprimé, les autres valeurs d’index du jeu de modèles ne sont pas automatiquement régénérées pour produire des valeurs de 1 à 4.
  • La valeur d’indice maximale qui peut être attribuée à un modèle est 4294967290. Si cette valeur est déjà affectée à un modèle de l’ensemble, vous devez attribuer manuellement des valeurs d’index à tous les modèles nouvellement ajoutés. Une valeur d’indice inutilisée inférieure à une valeur actuellement utilisée ne peut pas être attribuée automatiquement.

À partir de la version 14.1-12.x de NetScaler, en plus d’utiliser une chaîne statique, vous pouvez également utiliser une expression pour dériver le nom du jeu de modèles et associer le jeu de modèles à des méthodes d’expression de stratégie telles que CONTAINS_ANY, EQUALS_ANY, STARTSWITH_ANY. Le nom du jeu de modèles est dérivé dynamiquement de l’expression et réduit donc le nombre de stratégies qui doivent être créées pour plusieurs ensembles de modèles. En créant un ensemble de modèles dynamiques, vous pouvez éviter les configurations répétitives.

Par exemple, dans les versions antérieures à NetScaler 14.1-12.x, s’il existe quatre ensembles de modèles, vous devez créer quatre stratégies pour associer les quatre jeux de modèles. À partir des versions 14.1-12.x de NetScaler, en plus d’utiliser une chaîne statique, vous pouvez également utiliser une expression pour dériver le nom du jeu de modèles. L’expression permet de réduire la configuration.

Pour que l’expression identifie le jeu de modèles dans le cadre de son évaluation, vous devez configurer le jeu de modèles comme dynamique à l’aide du mot clé dynamic. L’expression ne prend en compte que les ensembles de modèles configurés comme dynamiques. Si vous n’avez pas configuré le jeu de modèles comme dynamique au moment de la création du jeu de modèles, vous pouvez également le définir ultérieurement. Vous pouvez définir un mot-clé dynamique uniquement pour les ensembles de modèles autres que ceux par défaut.

Dans le cadre de l’évaluation de l’expression, les contrôles suivants sont effectués :

  • Si aucun jeu de modèles ne correspond à l’expression, celle-ci est considérée comme une erreur et le compteur d’erreurs est incrémenté.
  • Si le nom d’un ensemble de modèles correspond à l’expression mais qu’il n’est pas marqué comme dynamique, cela est considéré comme une erreur et le compteur d’erreurs est incrémenté.

Configurer un modèle défini à l’aide de l’interface de ligne de commande

À l’invite de commandes, procédez comme suit :

  1. Créez un ensemble de motifs.

    add policy patset <name>

Exemple :

add policy patset samplepatset

  1. Liez les motifs à l’ensemble de motifs.

    bind policy patset <name> <string> [-index <positive_integer>][-charset ( ASCII | UTF_8 )] [-comment <string>]

Exemple :

bind policy patset samplepatset product1 -index 1 -comment short description about the pattern bound to the pattern set

Remarque : Répétez cette étape pour tous les motifs que vous souhaitez lier au jeu de motifs.

  1. Vérifiez la configuration.

show policy patset <name>

Configurer un ensemble de modèles à l’aide de l’utilitaire de configuration

  1. Accédez à AppExpert > Pattern Sets.
  2. Dans le volet d’informations, cliquez sur Ajouter pour ouvrir la boîte de dialogue Create Pattern Set .
  3. Spécifiez un nom pour le modèle défini dans la zone de texte Nom.
  4. Sous Spécifier le modèle, tapez le premier modèle et, éventuellement, spécifiez les valeurs des paramètres suivants :
    • Traiter la barre oblique inverse comme un caractère d’échappement : cochez cette case pour spécifier que tous les caractères de barre oblique inverse que vous pourriez inclure dans le modèle doivent être traités comme des caractères d’échappement.
    • Index : valeur d’index attribuée par l’utilisateur, comprise entre 1 et 4294967290.
  5. Vérifiez que vous avez saisi les bons caractères, puis cliquez sur Ajouter.
  6. Répétez les étapes 4 et 5 pour ajouter d’autres motifs, puis cliquez sur Créer.

Configuration d’un ensemble de modèles dynamiques

Configurer un ensemble de modèles dynamiques à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes :

  1. Créez des ensembles de motifs.

    add policy patset <name> - dynamic yes

  2. Liez le jeu de motifs à un ensemble de modèles.

    bind patset <name> <string>

  3. Ajoutez une stratégie et utilisez une expression au lieu du nom du jeu de modèles.

    add responder policy <name> <rule> <action>

  4. Vérifiez la configuration.

    show patset -dynamicOnly

Exemple de configuration d’un ensemble de modèles dynamiques à l’aide de la CLI

Créez Compa_Pat et CompB_Pat en tant que deux ensembles de modèles dynamiques.

add policy patset CompA_pat -dynamic yes
bind policy patset CompA_pat stringA
add policy patset CompB_pat -dynamic yes
bind policy patset CompB_pat string B
<!--NeedCopy-->

Ajoutez une stratégie avec une expression qui dérive dynamiquement le nom du jeu de modèles :

add responder policy samplepolicy1 http.req.hostname.contains_any("Comp" + http.req.url.path.get(1) + "_pat") reset

Considérez que http://www.citrix.com/A/home.html ou http://www.google.com/B/test.html sont les URL entrantes. Sur la base de l’URL entrante, l’expression « Comp » + http.req.url.path.get (1) + « _pat » détermine le jeu de modèles, Compa_Pat ou CompB_Pat de manière dynamique au moment de l’exécution. Il n’est pas nécessaire de créer deux stratégies distinctes pour Compa_Pat et CompB_Pat.

Vérifiez la configuration à l’aide de la commande show :

> show patset -dynamicOnly
1) Patset: CompA_pat
2) Patset: CompB_pat
 Done
<!--NeedCopy-->

Configuration d’un ensemble de modèles dynamiques à l’aide de l’interface graphique

  1. Accédez à AppExpert > Pattern Sets.
  2. Cliquez sur Ajouter pour ouvrir la boîte de dialogue Create Pattern Set .
  3. Spécifiez le nom de l’ensemble de données dans la zone de texte Nom .
  4. Cliquez sur Insérer et spécifiez le modèle dans le champ Modèle. Spécifiez éventuellement une valeur pour l’index. L’index est une valeur attribuée par l’utilisateur, comprise entre 1 et 4294967290.
  5. Vérifiez que vous avez saisi les bons caractères, puis cliquez sur Insérer.
  6. Répétez les étapes 4 et 5 pour ajouter d’autres motifs.
  7. Cochez la case Dynamique, puis cliquez sur Créer.
  8. Accédez à AppExpert > Répondeur > StratégiesAjouter.
  9. Créez une expression capable de dériver le jeu de modèles.
  10. Renseignez les autres champs obligatoires et cliquez sur Créer.

Définir, désactiver ou supprimer un ensemble de modèles dynamiques

Pour définir un modèle autre que celui défini par défaut comme dynamique :

> set patset <name> -dynamic yes

Exemple :

> set patset CompA_pat -dynamic yes
 Done
<!--NeedCopy-->

Pour annuler un modèle autre que celui défini par défaut comme dynamique

> unset patset <name> -dynamic

Exemple :

> unset patset CompA_pat -dynamic
Warning: [Dynamic attribute turned off. Expressions using this patset or dataset dynamically will not work.]
 Done
<!--NeedCopy-->

Pour supprimer un ensemble de modèles dynamiques

> rm patset <name>

Exemple :

> rm patset CompA_pat
Warning: [Dynamic patset or dataset removed. Expressions using this patset or dataset dynamically will not work.]
 Done
<!--NeedCopy-->

Remarque :

lorsque vous désactivez ou supprimez un ensemble de modèles dynamique, l’expression qui utilise ce jeu de modèles ne fonctionne pas.

Configurer des ensembles de modèles basés sur des fichiers

L’appliance NetScaler prend en charge les ensembles de modèles basés sur des fichiers.

Configurer des ensembles de modèles basés sur des fichiers à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes :

  • Importez un nouveau fichier d’ensemble de modèles dans l’appliance NetScaler.

     import policy patsetfile <src> <name> -delimiter <char> -charset <ASCII | UTF_8>
     <!--NeedCopy-->
    

    Exemple :

     import policy patsetfile local:test.csv clientids_list –delimiter ,
     <!--NeedCopy-->
    

    Vous pouvez importer un fichier depuis un appareil local, un serveur HTTP ou un serveur FTP. Pour ajouter le fichier depuis votre appareil local, le fichier doit être disponible sur /var/tmp place.

  • Ajoutez un fichier de jeu de modèles au moteur de paquets.

     add policy patsetfile <patset filename>
     <!--NeedCopy-->
    

    Exemple :

     add policy patsetfile clientids_list
     <!--NeedCopy-->
    
  • Mettez à jour un fichier d’ensemble de modèles existant sur l’appliance NetScaler.

     update policy patsetfile <patset filename>
     <!--NeedCopy-->
    

    Exemple :

     update policy patsetfile clientids_list
     <!--NeedCopy-->
    
  • Liez les motifs à l’ensemble de motifs.

     add policy patset <patset name> -patsetfile <patset filename>
     <!--NeedCopy-->
    

    Exemple :

     add policy patset clientid_patset -patsetfile clientids_list
     <!--NeedCopy-->
    
  • Vérifiez la configuration.

     show policy patsetfile clientids_list
    
     Name: clientids_list
     Patset Name: clientid_patset
     Number of Imported Patterns: 8
     Number of Bound Patterns: 8
     (All the patterns bound successfully)
    
     Done
     <!--NeedCopy-->
    

Configurer des ensembles de modèles basés sur des fichiers à l’aide de l’interface graphique

  1. Accédez à AppExpert-> Pattern Set Files.

  2. Dans le volet Importé, cliquez sur Importer.

  3. Sur la page Configurer le fichier du jeu de règles, sélectionnez le fichier que vous souhaitez importer, puis cliquez sur OK.

  4. Sélectionnez le fichier importé, puis cliquez sur Ajouter.

  5. Sur la page Créer un fichier d’ensembles de règles, entrez les détails, puis cliquez sur Créer pour ajouter un ensemble de modèles de stratégies.

Configuration d’un ensemble de modèles