Cartes de chaînes

Vous pouvez utiliser des mappages de chaînes pour effectuer la correspondance de motifs dans toutes les fonctionnalités Citrix ADC qui utilisent la syntaxe de stratégie par défaut. Un mappage de chaînes est une entité Citrix ADC qui se compose de paires clé-valeur. Les clés et les valeurs sont des chaînes au format ASCII ou UTF-8. La comparaison de chaînes utilise deux nouvelles fonctions, MAP_STRING(<string_map_name>) et IS_STRINGMAP_KEY(<string_map_name>).

Une configuration de stratégie qui utilise des mappages de chaînes fonctionne mieux que celle qui effectue la correspondance de chaînes via des expressions de stratégie, et vous avez besoin de moins de stratégies pour effectuer une correspondance de chaînes avec un grand nombre de paires clé-valeur. Les cartes de chaînes sont également intuitives, simples à configurer et aboutissent à une configuration plus petite.

Fonctionnement des chaînes de caractères

Les mappages de chaînes sont similaires dans la structure aux jeux de motifs (un jeu de motifs définit un mappage des valeurs d’index sur des chaînes ; un mappage de chaînes définit un mappage de chaînes sur des chaînes) et les commandes de configuration des mappages de chaînes (commandes telles que add, bind, unbind, remove et show) sont syntaxiquement similaires à la configuration pour les jeux de motifs. De même, comme pour les valeurs d’index d’un jeu de motifs, chaque clé d’une carte de chaînes doit être unique sur la carte. Le tableau suivant illustre un mappage de chaînes appelé url_string_map, qui contient des URL en tant que clés et valeurs.

Key Valeur
/url_1.html http://www.redirect_url_1.com/url_1.html
/url_2.html http://www.redirect_url_2.com/url_2.html
/url_3.html http://www.redirect_url_1.com/url_1.html

Tableau 1. Carte de chaîne « url_string_map »

Le tableau suivant décrit les deux fonctions qui ont été introduites pour activer la correspondance de chaînes avec les clés dans une carte de chaînes. La correspondance des chaînes est toujours effectuée avec les touches. En outre, les fonctions suivantes effectuent une comparaison entre les clés de la carte de chaîne et la chaîne complète qui est renvoyée par le préfixe d’expression. Les exemples dans les descriptions se réfèrent à l’exemple précédent.

Pour obtenir des informations complètes sur les deux fonctions introduites pour activer la correspondance de chaînes avec les clés d’une carte de chaînes, consultez leFonction de mappage de chaînestableau pdf.

Configuration d’un mappage de chaînes

Vous créez d’abord une chaîne de caractères, puis liez des paires clé-valeur à celle-ci. Vous pouvez créer un mappage de chaînes à partir de l’interface de ligne de commande (CLI) ou de l’utilitaire de configuration.

Pour configurer un mappage de chaînes à l’aide de l’interface de ligne de commande

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

  1. Créez un mappage de chaînes.

    add policy stringmap <name> -comment <string>

  2. Liez une paire clé-valeur à la carte de chaînes.

    bind policy stringmap <name> <key> <value>

    Exemple :

    > bind policy stringmap url_string_map1 "/url_1.html" "http://www.redirect_url_1.com/url_1.html"
    

    Pour configurer un mappage de chaînes à l’aide de l’utilitaire de configuration

    Créez un mappage de chaînes et liez la paire clé-valeur à l’entité créée.

    Accédez à AppExpert > String Maps, cliquez sur Ajouter et spécifiez les détails pertinents.

Exemple : stratégie de répondeur avec une action de redirection

Le cas d’utilisation suivant implique une stratégie de répondeur avec une action de redirection. Dans l’exemple ci-dessous, les quatre premières commandes créent la chaîne map url_string_map et lient les trois paires clé-valeur utilisées dans l’exemple précédent. Après avoir créé la carte et lié les paires clé-valeur, vous créez une action de répondeur (act_url_redirections) qui redirige le client vers l’URL correspondante dans la carte de chaîne ou vers www.default.com. Vous configurez également une stratégie de répondeur (pol_url_redirections) qui vérifie si les URL demandées correspondent à l’une des clés de url_string_map, puis exécute l’action configurée. Enfin, vous liez la stratégie de répondeur au serveur virtuel de commutation de contenu qui reçoit les demandes du client qui doivent être évaluées.

add stringmap url_string_map

bind stringmap url_string_map /url_1.html http://www.redirect_url_1.com/url_1.html

bind stringmap url_string_map /url_2.html http://www.redirect_url_2.com/url_2.html

bind stringmap url_string_map /url_3.html http://www.redirect_url_1.com/url_1.html

add responder action act_url_redirects redirect 'HTTP.REQ.URL.MAP_STRING("url_string_map") ALT "www.default.com"' -bypassSafetyCheck yes

add responder policy pol_url_redirects TRUE act_url_redirects

bind cs vserver csw_redirect -policyname pol_url_redirects -priority 1 -type request