Konfigurieren einer Umschreibungsaktion

Warnung

Die Pattern -Funktion in einer Rewrite-Aktion ist ab Citrix ADC 12.0 Build 56.20 veraltet. Alternativ empfiehlt Citrix die Verwendung des Rewrite-Aktionsparameters Suchen.

Nachdem Sie die Funktion Umschreiben aktiviert haben, müssen Sie eine oder mehrere Aktionen konfigurieren, es sei denn, eine integrierte Umschreibaktion ist ausreichend. Alle integrierten Aktionen haben Namen, die mit der Zeichenfolge ns_cvpn beginnen, gefolgt von einer Zeichenfolge aus Buchstaben und Unterstrichen. Integrierte Aktionen führen nützliche und komplexe Aufgaben aus, z. B. das Dekodieren von Teilen einer clientlosen VPN-Anforderung oder -Antwort oder das Ändern von JavaScript- oder XML-Daten. Die integrierten Aktionen können angezeigt, aktiviert und deaktiviert werden, können aber nicht geändert oder gelöscht werden.

Zielausdrücke in Aktionen für TCP-Rewrite müssen mit einem der folgenden Ausdruckspräfixe beginnen:

  • CLIENT.TCP.PAYLOAD. Zum Umschreiben von TCP-Nutzlasten in Client-Anforderungen. For example, CLIENT.TCP.PAYLOAD(10000).AFTER_STR(“string1”).
  • SERVER.TCP.PAYLOAD. Zum Umschreiben von TCP-Nutzlasten in Serverantworten. For example, SERVER.TCP.PAYLOAD(1000).B64DECODE.BETWEEN(“string1”,”string2”).

Sie können alle Typen vorhandener Zeichenfolgenmanipulationsfunktionen mit diesen Präfixen verwenden, um die Zeichenfolgen zu identifizieren, die Sie umschreiben möchten. Um eine Umschreibungsaktion zu konfigurieren, weisen Sie ihr einen Namen zu, geben einen Aktionstyp an und fügen ein oder mehrere Argumente hinzu, die zusätzliche Daten angeben. In der folgenden Tabelle werden die Aktionstypen und die Argumente beschrieben, die Sie mit ihnen verwenden.

Hinweis:

Aktionstypen, die nur für HTTP-Umschreibung verwendet werden können, werden in der Spalte Aktionstyp umschreiben identifiziert.

SieheAktionstyp neu schreibenpdf für weitere Informationen.

So erstellen Sie eine neue Rewrite-Aktion mit der Befehlszeilenschnittstelle

Geben Sie an der Eingabeaufforderung die folgenden Befehle ein, um eine neue Umschreibaktion zu erstellen und die Konfiguration zu überprüfen:

  • add rewrite action <name> <type> <target> [<stringBuilderExpr>] [(-pattern <expression> | -patset <string>)] [-bypassSafetyCheck (YES|NO)]
  • show rewrite action <name>

Beispiel 1. Einfügen eines HTTP-Headers mit der Client-IP:

> add rewrite action insertact INSERT_HTTP_HEADER "client-IP" CLIENT.IP.SRC
Done

> show rewrite action insertact

        Name: insertact
        Operation: insert_http_header   Target:Client-IP
        Value:CLIENT.IP.SRC
        BypassSafetyCheck : NO
        Hits: 0
        Undef Hits: 0
        Action Reference Count: 0
 Done

Beispiel 2. Ersetzen von Strings in einer TCP-Nutzlast (TCP-Rewrite):

> add rewrite action client_tcp_payload_replace_all REPLACE_ALL
  'client.tcp.payload(1000)' '"new-string"' -search text("old-string")
 Done
> show rewrite action client_tcp_payload_replace_all

        Name: client_tcp_payload_replace_all
        Operation: replace_all
        Target:client.tcp.payload(1000)
        Value:"new-string"
        Search: text("old-string")
        BypassSafetyCheck : NO
        Hits: 0
        Undef Hits: 0
        Action Reference Count: 0
 Done
>

So ändern Sie eine vorhandene Umschreibungsaktion mit der Befehlszeilenschnittstelle

Geben Sie an der Eingabeaufforderung die folgenden Befehle ein, um eine vorhandene Umschreibaktion zu ändern und die Konfiguration zu überprüfen:

  • set rewrite action <name> [-target <string>] [-stringBuilderExpr <string>] [(-pattern <expression> | -patset <string>)] [-bypassSafetyCheck (YES|NO)]
  • show rewrite action <name>

