Citrix ADC

String-Maps

Sie können Zeichenfolgenzuordnungen verwenden, um einen Musterabgleich in allen Citrix ADC-Funktionen durchzuführen, die die Standardrichtliniensyntax verwenden. Eine String-Map ist eine Citrix ADC-Entität, die aus Schlüssel-Wert-Paaren besteht. Die Schlüssel und Werte sind Zeichenfolgen im ASCII- oder UTF-8-Format. Beim Stringvergleich werden zwei neue Funktionen verwendet, MAP_STRING(<string_map_name>) und IS_STRINGMAP_KEY(<string_map_name>).

Eine Richtlinienkonfiguration, die Zeichenfolgenzuordnungen verwendet, ist besser als eine, die Zeichenfolgenabgleich durch Richtlinienausdrücke durchführt, und Sie benötigen weniger Richtlinien, um Zeichenfolgenabgleich mit einer großen Anzahl von Schlüssel-Wert-Paaren durchzuführen. String-Maps sind außerdem intuitiv, einfach zu konfigurieren und führen zu einer kleineren Konfiguration.

So funktionieren String-Maps

String-Maps ähneln in ihrer Struktur Mustersätzen (ein Mustersatz definiert eine Zuordnung von Indexwerten zu Zeichenfolgen; eine String-Map definiert eine Zuordnung von Zeichenfolgen zu Zeichenfolgen) und die Konfigurationsbefehle für String-Maps (Befehle wie Hinzufügen, Bind, Unbind, Remove und Show) ähneln syntaktisch der Konfiguration Befehle für Mustersätze. Ebenso wie bei Indexwerten in einem Mustersatz muss jeder Schlüssel in einer String-Map in der gesamten Map eindeutig sein. Die folgende Tabelle zeigt eine String-Map namens url_string_map, die URLs als Schlüssel und Werte enthält.

Key Wert
/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

Tabelle 1. String-Map “url_string_map”

In der folgenden Tabelle werden die beiden Funktionen beschrieben, die eingeführt wurden, um den Zeichenfolgenabgleich mit Schlüsseln in einer String-Map zu ermöglichen. Der Zeichenfolgenabgleich wird immer mit den Schlüsseln durchgeführt. Zusätzlich führen die folgenden Funktionen einen Vergleich zwischen den Schlüsseln in der String-Map und der vollständigen Zeichenfolge durch, die vom Ausdruck-Präfix zurückgegeben wird. Die Beispiele in den Beschreibungen beziehen sich auf das vorangehende Beispiel.

Vollendete Informationen zu den beiden Funktionen, die zum Aktivieren des String-Abgleichs mit Schlüsseln in einer String-Map eingeführt wurden, finden Sie unter String Map Funktionstabelle pdf.

Konfigurieren einer Zeichenfolgenzuordnung

Sie erstellen zuerst eine String-Map und binden dann Schlüssel-Wert-Paare daran. Sie können eine String-Map über die Befehlszeilenschnittstelle (CLI) oder das Konfigurationsdienstprogramm erstellen.

So konfigurieren Sie eine String-Map über die Befehlszeile

Führen Sie an der Eingabeaufforderung die folgenden Schritte aus:

  1. Erstellen Sie eine String-Map.

add policy stringmap <name> -comment <string>

  1. Bindet ein Schlüssel-Wert-Paar an die String-Map.

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

Beispiel:

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

So konfigurieren Sie eine Zeichenfolgenzuordnung über die Citrix ADC GUI

Navigieren Sie zu AppExpert > String Maps, klicken Sie auf Hinzufügen und geben Sie die entsprechenden Details an.

Beispiel: Responder Policy mit einer Umleitungsaktion

Der folgende Anwendungsfall beinhaltet eine Responder Policy mit einer Umleitungsaktion. Im Beispiel unten erstellen die ersten vier Befehle die String-Map url_string_map und binden die drei im vorherigen Beispiel verwendeten Schlüssel-Wert-Paare. Nachdem Sie die Map erstellt und die Schlüssel-Wert-Paare gebunden haben, erstellen Sie eine Responder Action (act_url_redirects), die den Client zur entsprechenden URL in der String-Map oder zu www.default.com umleitet. Sie konfigurieren auch eine Responder Policy (pol_url_directs), die prüft, ob angeforderte URLs mit einem der Schlüssel in url_string_map übereinstimmen, und dann die konfigurierte Aktion ausführt. Schließlich binden Sie die Responder Policy an den virtuellen Content Switching-Server, der die auszuwertenden Clientanforderungen empfängt.

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

`Responder-Aktion hinzufügen act_url_directs−Weiterleitung ‘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

So konfigurieren Sie eine Zeichenfolgenzuordnung über die Citrix ADC GUI

Folgen Sie dem unten angegebenen Verfahren, um eine String-Map zu konfigurieren.

  1. Erweitern Sie im Navigationsbereich AppExpert und klicken Sie auf String Maps.
  2. Klicken Sie im Detailbereich auf Hinzufügen.
  3. Legen Sie auf der Seite String-Map erstellen die folgenden Parameter fest:
    • Name. Name der String-Map.
    • Konfigurieren Sie den Schlüsselwert. ASCII-basierter Schlüsselwerteintrag, der an die Zeichenfolgenzuordnung gebunden ist
    • Kommentare. Eine kurze Beschreibung der an die String-Map gebundenen Schlüsselwerte.
  4. Klicken Sie auf Erstellen und Schließen.

    Konfiguration der Zeichenfolgenzuordnung

String-Maps