Linguagem de Política de Roteamento para Balanceadores de Carga

Distinção entre maiúsculas e minúsculas da string

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 do URL da solicitação HTTP para alguma solicitação fosse /foo, o seguinte predicado não corresponderia a essa solicitação porque a comparação de string com distinção entre maiúsculas e minúsculas é usada:

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

A correspondência sem distinção entre maiúsculas e minúsculas será 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, portanto são equivalentes quando usadas em predicados:

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

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

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

Variáveis de Tipo de Mapa

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

Geralmente, as variáveis de mapa podem ser usadas nas regras das seguintes 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:

A verificação 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)

Essa condição corresponde se a solicitação HTTP tem um cookie com o nome 'Foo'.

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

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

<variable>[<key>]

O valor <key> deve ser especificado como string com ou sem distinção entre maiúsculas e minúsculas.

A verificação real de um valor específico é feita usando o correspondente eq para verificar se any (algum) dos valores nessa chave é igual 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 a 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 nome do cabeçalho é comparado sem distinção entre maiúsculas e minúsculas, mas o valor do cabeçalho é comparado com distinção entre maiúsculas e minúsculas.

• Para corresponder 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 (nenhum) dos valores nessa chave é igual 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'

Todas as Variáveis Disponíveis

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

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

Exemplos

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 com o domínio "www.domain.com" e 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 fazer a correspondência das 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 fazer a correspondência das solicitações que têm um elemento de string de consulta chamado "query" com o valor "search terms" (após a eliminação do escape do URL)

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

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

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