Trabalhar com condições de correspondência de string - AWS WAF, AWS Firewall Manager, e AWS Shield Advanced
Criar uma condição de correspondência de stringValores especificados ao criar ou editar condições de correspondência de stringAdicionar e excluir filtros em uma condição de correspondência de stringExcluir condições de correspondência de string

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

Atenção

O suporte ao AWS WAF Classic terminará em 30 de setembro de 2025.

nota

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

Para obter a versão mais recente do AWS WAF, consulte AWS 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 de solicitações da web, como um cabeçalho especificado ou a string de consulta, que você deseja que o AWS WAF Classic inspecione quanto à 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

Quando você cria condições de correspondência de string, especifica filtros que identificam a string que deseja pesquisar e a parte das solicitações da web que deseja que o AWS WAF Classic inspecione quanto a 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 condições de correspondência de string a uma regra e adiciona a regra à web ACL, as solicitações da web devem corresponder a todas as condições para o AWS WAF Classic permitir ou bloquear solicitações de acordo com as 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ê adicionar ambas as condições à mesma regra e adicionar a regra a uma web ACL, o AWS WAF Classic permitirá ou bloqueará as solicitações somente quando elas contiverem 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 web ACL, uma solicitação da web precisa apenas corresponder a um dos filtros na condição de correspondência de string para o AWS WAF Classic permitir ou bloquear a solicitação de acordo com essa condição.

    Vamos supor que você crie uma condição, em vez de duas, e que essa condição contém os mesmos dois filtros como no exemplo anterior. AWS WAF O Classic permite ou bloqueia solicitações se elas contiverem seja BadBot no cabeçalho User-Agent 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 console do AWS WAF em https://console.aws.amazon.com/wafv2/.

    Se você vir Switch to AWS WAF Classic 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 para a qual você deseja que o AWS WAF Classic inspecione a string especificada em Value to match (Valor para correspondência):

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. O CloudFront oferece suporte aos seguintes métodos: DELETE, GET, HEAD, OPTIONS, PATCH, POST e PUT.

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 será normalizado, mas sim inspecionado, exatamente como a AWS o receber 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. (O 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 para o parâmetro UserName ou SalesRegion.

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, no URL “www.xyz.com?SalesRegion=boston&SalesRegion=seattle”, “boston” ou “seattle” em Valor para corresponder acionará 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). Este é o parâmetro na string de consulta que você vai inspecionar, tal como UserName ou 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 UserName como Query parameter name (Nome de parâmetro de consulta), todas as variações de UserName serão correspondentes, 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 quanto ao Valor para correspondência. 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 de valor se UserName ou SalesRegion for especificado como Valor para correspondência.

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

Se você selecionar Cabeçalho da lista Parte da solicitação a ser usada como filtro, escolha um cabeçalho na lista de cabeçalhos comuns ou digite 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 Valor para correspondência deve aparecer para que haja correspondência com 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 de o AWS WAF Classic inspecionar a solicitação. Isso elimina algumas das formatações incomuns que os invasores usam em solicitações da web na tentativa de evitar o AWS WAF Classic.

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

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

Nenhum

O AWS WAF Classic não executa nenhuma transformação de texto na solicitação da web antes de inspecioná-la em busca da string em Valor para correspondência.

Converter para minúsculas

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

Decodificação de HTML

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

  • Substitui " por &

  • Substitui   por espaço incondicional

  • Substitui &lt; por <

  • Substitui &gt; 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

O AWS WAF Classic 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 console do AWS WAF em https://console.aws.amazon.com/wafv2/.

    Se você vir Switch to AWS WAF Classic 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 Adicionar.

  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 console do AWS WAF em https://console.aws.amazon.com/wafv2/.

    Se você vir Switch to AWS WAF Classic 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 Regras.

    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. Selecione 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.