Trabalhar com condições de correspondência de string

nota

Essa é a documentação do AWS WAF Classic. Você só deve usar essa versão se tiver criado AWS WAF recursos, como regras e ACLs da web, AWS WAF antes de novembro de 2019 e ainda não os tiver migrado para a versão mais recente. Para migrar os recursos, consulte Migrando seus recursos AWS WAF clássicos para AWS WAF.

Para obter a versão mais recente do AWS WAF, consulteAWS WAF.

Se você deseja permitir ou bloquear solicitações da web com base nas strings que aparecem nas solicitações, crie uma ou mais condições de correspondência de string. Uma condição de correspondência de string identifica a string que você deseja pesquisar e a parte das solicitações da web, como um cabeçalho especificado ou a string de consulta, que você deseja que o AWS WAF Classic inspecione em busca da string. Mais adiante no processo, ao criar uma web ACL, você especifica se deseja permitir ou bloquear solicitações que contêm a string.

Criar uma condição de correspondência de string

Ao criar condições de correspondência de string, você especifica filtros que identificam a string que você deseja pesquisar e a parte das solicitações da web que você deseja que o AWS WAF Classic inspecione para essa string, como o URI ou a string de consulta. Você pode adicionar mais de um filtro a uma condição de correspondência de string, ou então criar uma condição de correspondência de string separada para cada filtro. Veja como cada configuração afeta o comportamento do AWS WAF Classic:

• Um filtro por condição de correspondência de string — Quando você adiciona as condições de correspondência de string separadas a uma regra e adiciona a regra a uma ACL da web, as solicitações da web devem corresponder a todas as condições para que o AWS WAF Classic permita ou bloqueie solicitações com base nas condições.

  Por exemplo, vamos supor que você cria duas condições. Uma corresponde às solicitações da web que contêm o valor BadBot no cabeçalho User-Agent. A outra corresponde a solicitações da web que contêm o valor BadParameter nas strings de consulta. Quando você adiciona as duas condições à mesma regra e adiciona a regra a uma ACL da web, o AWS WAF Classic permite ou bloqueia solicitações somente quando elas contêm os dois valores.

• Mais de um filtro por condição de correspondência de string — Quando você adiciona uma condição de correspondência de string que contém vários filtros a uma regra e adiciona a regra a uma ACL da web, uma solicitação da web precisa corresponder apenas a um dos filtros na condição de correspondência de string para que o AWS WAF Classic permita ou bloqueie a solicitação com base em uma condição.

  Suponha que você crie uma condição em vez de duas, e a única condição contenha os mesmos dois filtros do exemplo anterior. AWS WAF O Classic permite ou bloqueia solicitações se elas contiverem BadBot no User-Agent cabeçalho ou BadParameter na string de consulta.

nota

Ao adicionar uma condição de correspondência de string a uma regra, você também pode configurar o AWS WAF Classic para permitir ou bloquear solicitações da web que não correspondam aos valores da condição.

Para criar uma condição de correspondência de string

1. Faça login no AWS Management Console e abra o AWS WAF console em https://console.aws.amazon.com/wafv2/.

   Se você ver Alternar para o AWS WAF clássico no painel de navegação, selecione-o.

2. No painel de navegação, escolha String and regex matching.

3. Escolha Create condition.

4. Especifique as configurações de filtro aplicáveis. Para ter mais informações, consulte Valores especificados ao criar ou editar condições de correspondência de string.

5. Escolha Adicionar filtro.

6. Se você quiser adicionar outro filtro, repita as etapas 4 e 5.

7. Ao terminar de adicionar os filtros, escolha Criar.

Valores especificados ao criar ou editar condições de correspondência de string

Ao criar ou atualizar uma condição de correspondência de string, você especifica os seguintes valores:

Nome

Digite um nome para a condição de correspondência de string. O nome pode conter somente os caracteres alfanuméricos (A-Z, a-z, 0-9) ou os seguintes caracteres especiais _-!"#`+*},./. Você não poderá alterar o nome de uma condição depois de criá-la.

Tipo

Escolha String match.

Parte da solicitação a ser usada como filtro

Escolha a parte de cada solicitação da web que você deseja que o AWS WAF Classic inspecione em busca da string especificada em Valor para corresponder:

Cabeçalho

Um cabeçalho da solicitação especificada, como o cabeçalho User-Agent ou Referer. Se você selecionar Header, especifique o nome do cabeçalho no campo Header.

Método HTTP

O método HTTP, que indica o tipo de operação que a solicitação pede à origem para executar. CloudFront suporta os seguintes métodos: DELETEGET,HEAD, OPTIONSPATCH,POST,, PUT e.

String de consulta

A parte de um URL exibida após um caractere ?, se houver.

URI

