Routing-Policy-Sprache für Load Balancer

Beim Vergleich der Zeichenfolgen wird standardmäßig die Groß-/Kleinschreibung beachtet.

Beispiel: Wenn der URL-Pfad für eine HTTP-Anforderung /foo lautet, ergibt das folgende Prädikat für diese Anforderung keine Übereinstimmung, da bei diesem Zeichenfolgenvergleich die Groß-/Kleinschreibung beachtet wird:

http.request.url.path eq '/FOO'

Der Abgleich ohne Berücksichtigung der Groß-/Kleinschreibung erfolgt, wenn es sich bei mindestens einem der verglichenen Werte darum handelt, dass eine Zeichenfolge ohne Berücksichtigung der Groß-/Kleinschreibung verwendet wird. Die Syntax für eine Zeichenfolge, bei der die Groß-/Kleinschreibung nicht beachtet werden soll, lautet wie folgt:

(i '<string content>')

Beispiel: Bei diesen Zeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet und ist daher bei der Verwendung in Prädikaten gleichwertig:

(i 'foo')
(i 'Foo')
(i 'FOO')

Anders als im ursprünglichen Beispiel ergibt dieses Prädikat eine Übereinstimmung, da es beim Vergleich die Groß-/Kleinschreibung nicht beachtet:

http.request.url.path eq (i '/FOO')

Einige Variablen enthalten beliebige Schlüssel/Wert-Zuordnungen von Anforderungsdaten, z.B. Anforderungsheader oder Cookies. Für jeden Schlüssel kann es einen oder mehrere Werte geben. Beispiel: Es können verschiedene Anforderungsheader mit demselben Namen vorhanden sein.

In der Regel können Zuordnungsvariablen in Regeln wie folgt verwendet werden:

• Prüfen, ob eine Zuordnung einen bestimmten Schlüssel enthält
• Prüfen, ob eine Zuordnung einen bestimmten Schlüssel mit einem bestimmten Wert enthält

Prüfung, ob eine Zuordnung einen bestimmten Schlüssel enthält:

Bei der Prüfung, ob eine Zuordnungsvariable einen bestimmten Schlüssel enthält, wird der in-Matcher verwendet. Weitere Informationen finden Sie unter Routing-Policy-Sprache für Load Balancer.

Beispiel:

'Foo' in (http.request.cookies)

Diese Bedingung ist erfüllt, wenn die HTTP-Anforderung ein Cookie mit dem Namen Foo enthält.

Prüfung, ob eine Zuordnung einen bestimmten Schlüssel mit einem bestimmten Wert enthält:

Bei der Prüfung, ob eine Zuordnung einen bestimmten Schlüssel mit einem bestimmten Wert hat, wird der Notation [] mit Klammer verwendet, um die Werte für einen bestimmten Schlüssel abzurufen. Die Syntax für die Notation mit Klammern lautet wie folgt:

<variable>[<key>]

<key> muss als Zeichenfolge angegeben werden, bei der Groß-/Kleinschreibung beachtet wird, oder nicht.

Die eigentliche Prüfung für einen bestimmten Wert erfolgt mit dem Matcher eq, um zu prüfen, ob die any der Werte bei diesem Schlüssel mit dem spezifischen Wert übereinstimmt. Das Prädikat ergibt eine Übereinstimmung, wenn mindestens einer der Werte in diesem Schlüssel mit diesem spezifischen Wert übereinstimmt.

Beispiele:

• Übereinstimmung, wenn ein Wert des Headers header-name gleich header-value ist:

  http.request.headers[(i 'header-name')] eq 'header-value'

  Bei Header name wird die Groß-/Kleinschreibung wird nicht beachtet. Bei Header value wird jedoch Groß-/Kleinschreibung beachtet.

• Übereinstimmung, wenn ein Wert des Cookies "cookie-name" gleich cookie-value ist:

  http.request.cookies['cookie-name'] eq 'cookie-value'

Mit dem Matcher not eq können Sie prüfen, ob none der Werte bei diesem Schlüssel einem bestimmten Wert entspricht.

Beispiele:

• Übereinstimmung, wenn kein Wert des Headers header-name gleich header-value ist:

  http.request.headers[(i 'header-name')] not eq 'header-value'

  Bei "header-name" wird die Groß-/Kleinschreibung nicht beachtet. Bei "header-value" wird jedoch die Groß-/Kleinschreibung beachtet.

• Übereinstimmung, wenn kein Wert des Cookies "cookie-name" gleich cookie-value ist:

  http.request.cookies['cookie-name'] not eq 'cookie-value'

Folgende Variablen können in den Bedingungen verwendet werden:

{
  "key": [
    "value",
    "a"
  ],
  "another key": [
    "another value"
  ],
}

Eine eingehende HTTP/1.1-Anforderung sieht folgendermaßen aus (Anforderungszeile und Header):

GET /category/some_category?action=search&query=search+terms&filters[]=5&features[]=12 HTTP/1.1
Accept-Encoding: gzip, deflate, br
Cookie: cookie_a=1; cookie_b=foo
Host: www.domain.com
User-Agent: Browser Foo/1.0
X-Forwarded-For: 1.2.3.4, 5.6.7.8
X-Forwarded-For: 9.10.11.12

Anschließend werden die für Regeln verfügbaren Variablen wie folgt mit Daten aus dieser Anforderung aufgefüllt (die Daten für strukturierte Variablen werden im JSON-Format angezeigt):

http.request.url.path: "/category/some_category"
 
http.request.url.query: {
  "action": ["search"],
  "query": ["search terms"],
  "filters[]": ["5", "12"]
}
 
http.request.headers: {
  "Accept-Encoding": ["gzip, deflate, br"],
  "Cookie": ["some_cookie=1; another_cookie=foo"],
  "Host": ["www.domain.com"],
  "User-Agent": ["Browser Foo/1.0"],
  "X-Forwarded-For": ["1.2.3.4, 5.6.7.8", "9.10.11.12"]
}
 
http.request.cookies: {
  "cookie_a": ["1"],
  "cookie_b": ["foo"]
}

Hier finden Sie einige Beispiele, wie diese Anforderung abgeglichen werden könnte:

• Wenn Anforderungen mit der Domain www.domain.com und URL-Pfaden, die mit /category/ beginnen, abgeglichen werden sollen, wird eine Bedingung wie die Folgende verwendet:

  all(http.request.headers[(i 'Host')] eq 'www.domain.com', http.request.url.path sw '/category')

• So werden Anforderungen gefunden, bei denen der URL-Pfad genau /category/some_category oder das Abfrageelement action=search der Anforderung lautet:

  any(http.request.url.path eq '/category/some_category', http.request.url.query['action'] eq 'search')

• So werden Anforderungen, die ein Abfragezeichenfolgenelement namens query mit dem Wert search terms (nach der URL-Demaskierung) enthalten, abgeglichen:

  http.request.url.query['query'] eq 'search terms'

• So werden Anforderungen mit dem Cookie cookie_a, aber ohne Cookie cookie_c abgeglichen:

  all('cookie_a' in (http.request.cookies), 'cookie_c' not in (http.request.cookies))