Langage de stratégie de routage pour les équilibreurs de charge

Par défaut, la mise en correspondance de chaînes utilise des comparaisons sensibles à la casse.

Par exemple, si le chemin d'URL d'une demande HTTP est /foo, le prédicat suivant n'établit pas la correspondance pour cette demande, car une comparaison de chaînes sensibles à la casse est utilisée :

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

La mise en correspondance n'est pas sensible aux majuscules/minuscules si au moins l'une des valeurs comparées est une chaîne non sensible aux minuscules. La syntaxe d'une chaîne non sensible à la casse est la suivante :

(i '<string content>')

Par exemple, les chaînes suivantes sont toutes sensibles à la casse et sont donc équivalents lorsqu'elles sont utilisées dans des prédicats :

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

Par rapport à l'exemple d'origine, ce prédicat établit la correspondance car il utilise une comparaison non sensible à la casse :

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

Certaines variables contiennent une correspondance clé-valeur arbitraires des données de demande, par exemple des en -têtes de demande ou des cookies. Il peut exister plusieurs valeurs pour chaque clé. Par exemple, plusieurs en-têtes de demande peuvent porter le même nom.

En règle générale, les variables d'association peuvent être utilisées dans les règles pour :

• vérifier si une correspondance comporte une clé spécifique,
• vérifier si une correspondance comporte une clé spécifique avec une valeur spécifique.

Vérification de la présence d'une clé spécifique dans une correspondance :

La vérification de l'existence d'une variable correspondance dans une clé spécifique est effectuée avec le programme de correspondance in. Pour plus de détails, reportez-vous à Langage de stratégie de routage pour les équilibreurs de charge.

Par exemple :

'Foo' in (http.request.cookies)

Cette condition établit la correspondance si la demande HTTP comporte un cookie portant le nom Foo.

Vérification de la présence d'une clé spécifique avec une valeur spécifique dans une correspondance :

La vérification de l'existence d'une clé spécifique avec une valeur spécifique dans une correspondance est effectuée à l'aide de la notation entre crochets [] qui permet d'obtenir les valeurs au niveau d'une clé spécifique. Voici la syntaxe pour utiliser la notation entre crochets :

<variable>[<key>]

La valeur <key> doit être indiquée sous la forme d'une chaîne sensibles à la casse ou non.

La vérification réelle de l'existence d'une valeur spécifique est effectuée à l'aide du programme de correspondance eq qui vérifie si l'une (any) des valeurs de la clé sont identiques à cette valeur spécifique. Le prédicat établit une correspondance si au moins l'une des valeurs de la clé correspond à la valeur considérée.

Exemples :

• Pour établir une correspondance si l'une des valeur de l'en-tête header-name est égale à header-value :

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

  Le nom name de l'en-tête est comparé sans respect de la casse, mais la valeur value de l'en-tête est comparée avec respect de La casse.

• Pour établir la correspondance si une des valeurs du cookie "cookie-name" est identique à cookie-value, procédez comme suit :

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

L'opérateur de correspondance not eq peut être utilisé pour vérifier que none des valeurs de la clé n'est identique à une valeur spécifique.

Exemples :

• Pour établir la correspondance si aucune valeur de l'en-tête header-name n'est identique à header-value :

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

  Le nom d'en-tête est comparé sans respect de la casse. La valeur d'en-tête est comparée avec respect de la casse.

• Pour établir la correspondance si aucune valeur du cookie "cookie-name" n'est égale à cookie-value :

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

Les variables pouvant être utilisées dans les conditions sont les suivantes :

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

Une demande HTTP/1.1 entrante se présente comme suit (ligne de demande et en-têtes) :

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

Les variables disponibles pour les règles sont alors remplies avec les données de la demande comme suit (les données des variables structurées sont affichées au format JSON) :

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

Voici quelques exemples de mise en correspondance de cette demande :

• Pour mettre en correspondance les demandes et les chemins d'URL qui commencent par /category/ avec le domaine www.domain.com, nous utiliserions une condition telle que La suivante :

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

• Pour mettre les demandes dont le chemin d'URL est exactement /category/some_category ou l'élément de requête de demande action=search, procédez comme suit :

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

• Pour mettre En correspondance les demandes comportant un élément de chaîne de requête nommé query avec la valeur search terms (après annulation de l'échappement d'URL) :

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

• Pour mettre En correspondance les demandes comportant un cookie cookie_a, mais pas le cookie cookie_c :

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