Linguagem de Política de Roteamento para Balanceadores de Carga

A correspondência de string usa comparações com distinção entre maiúsculas e minúsculas por padrão.

Por exemplo, se o caminho de URL de solicitação HTTP para alguma solicitação for /foo, o predicado a seguir não corresponderia à solicitação, porque é usada a comparação entre strings com distinção entre maiúsculas e minúsculas:

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

A vinculação sem distinção entre maiúsculas e minúsculas é feita se pelo menos um dos valores comparados for uma string sem distinção entre maiúsculas e minúsculas. A sintaxe de uma string que não faz distinção entre maiúsculas e minúsculas é:

(i '<string content>')

Por exemplo, essas strings não fazem distinção entre maiúsculas e minúsculas e, portanto, são as mesmas, quando usadas em predicados:

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

Em comparação com o exemplo original, este predicado não corresponde, porque usa comparação sem distinção entre maiúsculas e minúsculas:

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

Algumas variáveis contêm mapas de chave/valor arbitrários de dados de solicitação, por exemplo, cabeçalhos ou cookies de solicitação. Para cada chave, pode haver um ou mais valores. Por exemplo, pode haver diversos cabeçalhos de solicitação com o mesmo nome.

Normalmente, as variáveis de mapa podem ser usadas nas regras destas maneiras:

• Para verificar se um mapa tem uma chave específica.
• Para verificar se um mapa tem uma chave específica com um valor específico.

Verificando se um mapa tem uma chave específica:

Verificando se uma variável de mapa tem uma chave específica é feita com o correspondente in. Para obter mais detalhes, consulte Linguagem de Política de Roteamento para Balanceadores de Carga.

Por exemplo:

'Foo' in (http.request.cookies)

Esta condição corresponde se a solicitação HTTP tiver um cookie com o nome Foo.

Verificando se um mapa tem uma chave específica com um valor específico:

Verificar se um mapa tem uma chave específica com um valor específico é feito usando uma notação de colchete [] para obter os valores em uma chave específica. A sintaxe para usar a notação de colchete é:

<variable>[<key>]

<key> deve ser especificado como uma string que diferencia maiúsculas de minúsculas ou que não diferencia maiúsculas de minúsculas.

A verificação real de um valor específico é feita usando o correspondente eq para verificar se any dos valores nessa chave são iguais a esse valor específico. O predicado corresponderá se pelo menos um dos valores nessa chave corresponder a esse valor específico.

Exemplos:

• Para fazer correspondência se qualquer valor do cabeçalho header-name for igual a header-value:

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

  O cabeçalho name é comparado sem distinção, mas o cabeçalho value é comparado com distinção entre maiúsculas e maiúsculas.

• Para fazer a correspondência se qualquer valor do cookie "cookie-name" for igual a cookie-value:

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

O correspondente not eq pode ser usado para verificar se none dos valores nessa chave são iguais a um valor específico.

Exemplos:

• Para corresponder se nenhum valor do cabeçalho header-name for igual a header-value:

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

  O nome do cabeçalho é comparado sem distinção entre maiúsculas e minúsculas. O valor do cabeçalho é comparado com distinção entre maiúsculas e minúsculas.

• Para corresponder se nenhum valor do cookie "cookie-name" for igual a cookie-value:

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

As variáveis disponíveis para uso nas condições são:

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

Uma solicitação HTTP/1.1 de entrada se parece com esta (linha e cabeçalhos da solicitação):

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

Em seguida, as variáveis disponíveis para regras seriam preenchidas com dados dessa solicitação da seguinte forma: (os dados para variáveis estruturadas são mostrados no 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"]
}

Veja alguns exemplos de como poderíamos fazer a correspondência dessa solicitação:

• Se quiséssemos fazer a correspondência das solicitações ao domínio www.domain.com e aos caminhos de URL que começam com /category/, usaríamos uma condição como esta:

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

• Para corresponder às solicitações em que o caminho do URL é exatamente /category/some_category ou o elemento de consulta de solicitação action=search:

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

• Para corresponder as solicitações que têm um elemento da string de consulta chamado query com o valor search terms (após o cancelamento do escape do URL):

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

• Para corresponder às solicitações que têm um cookie cookie_a, mas não têm um cookie cookie_c:

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