Citrix ADC

String-Maps

October 8, 2021

Beigesteuert von:

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:

Erstellen Sie eine String-Map.

add policy stringmap <name> -comment <string>

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.

Erweitern Sie im Navigationsbereich AppExpert und klicken Sie auf String Maps.
Klicken Sie im Detailbereich auf Hinzufügen.
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.
Klicken Sie auf Erstellen und Schließen.

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Citrix Dokumentation maschinell übersetzt. Citrix hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Citrix Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Citrix gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Citrix kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

String-Maps

October 8, 2021

Beigesteuert von:

October 8, 2021

Beigesteuert von:

In diesem Artikel

So funktionieren String-Maps
Konfigurieren einer Zeichenfolgenzuordnung
Beispiel: Responder Policy mit einer Umleitungsaktion