O caminho do URI da solicitação, que identifica o recurso, por exemplo, /images/daily-ad.jpg. Isso não inclui a string de consulta ou os componentes de fragmento do URI. Para obter mais informações, consulte Identificador de recurso uniforme (URI): sintaxe genérica.

A menos que uma transformação seja especificada, um URI não é normalizado e é inspecionado da mesma forma que o AWS recebe do cliente como parte da solicitação. Uma Transformação reformata o URI conforme especificado.

Corpo

A parte de uma solicitação que contém dados adicionais que você deseja enviar para o seu servidor web na forma de corpo da solicitação HTTP, como dados de um formulário.

nota

Se você selecionar Corpo para o valor de Parte da solicitação a ser usada como filtro, o AWS WAF Classic inspecionará somente os primeiros 8.192 bytes (8 KB). Para permitir ou bloquear solicitações para as quais o corpo seja maior que 8.192 bytes, você pode criar uma condição de restrição de tamanho. (AWS WAF Classic obtém o comprimento do corpo dos cabeçalhos da solicitação.) Para ter mais informações, consulte Trabalhar com condições de restrição de tamanho.

Parâmetro de consulta única (somente valor)

Qualquer parâmetro que você tenha definido como parte da string de consulta. Por exemplo, se o URL for “www.xyz.com? UserName =abc& SalesRegion =seattle”, você pode adicionar um filtro ao parâmetro ou. UserNameSalesRegion

Se os parâmetros duplicados aparecem na string de consulta, os valores serão avaliadas como um “OR”. Ou seja, nenhum dos valores acionará uma correspondência. Por exemplo, na URL “www.xyz.com? SalesRegion =boston& SalesRegion =seattle”, “boston” ou “seattle” em Value to match acionarão uma correspondência.

Se você escolher Single query parameter (value only) [Parâmetro de consulta única (somente valor)], também especificará um Query parameter name (Nome de parâmetro de consulta). Esse é o parâmetro na sequência de caracteres de consulta que você inspecionará, como UserNameou SalesRegion. O tamanho máximo do Query parameter name (Nome de parâmetro de consulta) é 30 caracteres. O Query parameter name (Nome de parâmetro de consulta) não diferencia maiúsculas de minúsculas. Por exemplo, se você especificar UserNamecomo o nome do parâmetro Query, isso corresponderá a todas as variações de UserName, como username e userName.

Todos os parâmetros de consulta (somente valores)

Semelhante ao parâmetro de consulta única (somente valor), mas em vez de inspecionar o valor de um único parâmetro, o AWS WAF Classic inspeciona o valor de todos os parâmetros na string de consulta para verificar se o valor corresponde. Por exemplo, se o URL for “www.xyz.com? UserName =abc& SalesRegion =seattle” e você escolher Todos os parâmetros de consulta (somente valores), o AWS WAF Classic acionará uma correspondência se o valor de um UserNameou SalesRegionfor especificado como o Valor a ser correspondido.

Cabeçalho (somente quando “Parte da solicitação a ser usada como filtro” for “Cabeçalho”)

Se você escolher Cabeçalho na parte da solicitação para filtrar na lista, escolha um cabeçalho na lista de cabeçalhos comuns ou insira o nome de um cabeçalho que você deseja que o AWS WAF Classic inspecione.

Tipo de correspondência

Na parte da solicitação que você deseja que o AWS WAF Classic inspecione, escolha onde a string em Value to match deve aparecer para corresponder a esse filtro:

Contém

A string aparece em qualquer lugar da parte especificada da solicitação.

Contém palavra

A parte especificada da solicitação da web deve incluir Value to match, e Value to match deve conter apenas caracteres alfanuméricos ou sublinhado (A-Z, a-z, 0-9 ou _). Além disso, Value to match deve ser uma palavra que tem um dos seguintes significados:

• Value to match corresponde exatamente ao valor da parte especificada da solicitação da web, como o valor de um cabeçalho.

• Value to match está no início da parte especificada da solicitação da web e é seguido por um caractere diferente de um caractere alfanumérico ou sublinhado (_), por exemplo, BadBot;.

• Value to match está no fim da parte especificada da solicitação da web e é precedido por um caractere diferente de um caractere alfanumérico ou sublinhado (_), por exemplo, ;BadBot.

• Value to match está no meio da parte especificada da solicitação da web e é precedido e seguido por caracteres diferentes de caracteres alfanuméricos ou sublinhados (_), por exemplo, -BadBot;.

Correspondência exata com

A string e o valor da parte especificada da solicitação são idênticos.

Inicia com

A string aparece no início da parte especificada da solicitação.

Termina com

A string aparece no fim da parte especificada da solicitação.

Transformação

Uma transformação reformata uma solicitação da web antes que o AWS WAF Classic inspecione a solicitação. Isso elimina algumas das formatações incomuns que os invasores usam nas solicitações da web em um esforço para contornar o Classic. AWS WAF

