In AppExpert
In Citrix ADC 13.0
In Citrix ADC
In All products
Produktdokumentation
In AppExpert
In Citrix ADC 13.0
In Citrix ADC
In All products
Citrix ADC
Current Release 12.1 11.1
PDF anzeigen

Konfigurieren eines HTTP-Callouts

April 27, 2021
Beigesteuert von: 
C

Beim Konfigurieren eines HTTP-Callouts geben Sie den Typ der Anforderung (HTTP oder HTTPS), das Ziel und das Format der Anforderung, das erwartete Format der Antwort und schließlich den Teil der Antwort an, den Sie analysieren möchten.

Für das Ziel geben Sie entweder die IP-Adresse und den Port des HTTP-Callout-Agents an oder greifen einen virtuellen Server für Lastausgleich, Content Switching oder Cache-Umleitung an, um die HTTP-Callout-Anforderungen zu verwalten. Im ersten Fall werden die HTTP-Callout-Anforderungen direkt an den HTTP-Callout-Agent gesendet. Im zweiten Fall werden die HTTP-Callout-Anforderungen an die virtuelle IP-Adresse (VIP) des angegebenen virtuellen Servers gesendet. Der virtuelle Server verarbeitet die Anforderung dann auf die gleiche Weise, wie er eine Clientanforderung verarbeitet. Wenn Sie beispielsweise erwarten, dass eine große Anzahl von Callouts generiert wird, können Sie Instanzen des HTTP-Callout-Agents auf mehreren Servern konfigurieren, diese Instanzen (als Dienste) an einen virtuellen Lastausgleichsserver binden und dann den virtuellen Lastausgleichsserver in der HTTP-Callout-Konfiguration angeben. Der virtuelle Lastausgleichsserver gleicht dann die Last auf den konfigurierten Instanzen aus, wie durch den Lastausgleichsalgorithmus bestimmt.

Für das Format der HTTP-Callout-Anforderung können Sie die einzelnen Attribute der HTTP-Callout-Anforderung (ein attributbasiertes HTTP-Callout) angeben, oder Sie können die gesamte HTTP-Callout-Anforderung als Standard-Syntaxausdruck angeben (ein ausdrucksbasiertes HTTP-Callout).

Hinweis: Die Appliance überprüft nicht die Gültigkeit der Anforderung. Sie müssen sicherstellen, dass es sich bei der Anforderung um eine gültige Anforderung handelt. Eine falsche oder unvollständige HTTP-Callout-Konfiguration führt zu einer Runtime-UNDEF-Bedingung, die keiner Aktion zugeordnet ist. Die UNDEF-Bedingung aktualisiert lediglich den Leistungsindikator Nicht definierte Treffer, mit dem Sie ein falsch konfiguriertes HTTP-Callout beheben können. Die Appliance analysiert jedoch die HTTP-Callout-Anforderung, damit Sie bestimmte Citrix ADC Funktionen für das Callout konfigurieren können. Dies kann zu einem HTTP-Callout führen, der sich selbst aufruft. Hinweise zur Beschriftungsrekursion und zur Vermeidung dieser Beschriftungen finden Sie unterVermeiden von HTTP-Callout-Rekursion.

Unabhängig davon, ob Sie HTTP-Anforderungsattribute oder einen Ausdruck verwenden, um das Format der HTTP-Callout-Anforderung zu definieren, müssen Sie das Format der Antwort vom HTTP-Callout-Agent und den Teil der Antwort angeben, den Sie auswerten möchten. Die Antwort kann ein boolescher Wert, eine Zahl oder Text sein. Der Teil der Antwort, den Sie auswerten möchten, wird durch einen Ausdruck angegeben. Wenn Sie beispielsweise angeben, dass die Antwort Text enthält, können Sie mitHTTP.RES.BODY(<unit>) angeben, dass die Appliance nur die ersten <unit> Bytes der Antwort vom Callout-Agent auswerten muss.

In der Befehlszeile erstellen Sie zunächst ein HTTP-Callout mithilfe des Befehls add. Wenn Sie ein Callout hinzufügen, werden alle Parameter auf den Standardwert NONE festgelegt, mit Ausnahme der HTTP-Methode, die auf den Standardwert GET festgelegt ist. Anschließend konfigurieren Sie die Parameter des Callouts mit dem Befehl set. Der Befehl set wird verwendet, um beide Arten von Callouts zu konfigurieren (attributsbasiert und ausdrucksbasiert). Der Unterschied liegt in den Parametern, die für die Konfiguration der beiden Arten von Callouts verwendet werden. Dementsprechend enthalten die folgenden Befehlszeilenanweisungen einen set-Befehl zum Konfigurieren eines attributsbasierten Callouts und einen set-Befehl zum Konfigurieren eines ausdrucksbasierten Callouts. Im Konfigurationsprogramm werden alle diese Konfigurationsaufgaben in einem einzigen Dialogfeld ausgeführt.

