Lingua dei criteri di instradamento per i load balancer

Per impostazione predefinita, la corrispondenza delle stringhe utilizza confronti con distinzione tra maiuscole e minuscole.

Ad esempio, se il percorso dell'URL di richiesta HTTP per alcune richieste è /foo, il predicato seguente non corrisponderà per tale richiesta, poiché viene utilizzato il confronto tra stringhe con distinzione tra maiuscole e minuscole:

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

La corrispondenza senza distinzione tra maiuscole e minuscole viene eseguita se almeno uno dei valori confrontati è una stringa senza distinzione tra maiuscole e minuscole. La sintassi di una stringa senza distinzione tra maiuscole e minuscole è la seguente:

(i '<string content>')

Ad esempio, queste stringhe non fanno distinzione tra maiuscole e minuscole e sono pertanto uguali se utilizzate nei predicati:

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

Rispetto all'esempio originale, questo predicato corrisponde perché utilizza un confronto senza distinzione tra maiuscole e minuscole:

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

Alcune variabili contengono mappe chiave-valore arbitrarie dei dati di richiesta, ad esempio intestazioni di richiesta o cookie. Per ogni chiave, possono esistere uno o più valori. Ad esempio, possono esistere diverse intestazioni di richiesta con lo stesso nome.

In genere, le variabili di mapping possono essere utilizzate nelle regole nei modi riportati di seguito.

• Verificare se una mappa ha una chiave specifica.
• Verificare se una mappa dispone di una chiave specifica con un valore specifico.

Verifica se una mappa ha una chiave specifica:

Controllare se una variabile mappa dispone di una chiave specifica viene eseguita con il matcher in. Per ulteriori dettagli, vedere Lingua dei criteri di instradamento per i load balancer.

Ad esempio:

'Foo' in (http.request.cookies)

Questa condizione corrisponde se la richiesta HTTP dispone di un cookie denominato Foo.

Verifica della presenza di una chiave specifica per una mappa con un valore specifico:

Controllare se una mappa dispone di una chiave specifica con un valore specifico viene eseguita utilizzando la notazione parentesi [] per ottenere i valori in una chiave specifica. La sintassi per l'utilizzo della notazione parentesi è:

<variable>[<key>]

Il valore <key> deve essere specificato come stringa con distinzione tra maiuscole e minuscole o senza distinzione tra maiuscole e minuscole.

Il controllo effettivo di un valore specifico viene eseguito utilizzando il corrispondente eq per verificare se any dei valori in tale chiave sono uguali a tale valore specifico. Il predicato corrisponde se almeno uno dei valori di tale chiave corrisponde a quel valore specifico.

Esempi:

• Per trovare una corrispondenza se un valore qualsiasi dell'intestazione header-name è uguale a header-value:

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

  L'intestazione name viene confrontata caso per caso, ma l'intestazione value viene confrontata caso per caso.

• Per abbinare se qualsiasi valore del cookie "nome-cookie" è uguale a cookie-value:

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

Il programma di corrispondenza not eq può essere utilizzato per verificare che none dei valori in tale chiave siano uguali a un valore specifico.

Esempi:

• Per trovare una corrispondenza se nessun valore dell'intestazione header-name è uguale a header-value:

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

  Il nome dell'intestazione viene confrontato senza distinzione tra maiuscole e minuscole. Il valore dell'intestazione viene confrontato con distinzione tra maiuscole e minuscole.

• Per corrispondere se nessun valore del cookie "cookie-name" è uguale a cookie-value:

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

Le variabili disponibili per essere utilizzate nelle condizioni sono:

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

Una richiesta HTTP/1.1 in entrata è simile a questa (riga di richiesta e intestazioni):

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

Le variabili disponibili per le regole verranno quindi popolate con i dati di questa richiesta nel modo seguente: (i dati per le variabili strutturate vengono visualizzati in formato 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"]
}

Ecco alcuni esempi di come possiamo soddisfare questa richiesta:

• Se si desidera abbinare le richieste al dominio www.domain.com e ai percorsi URL che iniziano con /category/, utilizzare una condizione simile alla seguente:

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

• Per soddisfare le richieste in cui il percorso URL è esattamente /category/some_category o l'elemento query di richiesta action=search:

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

• Per abbinare le richieste con un elemento stringa di query denominato query con valore search terms (dopo l'annullamento dell'escaping dell'URL):

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

• Per abbinare le richieste che hanno cookie cookie_a ma non hanno cookie cookie_c:

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