Você só pode especificar um único tipo de transformação de texto.

As transformações podem executar as seguintes operações:

Nenhum

AWS WAF O Classic não realiza nenhuma transformação de texto na solicitação da web antes de inspecioná-la para verificar se a string em Value corresponde.

Converter para minúsculas

AWS WAF O Classic converte letras maiúsculas (A-Z) em minúsculas (a-z).

Decodificação de HTML

AWS WAF O Classic substitui caracteres codificados em HTML por caracteres não codificados:

• Substitui " por &

• Substitui   por espaço incondicional

• Substitui < por <

• Substitui > por >

• Substitui caracteres representados em formato hexadecimal, &#xhhhh;, pelos caracteres correspondentes

• Substitui caracteres representados em formato decimal, &#nnnn;, pelos caracteres correspondentes

Normalizar espaços em branco

AWS WAF O clássico substitui os seguintes caracteres por um caractere de espaço (decimal 32):

• \f, quebra de página, decimal 12

• \t, tabulação, decimal 9

• \n, quebra de linha, decimal 10

• \r, retorno de carro, decimal 13

• \v, tabulação vertical, decimal 11

• espaço incondicional, decimal 160

Além disso, essa opção substitui vários espaços por um único.

Simplificar a linha de comando

Quando você estiver preocupado que os invasores estão injetando um comando de linha de comando no sistema operacional e usando formatações incomuns para mascarar alguns ou todos os comandos, use esta opção para executar as seguintes transformações:

• Excluir os seguintes caracteres: \" '^

• Excluir espaços antes os seguintes caracteres: / (

• Substituir os seguintes caracteres por um espaço: , ;

• Substituir vários espaços por um espaço

• Converter maiúsculas (A-Z) em minúsculas (a-z)

Decodificar URL

Decodifica uma solicitação codificada por URL.

O valor é codificado por Base64

Se o valor em Value to match for codificado por Base64, marque esta caixa de seleção. Use a codificação Base64 para especificar caracteres não imprimíveis, como guias e linefeeds, que os invasores incluem em suas solicitações.

Valor para corresponder

Especifique o valor que você deseja que o AWS WAF Classic pesquise nas solicitações da web. O comprimento máximo é de 50 bytes. Se você for codificar o valor por base64, o comprimento máximo de 50 bytes será aplicado ao valor antes de ser codificado.

Adicionar e excluir filtros em uma condição de correspondência de string

Você pode adicionar filtros a uma condição de correspondência de string ou excluir filtros. Para alterar um filtro, adicione um novo e exclua o antigo.

Para adicionar ou excluir filtros em uma condição de correspondência de string

1. Faça login no AWS Management Console e abra o AWS WAF console em https://console.aws.amazon.com/wafv2/.

   Se você ver Alternar para o AWS WAF clássico no painel de navegação, selecione-o.

2. No painel de navegação, escolha String and regex matching.

3. Escolha a condição na qual você deseja adicionar ou excluir filtros.

4. Para adicionar filtros, execute as etapas a seguir:

   1. Escolha Adicionar filtro.

   2. Especifique as configurações de filtro aplicáveis. Para ter mais informações, consulte Valores especificados ao criar ou editar condições de correspondência de string.

   3. Escolha Add.

5. Para excluir filtros, execute as etapas a seguir:

   1. Selecione o filtro que você deseja excluir.

   2. Escolha Delete Filter.

Excluir condições de correspondência de string

Se você deseja excluir uma condição de correspondência de string, é preciso primeiro excluir todos os filtros na condição e remover a condição de todas as regras que a estiverem usando, conforme descrito no procedimento a seguir.

Para excluir uma condição de correspondência de string

1. Faça login no AWS Management Console e abra o AWS WAF console em https://console.aws.amazon.com/wafv2/.

   Se você ver Alternar para o AWS WAF clássico no painel de navegação, selecione-o.

2. Remova a condição de correspondência da string das regras que a estejam usando:

   1. No painel de navegação, escolha Rules.

   2. Escolha o nome de uma regra que esteja usando a condição de correspondência de string que você deseja excluir.

   3. No painel à direita, escolha Edit rule.

   4. Escolha o X ao lado da condição que você deseja excluir.

   5. Escolha Atualizar.

   6. Repita para todas as demais regras que estejam usando a condição de correspondência de string que você deseja excluir.

3. Remova os filtros da condição que você deseja excluir:

   1. No painel de navegação, escolha String and regex matching.

   2. Escolha o nome da condição de correspondência da string que você deseja excluir.

   3. No painel à direita, marque a caixa de seleção ao lado de Filter para selecionar todos os filtros.

   4. Escolha Delete filter.

4. No painel de navegação, escolha String and regex matching.

5. No painel String and regex match conditions, selecione a condição de correspondência da string que você deseja excluir.

6. Selecione Delete para excluir a condição selecionada.