Citrix ADC

Konfigurieren eines HTTP-Callouts

January 21, 2021

Beigesteuert von:

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:

Erstellen Sie ein HTTP-Callout.

add policy httpCallout <name>

Beispiel
```
add policy httpCallout mycallout
```

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"}

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

    show policy httpCallout <name>

So konfigurieren Sie ein HTTP-Callout mit dem Konfigurationsdienstprogramm

Navigieren Sie zu AppExpert > HTTP-Callouts.
Klicken Sie im Detailbereich auf Hinzufügen.
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.
Klicken Sie auf Create und dann auf Close.

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.

Konfigurieren eines HTTP-Callouts

January 21, 2021

Beigesteuert von:

January 21, 2021

Beigesteuert von:

In diesem Artikel

So konfigurieren Sie ein HTTP-Callout mit der Befehlszeilenschnittstelle
So konfigurieren Sie ein HTTP-Callout mit dem Konfigurationsdienstprogramm