**Apresentando uma nova experiência de console para AWS WAF**

Agora você pode usar a experiência atualizada para acessar a AWS WAF funcionalidade em qualquer lugar do console. Para obter mais detalhes, consulte [Trabalhando com o console](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-console.html). 

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Instrução de regra de correspondência de string
<a name="waf-rule-statement-type-string-match"></a>

Esta seção explica o que é uma instrução de correspondência de string e como ela funciona.

Uma declaração de correspondência de string indica AWS WAF a string que você deseja pesquisar em uma solicitação, onde e como pesquisar na solicitação. Por exemplo, você pode procurar uma string específica no início de qualquer string de consulta na solicitação ou como uma correspondência exata para o cabeçalho `User-agent` da solicitação. Geralmente, a string consiste em caracteres ASCII imprimíveis, mas você pode usar qualquer caractere, do hexadecimal 0x00 a 0xFF (decimal 0 a 255). 

## Características das instruções de regras
<a name="string-match-characteristics"></a>

**Aninhável**: você pode aninhar esse tipo de instrução. 

**WCUs**— O custo base depende do tipo de partida que você usa.
+ **Corresponde exatamente à string**: 2 
+ **Começa com a string**: 2 
+ **Termina com a string**: 2 
+ **Contém a string**: 10 
+ **Contém a palavra**: 10 

Se você usar o componente de solicitação **Todos os parâmetros de consulta**, adicione 10 WCUs. Se você usar o **corpo JSON** do componente de solicitação, dobre o custo WCUs base. Para cada **transformação de texto** aplicada, adicione 10 WCUs.

Esse tipo de instrução opera em um componente de solicitação da web e requer as seguintes configurações do componente de solicitação: 
+ **Componente de solicitação**: a parte da solicitação da web para inspecionar, por exemplo, uma string de consulta ou o corpo.
**Atenção**  
Se você inspecionar os componentes da solicitação **Body**, **JSON body**, **Headers** ou **Cookies**, leia sobre as limitações de quanto conteúdo AWS WAF pode ser inspecionado. [Componentes de solicitação da web de tamanho grande em AWS WAF](waf-oversize-request-components.md) 

  Para informações sobre componentes de solicitação da web, consulte [Ajustando as configurações da declaração de regra em AWS WAF](waf-rule-statement-fields.md).
+ **Transformações de texto opcionais** — Transformações que você deseja AWS WAF realizar no componente de solicitação antes de inspecioná-lo. Por exemplo, você pode transformar para minúsculas ou normalizar o espaço em branco. Se você especificar mais de uma transformação, as AWS WAF processará na ordem listada. Para mais informações, consulte [Usando transformações de texto em AWS WAF](waf-rule-statement-transformation.md).

Além disso, essa instrução requer as seguintes configurações: 
+ **String to match** — Essa é a string que você AWS WAF deseja comparar com o componente de solicitação especificado. Geralmente, a string consiste em caracteres ASCII imprimíveis, mas você pode usar qualquer caractere, do hexadecimal 0x00 a 0xFF (decimal 0 a 255).
+ **Condição de correspondência de string** — Isso indica o tipo de pesquisa que você AWS WAF deseja realizar. 
  + **Corresponde exatamente à string**: a string única e o valor do componente de solicitação são idênticos.
  + **Começa com a strin**: a string aparece no início do componente de solicitação. 
  + **Termina com a string**: a string aparece no final do componente de solicitação. 
  + **Contém string**: a string aparece em qualquer lugar no componente de solicitação. 
  + **Contém a palavra**: a string especificada deve aparecer no componente de solicitação. 

    Para esta opção, a string especificada deve conter apenas caracteres alfanuméricos ou sublinhado (A-Z, a-z, 0-9 ou \$1). 

    Uma das seguintes opções deve ser verdadeira para que a solicitação corresponda: 
    + A string corresponde exatamente ao valor do componente de solicitação, como o valor de um cabeçalho.
    + A string está no início do componente de solicitação e é seguida por um caractere diferente de um caractere alfanumérico ou sublinhado (\$1), por exemplo, `BadBot;`.
    + A string está no fim do componente de solicitação e é precedida por um caractere diferente de um caractere alfanumérico ou sublinhado (\$1), por exemplo, `;BadBot`.
    + A string está no meio do componente de solicitação e é precedida e seguida por caracteres diferentes de caracteres alfanuméricos ou sublinhados (\$1), por exemplo, `-BadBot;`.

## Onde encontrar essa instrução de regra
<a name="string-match-where-to-find"></a>
+ **Criador de regras** no console: para **Tipo de correspondência**, escolha **Condição de correspondência de string** e preencha as strings com as quais você deseja corresponder.
+ **API**: [ByteMatchStatement](https://docs.aws.amazon.com/waf/latest/APIReference/API_ByteMatchStatement.html)