Beispiel:


> set rewrite action insertact -target "Client-IP"
 Done
> show rewrite action insertact

        Name: insertact
        Operation: insert_http_header   Target:Client-IP
        Value:CLIENT.IP.SRC
        BypassSafetyCheck : NO
        Hits: 0
        Undef Hits: 0
        Action Reference Count: 0
 Done

So entfernen Sie eine Umschreibungsaktion mit der Befehlszeilenschnittstelle

Geben Sie an der Eingabeaufforderung die folgenden Befehle ein, um eine Umschreibaktion zu entfernen:

rm rewrite action <name>

Beispiel:


> rm rewrite action insertact
Done

So konfigurieren Sie eine Umschreibungsaktion mit dem Konfigurationsdienstprogramm

  1. Navigieren Sie zu AppExpert > Umschreiben > Aktionen.
  2. Führen Sie im Detailbereich eine der folgenden Aktionen aus:
    • Um eine neue Aktion zu erstellen, klicken Sie auf Hinzufügen.
    • Um eine vorhandene Aktion zu ändern, wählen Sie die Aktion aus, und klicken Sie dann auf Öffnen.
  3. Klicken Sie auf Erstellen oder OK. In der Statusleiste wird eine Meldung angezeigt, die besagt, dass die Aktion erfolgreich konfiguriert wurde.
  4. Wiederholen Sie die Schritte 2 bis 4, um beliebig viele Umschreibungsaktionen zu erstellen oder zu ändern.
  5. Klicken Sie auf Schließen.

So fügen Sie einen Ausdruck mithilfe des Dialogfelds Ausdruck hinzufügen hinzu

  1. Klicken Sie im Dialogfeld Rewrite Action erstellen oder Configure Rewrite Action unter dem Textbereich für das Argument type, das Sie eingeben möchten, auf Hinzufügen.
  2. Wählen Sie im Dialogfeld Ausdruck hinzufügen im ersten Listenfeld den ersten Begriff für Ihren Ausdruck aus.

    • HTTP

      Das HTTP-Protokoll. Wählen Sie diese Option, wenn Sie einen Aspekt der Anforderung untersuchen möchten, die sich auf das HTTP-Protokoll bezieht.

    • SYS

      Die geschützte Website (en). Wählen Sie diese Option, wenn Sie einen Aspekt der Anforderung untersuchen möchten, der sich auf den Empfänger der Anforderung bezieht.

    • CLIENT

      Der Computer, der die Anforderung gesendet hat. Wählen Sie diese Option, wenn Sie einen Aspekt des Absenders der Anfrage untersuchen möchten.

    Wenn Sie Ihre Wahl treffen, werden im Listenfeld ganz rechts die entsprechenden Begriffe für den nächsten Teil des Ausdrucks aufgeführt.

  3. Wählen Sie im zweiten Listenfeld den zweiten Begriff für Ihren Ausdruck aus. Die Auswahlmöglichkeiten hängen davon ab, welche Auswahl Sie im vorherigen Schritt getroffen haben, und sind dem Kontext angemessen. Nachdem Sie Ihre zweite Wahl getroffen haben, zeigt das Hilfefenster unterhalb des Fensters Ausdruck erstellen (das leer war) Hilfe an, in dem der Zweck und die Verwendung des gerade ausgewählten Begriffs beschrieben wird.

  4. Fahren Sie fort, Begriffe aus den Listenfeldern auszuwählen, die rechts neben dem vorherigen Listenfeld angezeigt werden, oder geben Sie Zeichenfolgen oder Zahlen in die Textfelder ein, die Sie zur Eingabe eines Werts auffordern, bis der Ausdruck beendet ist.

    Weitere Hinweise zur Sprache der PI-Ausdrücke und zum Erstellen von Ausdrücken für Responderrichtlinien finden Sie unterRichtlinien und Ausdrücke.

    Wenn Sie die Wirkung einer Umschreibaktion testen möchten, wenn sie auf HTTP-Beispieldaten verwendet wird, können Sie den Ausdrucksauswertungsauswerter umschreiben verwenden.

    Hinweis: Der Rewrite Expression Evaluator ist nur im Konfigurationsprogramm verfügbar. Es gibt keine Citrix ADC Befehlszeilenversion.

