Citrix ADC

Cartes à cordes

Vous pouvez utiliser des mappages de chaînes pour effectuer une correspondance de modèles dans toutes les fonctionnalités de Citrix ADC qui utilisent la syntaxe de stratégie par défaut. Une carte de chaînes est une entité Citrix ADC composée 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 qu’une configuration qui effectue une 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 String Maps sont également intuitifs, simples à configurer et se traduisent par une configuration plus petite.

Fonctionnent les String Maps

Les mappages de chaînes ont une structure similaire aux jeux de motifs (un jeu de motifs définit un mappage des valeurs d’index avec des chaînes ; un mappage de chaînes définit un mappage de chaînes avec des chaînes de caractères) et les commandes de configuration des mappages de chaînes (commandes telles que add, bind, unbind, remove et show) sont syntaxiquement similaires à la configuration commandes pour les jeux de motifs. De plus, 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 sous forme de clés et de 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. String Map « url_string_map »

Le tableau suivant décrit les deux fonctions qui ont été introduites pour activer la correspondance de chaînes avec des clés dans un mappage de chaînes. La correspondance des chaînes est toujours effectuée avec les clés. En outre, les fonctions suivantes effectuent une comparaison entre les clés du mappage de chaînes et la chaîne complète 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 des clés dans une carte de chaînes, reportez-vous au tableau des fonctions de carte de chaînes pdf.

Configuration d’un mappage de chaînes

Vous créez d’abord une carte de chaînes, puis vous y liez des paires clé-valeur. 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 une carte de chaînes.

add policy stringmap <name> -comment <string>

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

bind policy stringmap <name> <key> <value> [-comment <string>]

Exemple :

bind policy stringmap url_string_map1 "/url_1.html" "http://www.redirect_url_1.com/url_1.html"
<!--NeedCopy-->

Pour configurer un mappage de chaînes à l’aide de l’interface graphique Citrix ADC

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 carte de chaînes 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_redirects) qui redirige le client vers l’URL correspondante dans la carte de chaînes ou vers www.default.com. Vous configurez également une stratégie de répondeur (pol_url_redirects) 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 des clients 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

`Ajouter l’action du répondeur act_url_redirects rediriger ‘HTTP.REQ.URL.MAP_STRING (« url_string_map ») ALT « www.default.com”’

add responder policy pol_url_redirects TRUE act_url_redirects

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

Pour configurer un mappage de chaînes à l’aide de l’interface graphique Citrix ADC

Suivez la procédure ci-dessous pour configurer un mappage de chaînes.

  1. Dans le volet de navigation, développez AppExpert et cliquez sur String Maps.
  2. Dans le volet d’informations, cliquez sur Ajouter.
  3. Dans la page Create String Map, définissez les paramètres suivants :
    • Name. Nom de la carte de chaînes.
    • Configurez la valeur de clé. Entrée de valeur de clé ASCII liée au mappage de chaînes
    • Commentaires. Une brève description des valeurs clés liées à la carte de chaînes.
  4. Cliquez sur Créer et Fermer.

    configuration de la carte de chaînes

Cartes à cordes