Hinweis: Bevor Sie ein HTTP-Callout in eine Richtlinie einfügen, können Sie alle konfigurierten Parameter mit Ausnahme des Rückgabetyps ändern. Sobald sich ein HTTP-Callout in einer Richtlinie befindet, können Sie einen Ausdruck, der in dem Callout konfiguriert ist, nicht vollständig ändern. Beispielsweise können Sie HTTP.REQ.HEADER (“myval”) nicht in CLIENT.IP.SRC ändern. Sie können jedoch die Operatoren und Argumente ändern, die an den Ausdruck übergeben werden. Sie können z. B.HTTP.REQ.HEADER("myVal1") zuHTTP.REQ.HEADER("myVal2") oderHTTP.REQ.HEADER("myVal") zu wechselnHTTP.REQ.HEADER("myVal").AFTER_STR(<string>) . Wenn der Befehl set fehlschlägt, erstellen Sie ein neues HTTP-Callout.

Die HTTP-Callout-Konfiguration beinhaltet die Konfiguration von Standard-Syntaxausdrücken. Weitere Informationen zum Konfigurieren von Standard-Syntaxausdrücken finden Sie unter Konfigurieren von Standard-Syntaxausdrücken: Erste Schritte.

So konfigurieren Sie ein HTTP-Callout mit der Befehlszeilenschnittstelle

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

  1. Erstellen Sie ein HTTP-Callout.

    add policy httpCallout <name>

    Beispiel

    add policy httpCallout mycallout

  2. Konfigurieren Sie die Details des HTTP-Callouts.

    • Geben Sie Folgendes ein, um ein attributbasiertes HTTP-Callout zu konfigurieren:
    set policy httpCallout <name> [-IPAddress <ip_addr|ipv6_addr|\*>] [-port <port|\*>] [-vServer <string>] [-returnType <returnType>] [-httpMethod ( GET | POST )] [-hostExpr <string>] [-urlStemExpr <string>] [-headers <name(value)> ...] [-parameters <name(value)> ...] [-resultExpr <string>]

    Beispiel:

    > set policy httpCallout mycallout -vserver lbv1 -returnType num -httpMethod GET -hostExpr 'http.req.header("Host")'
-urlStemExpr "http.req.url" -parameters Name("My Name") -headers Name("MyHeader")
-resultExpr "http.res.body(10000).length"

    Um ein ausdrucksbasiertes HTTP-Callout zu konfigurieren, geben Sie Folgendes ein:

    set policy httpCallout <name> [-vServer <string>] [-returnType <returnType>] [-httpMethod ( GET | POST )] [-fullReqExpr <string>] [-resultExpr <string>]

    Beispiel:

    > set policy httpCallout mycallout1 -vserver lbv1 -returnType num -httpMethod GET
-fullReqExpr q{"GET " + http.req.url + "HTTP/" + http.req.version.major + "." + http.req.version.minor.sub(1)+
"r\nHost:10.101.10.10\r\nAccept: \*/\*\r\n\r\n"}

  3. Überprüfen Sie die Konfigurationen des HTTP-Callout.

    show policy httpCallout <name>

So konfigurieren Sie ein HTTP-Callout mit dem Konfigurationsdienstprogramm

  1. Navigieren Sie zu AppExpert > HTTP-Callouts.
  2. Klicken Sie im Detailbereich auf Hinzufügen.
  3. Konfigurieren Sie im Dialogfeld HTTP-Callout erstellen die Parameter des HTTP-Callouts. Um eine Beschreibung des Parameters zu erhalten, bewegen Sie den Mauszeiger über das Kontrollkästchen.
  4. Klicken Sie auf Create und dann auf Close.
Konfigurieren eines HTTP-Callouts
April 27, 2021
Beigesteuert von: 
C
April 27, 2021
Beigesteuert von: 
C

In diesem Artikel

Feedback zur Site | Datenschutz und rechtliche Hinweise | Cookie-Einstellungen | Consent settings
© 1999- Citrix Systems, Inc. All rights reserved.