So werten Sie eine Umschreibaktion mithilfe des Dialogfelds Aktion neu schreiben aus

  1. Wählen Sie im Detailbereich Rewrite-Aktionen die Umschreibaktion aus, die Sie auswerten möchten, und klicken Sie dann auf Auswerten .
  2. Geben Sie im Dialogfeld Expression Evaluator neu schreiben Werte für die folgenden Parameter an. (Ein Sternchen gibt einen erforderlichen Parameter an.)

    • Rewrite Action (Rewrite Action) — Wenn die neu zu bewertende Aktion noch nicht ausgewählt ist, wählen Sie sie aus der Dropdown-Liste aus. Nachdem Sie eine Aktion Umschreiben ausgewählt haben, werden im Abschnitt Details die Details der ausgewählten Aktion Umschreiben angezeigt.
    • Neu (Neu) — Wählen Sie Neu aus, um das Dialogfeld “Neuschreibaktion erstellen” zu öffnen und eine neue Umschreibaktion zu erstellen.
    • Ändern (Modify) — Wählen Sie Ändern (Modify), um das Dialogfenster Rewrite Action konfigurieren (Configure Rewrite Action) zu öffnen und die ausgewählte Rewrite (Rewrite Action) zu ändern.
    • Flow Type (Flow Type) — Gibt an, ob die ausgewählte Rewrite-Aktion mit HTTP-Anforderungsdaten oder HTTP-Antwortdaten getestet werden soll. Der Standardwert ist Request. Wenn Sie mit Antwortdaten testen möchten, wählen Sie Antwort aus.
    • HTTP-Anforderungs-/Antwortdaten* — Dient zur Bereitstellung der HTTP-Daten, die der Rewrite Action Evaluator zum Testen verwendet. Sie können die Daten direkt in das Fenster einfügen oder auf Sample klicken, um einige HTTP-Beispiel-Header einzufügen.
    • Zeilenende anzeigen — Gibt an, ob Endzeichen (n) im Unix-Format am Ende jeder Zeile von HTTP-Beispieldaten angezeigt werden sollen.
    • Beispiel — Fügt HTTP-Beispieldaten in das Fenster HTTP-Anforderungs-/Antwortdaten ein. Sie können entweder GET oder POST Daten auswählen.
    • Durchsuchen (Browse) — Öffnet ein lokales Suchfenster, in dem Sie eine Datei mit HTTP-Beispieldaten aus einem lokalen oder Netzwerkspeicherort auswählen können.
    • Löschen (Clear) — Löscht die aktuellen HTTP-Beispieldaten aus dem Fenster HTTP-Anforderungs-/Antwortdaten.
  3. Klicken Sie auf Auswerten. Der Rewrite Action Evaluator wertet die Auswirkung der Rewrite -Aktion auf die ausgewählten Beispieldaten aus und zeigt die Ergebnisse an, wie sie von der ausgewählten Rewrite -Aktion im Fenster Ergebnisse geändert wurden. Hinzufügungen und Löschungen werden wie in der Legende in der unteren linken Ecke des Dialogfensters angegeben hervorgehoben.
  4. Fahren Sie mit der Auswertung von Rewrite-Aktionen fort, bis Sie festgestellt haben, dass alle Aktionen die gewünschte Wirkung haben.

    • Sie können die ausgewählte Rewrite-Aktion ändern und die geänderte Version testen, indem Sie auf Ändern klicken, um das Dialogfeld Rewrite-Aktion konfigurieren zu öffnen, die Änderungen vorzunehmen und zu speichern, und dann erneut auf Auswerten klicken.
    • Sie können eine andere Umschreibaktion mit denselben Anforderungs- oder Antwortdaten auswerten, indem Sie sie in der Dropdown-Liste Aktion neu schreiben auswählen und dann erneut auf Auswerten klicken.
  5. Klicken Sie auf Schließen, um den Rewrite Expression Evaluator zu schließen und zum Bereich Rewrite Actions zurückzukehren.

    Um eine Umschreibaktion zu löschen, wählen Sie die zu löschende Umschreibaktion aus, klicken Sie dann auf Entfernen, und bestätigen Sie, wenn Sie dazu aufgefordert werden, indem Sie auf OK klicken.