Konfigurieren Sie einen Mustersatz
Um einen Mustersatz zu konfigurieren, müssen Sie die Zeichenketten angeben, die als Muster dienen sollen. Sie können jedem dieser Muster manuell einen eindeutigen Indexwert zuweisen, oder Sie können zulassen, dass die Indexwerte automatisch zugewiesen werden.
Hinweis:
Bei Mustersätzen wird zwischen Groß- und Kleinschreibung unterschieden (es sei denn, Sie geben den Ausdruck an, um Groß- und Kleinschreibung zu ignorieren). Daher ist das Zeichenfolgenmuster “product1” beispielsweise nicht dasselbe wie das Zeichenfolgenmuster “Product1”.
Wichtige Punkte zu Indexwerten:
- Sie können denselben Indexwert nicht an mehr als ein Muster binden.
- Ein automatisch zugewiesener Indexwert ist eine Zahl größer als der höchste Indexwert der vorhandenen Muster innerhalb des Mustersatzes. Wenn der höchste Indexwert vorhandener Muster in einem Mustersatz beispielsweise 104 ist, ist der nächste automatisch zugewiesene Indexwert 105.
- Wenn Sie keinen Index für das erste Muster angeben, wird diesem Muster automatisch der Indexwert 1 zugewiesen.
- Indexwerte werden nicht automatisch regeneriert, wenn ein oder mehrere Muster gelöscht oder geändert werden. Wenn der Satz beispielsweise fünf Muster mit Indizes von 1 bis 5 enthält und wenn das Muster mit einem Index von 3 gelöscht wird, werden die anderen Indexwerte im Mustersatz nicht automatisch regeneriert, um Werte von 1 bis 4 zu erzeugen.
- Der maximale Indexwert, der einem Muster zugewiesen werden kann, ist 4294967290. Wenn dieser Wert bereits einem Muster im Satz zugewiesen ist, müssen Sie allen neu hinzugefügten Mustern manuell Indexwerte zuweisen. Ein unbenutzter Indexwert, der niedriger als ein aktuell verwendeter Wert ist, kann nicht automatisch zugewiesen werden.
Ab Version 14.1-12.x von NetScaler können Sie nicht nur eine statische Zeichenfolge verwenden, sondern auch einen Ausdruck verwenden, um den Namen des Mustersatzes abzuleiten und den Mustersatz in Richtlinienausdrucksmethoden wie CONTAINS_ANY, EQUALS_ANY, STARTSWITH_ANY zuzuordnen. Der Name des Mustersatzes wird dynamisch aus dem Ausdruck abgeleitet und reduziert daher die Anzahl der Richtlinien, die für mehrere Mustersätze erstellt werden müssen. Durch die Erstellung eines dynamischen Mustersatzes können Sie sich wiederholende Konfigurationen vermeiden.
Wenn beispielsweise in Versionen vor NetScaler 14.1-12.x vier Mustersätze vorhanden sind, müssen Sie vier Richtlinien erstellen, um die vier Mustersätze zuzuordnen. Ab Version 14.1-12.x von NetScaler können Sie nicht nur eine statische Zeichenfolge verwenden, sondern auch einen Ausdruck verwenden, um den Namen des Mustersatzes abzuleiten. Der Ausdruck hilft bei der Reduzierung der Konfiguration.
Damit der Ausdruck den Mustersatz als Teil seiner Auswertung identifiziert, müssen Sie den Mustersatz mithilfe des Schlüsselworts dynamic als dynamisch konfigurieren. Der Ausdruck berücksichtigt nur die Mustersätze, die als dynamisch konfiguriert sind. Wenn Sie den Mustersatz zum Zeitpunkt der Erstellung des Mustersatzes nicht als dynamisch konfiguriert haben, können Sie ihn auch später festlegen. Sie können ein dynamisches Schlüsselwort nur für nicht standardmäßige Mustersätze festlegen.
Im Rahmen der Auswertung von Ausdrücken werden die folgenden Prüfungen durchgeführt:
- Wenn es keine Mustersätze gibt, die dem Ausdruck entsprechen, wird dies als Fehler betrachtet und der Fehlerzähler wird erhöht.
- Wenn es einen Mustersatznamen gibt, der dem Ausdruck entspricht, aber nicht als dynamisch gekennzeichnet ist, wird er als Fehler betrachtet und der Fehlerzähler wird erhöht.
Mustersatz über die Befehlszeilenschnittstelle konfigurieren
Führen Sie an der Eingabeaufforderung Folgendes aus:
-
Erstellen Sie einen Mustersatz.
add policy patset <name>
Beispiel:
add policy patset samplepatset
-
Binden Sie Muster an den Mustersatz.
bind policy patset <name> <string> [-index <positive_integer>][-charset ( ASCII | UTF_8 )] [-comment <string>]
Beispiel:
bind policy patset samplepatset product1 -index 1 -comment short description about the pattern bound to the pattern set
Hinweis: Wiederholen Sie diesen Schritt für alle Muster, die Sie an den Mustersatz binden möchten.
- Überprüfen Sie die Konfiguration.
show policy patset <name>
Konfigurieren Sie einen Mustersatz über das Konfigurationsprogramm
- **Navigieren Sie zu **AppExpert > Mustersätze .
- Klicken Sie im Detailbereich auf Hinzufügen, um das Dialogfeld Mustersatz erstellen zu öffnen.
- Geben Sie im Textfeld Name einen Namen für den Mustersatz an.
- Geben Sie unter Muster angeben das erste Muster ein und geben Sie optional Werte für die folgenden Parameter an:
- Backslash als Escape-Zeichen behandeln — Aktivieren Sie dieses Kontrollkästchen, um festzulegen, dass alle umgekehrten Schrägstriche, die Sie möglicherweise in das Muster aufnehmen, als Escape-Zeichen behandelt werden.
- Index — Ein vom Benutzer zugewiesener Indexwert von 1 bis 4294967290.
- Stellen Sie sicher, dass Sie die richtigen Zeichen eingegeben haben, und klicken Sie dann auf Hinzufügen.
- Wiederholen Sie die Schritte 4 und 5, um weitere Muster hinzuzufügen, und klicken Sie dann auf Erstellen.
Einen dynamischen Mustersatz konfigurieren
Konfigurieren Sie einen dynamischen Mustersatz mit der CLI
Geben Sie an der Eingabeaufforderung die folgenden Befehle ein:
-
Erstellen Sie Mustersätze.
add policy patset <name> - dynamic yes -
Binden Sie den Mustersatz an einen Mustersatz.
bind patset <name> <string> -
Fügen Sie eine Richtlinie hinzu und verwenden Sie einen Ausdruck anstelle des Mustersatznamens.
add responder policy <name> <rule> <action> -
Überprüfen Sie die Konfiguration.
show patset -dynamicOnly
Beispiel für die Konfiguration eines dynamischen Mustersatzes mit der CLI
Erstellen Sie Compa_PAT und CompB_PAT als die beiden dynamischen Mustersätze.
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-->
Fügen Sie eine Richtlinie mit einem Ausdruck hinzu, der den Namen des Mustersatzes dynamisch ableitet:
add responder policy samplepolicy1 http.req.hostname.contains_any("Comp" + http.req.url.path.get(1) + "_pat") reset
Bedenken Sie, dass http://www.citrix.com/A/home.html oder http://www.google.com/B/test.html die eingehenden URLs sind. Basierend auf der eingehenden URL bestimmt der Ausdruck „Comp“ + http.req.url.path.get (1) + „_pat“ den Mustersatz, compa_PAT oder compB_PAT, dynamisch zur Laufzeit. Sie müssen nicht zwei separate Richtlinien für Compa_PAT und CompB_PAT erstellen.
Überprüfen Sie die Konfiguration mit dem Befehl show:
> show patset -dynamicOnly
1) Patset: CompA_pat
2) Patset: CompB_pat
Done
<!--NeedCopy-->
Konfigurieren Sie einen dynamischen Mustersatz mit der GUI
- Navigieren Sie zu AppExpert > Pattern Sets.
- Klicken Sie auf Hinzufügen, um das Dialogfeld Mustersatz erstellen zu öffnen.
- Geben Sie im Textfeld Name einen Namen für den Datensatz ein.
- Klicken Sie auf Einfügen und geben Sie das Muster im Feld Muster an. Geben Sie optional einen Wert für den Index an. Index ist ein vom Benutzer zugewiesener Wert zwischen 1 und 4294967290.
- Vergewissern Sie sich, dass Sie die richtigen Zeichen eingegeben haben, und klicken Sie dann auf Einfügen.
- Wiederholen Sie die Schritte 4 und 5, um weitere Muster hinzuzufügen.
- Aktivieren Sie das Kontrollkästchen Dynamisch und klicken Sie dann auf Erstellen.
- Navigieren Sie zu AppExpert > Responder > Policies > Hinzufügen.
- Erstellen Sie einen Ausdruck, der den Mustersatz ableiten kann.
- Füllen Sie die anderen Pflichtfelder aus und klicken Sie auf Erstellen.
Dynamischen Mustersatz setzen, deaktivieren oder entfernen
So legen Sie ein nicht standardmäßiges Muster als dynamisch fest:
> set patset <name> -dynamic yes
Beispiel:
> set patset CompA_pat -dynamic yes
Done
<!--NeedCopy-->
So deaktivieren Sie ein nicht standardmäßiges Muster, das als dynamisch festgelegt ist
> unset patset <name> -dynamic
Beispiel:
> unset patset CompA_pat -dynamic
Warning: [Dynamic attribute turned off. Expressions using this patset or dataset dynamically will not work.]
Done
<!--NeedCopy-->
So entfernen Sie einen dynamischen Mustersatz
> rm patset <name>
Beispiel:
> rm patset CompA_pat
Warning: [Dynamic patset or dataset removed. Expressions using this patset or dataset dynamically will not work.]
Done
<!--NeedCopy-->
Hinweis:
Wenn Sie ein dynamisches Patset deaktivieren oder entfernen, funktioniert der Ausdruck, der diesen Mustersatz verwendet, nicht.
Konfiguration dateibasierter Mustersätze
Die NetScaler-Appliance unterstützt dateibasierte Mustersätze.
Dateibasierte Mustersätze über die CLI konfigurieren
Geben Sie an der Eingabeaufforderung die folgenden Befehle ein:
-
Importieren Sie eine neue Mustersatzdatei in die NetScaler-Appliance.
import policy patsetfile <src> <name> -delimiter <char> -charset <ASCII | UTF_8> <!--NeedCopy-->Beispiel:
import policy patsetfile local:test.csv clientids_list –delimiter , <!--NeedCopy-->Sie können eine Datei von einem lokalen Gerät, HTTP-Server oder FTP-Server importieren. Um die Datei von Ihrem lokalen Gerät hinzuzufügen, muss die Datei am Speicherort
/var/tmpverfügbar sein. -
Fügen Sie der Paket-Engine eine Pattern-Set-Datei hinzu.
add policy patsetfile <patset filename> <!--NeedCopy-->Beispiel:
add policy patsetfile clientids_list <!--NeedCopy--> -
Aktualisieren Sie eine vorhandene Pattern-Set-Datei auf der NetScaler-Appliance.
update policy patsetfile <patset filename> <!--NeedCopy-->Beispiel:
update policy patsetfile clientids_list <!--NeedCopy--> -
Binden Sie Muster an den Mustersatz.
add policy patset <patset name> -patsetfile <patset filename> <!--NeedCopy-->Beispiel:
add policy patset clientid_patset -patsetfile clientids_list <!--NeedCopy--> -
Überprüfen Sie die Konfiguration.
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-->
Dateibasierte Mustersätze über die GUI konfigurieren
-
Navigieren Sie zu AppExpert-> Pattern Set Files.
-
Klicken Sie im Bereich Importiert auf Importieren.
-
Wählen Sie auf der Seite Policy Patset File konfigurieren die Datei aus, die Sie importieren möchten, und klicken Sie auf OK.
-
Wählen Sie die importierte Datei aus und klicken Sie auf Hinzufügen.
-
Geben Sie auf der Seite Policy-Patset-Datei erstellen die Details ein und klicken Sie auf Erstellen, um einen Richtlinienmustersatz hinzuzufügen.