

**Presentamos una nueva experiencia de consola para AWS WAF**

Ahora puede usar la experiencia actualizada para acceder a las AWS WAF funciones desde cualquier parte de la consola. Para obtener más información, consulte [Trabajar con la consola](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-console.html). 

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS WAF ejemplos de concordancia de etiquetas
<a name="waf-rule-label-match-examples"></a>

En esta sección se proporcionan ejemplos de especificaciones de coincidencia para la instrucción de la regla de coincidencia de etiquetas. 

**nota**  
Para crear estas listas JSON en la consola se agregó una regla a un paquete de protección (ACL web) con las especificaciones de coincidencia de etiquetas y, a continuación, se editó la regla y se cambió al **Editor de reglas JSON**. También puede obtener el JSON de un grupo de reglas o un paquete de protección (ACL web) a través de la interfaz de línea de comandos APIs o de la interfaz de línea de comandos. 

**Topics**
+ [

## Comparación con una etiqueta local
](#waf-rule-label-match-examples-local-label)
+ [

## Comparación con una etiqueta de otro contexto
](#waf-rule-label-match-examples-label)
+ [

## Comparación con una etiqueta de grupo de reglas administradas
](#waf-rule-label-match-examples-mgd-rg-label)
+ [

## Comparación con un espacio de nombres local
](#waf-rule-label-match-examples-local-namespace)
+ [

## Comparación con un nombre de espacio de un grupo de reglas administradas
](#waf-rule-label-match-examples-mgd-rg-namespace)

## Comparación con una etiqueta local
<a name="waf-rule-label-match-examples-local-label"></a>

La siguiente lista de JSON muestra una instrucción de coincidencia de etiquetas para una etiqueta que se ha agregado a la solicitud web de forma local, en el mismo contexto que esta regla.

```
Rule: {
    Name: "match_rule",
    Statement: {
        LabelMatchStatement: {
            Scope: "LABEL",
            Key: "header:encoding:utf8"
        }
    },
    RuleLabels: [
        ...generate_more_labels...
    ],
    Action: { Block: {} }
}
```

Si utiliza esta instrucción de coincidencia en la cuenta 111122223333, en una regla que defina para el paquete de protección (ACL web) `testWebACL`, coincidirá con las siguientes etiquetas. 

```
awswaf:111122223333:webacl:testWebACL:header:encoding:utf8
```

```
awswaf:111122223333:webacl:testWebACL:testNS1:testNS2:header:encoding:utf8
```

No coincidiría con la siguiente etiqueta, porque la cadena de la etiqueta no coincide exactamente.

```
awswaf:111122223333:webacl:testWebACL:header:encoding2:utf8
```

No coincidiría con la siguiente etiqueta porque el contexto no es el mismo, por lo que el prefijo no coincide. Esto es cierto, incluso si ha agregado el grupo de reglas `productionRules` al paquete de protección (ACL web) `testWebACL`, donde se define la regla. 

```
awswaf:111122223333:rulegroup:productionRules:header:encoding:utf8
```

## Comparación con una etiqueta de otro contexto
<a name="waf-rule-label-match-examples-label"></a>

La siguiente lista de JSON muestra una regla de coincidencia de etiquetas que coincide con una etiqueta de una regla de un grupo de reglas creado por el usuario. El prefijo es obligatorio en la especificación para todas las reglas que se ejecutan en el paquete de protección (ACL web) y que no forman parte del grupo de reglas mencionado. Esta especificación de etiqueta de ejemplo solo coincide con la etiqueta exacta. 

```
Rule: {
    Name: "match_rule",
    Statement: {
        LabelMatchStatement: {
            Scope: "LABEL",
            Key: "awswaf:111122223333:rulegroup:testRules:header:encoding:utf8"
        }
    },
    RuleLabels: [
        ...generate_more_labels...
    ],
    Action: { Block: {} }
}
```

## Comparación con una etiqueta de grupo de reglas administradas
<a name="waf-rule-label-match-examples-mgd-rg-label"></a>

Este es un caso especial de coincidencia con una etiqueta que proviene de un contexto diferente al de la regla de coincidencia. La siguiente lista de JSON muestra una instrucción de coincidencia de etiquetas para una etiqueta de grupo de reglas administradas. Solo coincide con la etiqueta exacta que se especifica en la configuración clave de la instrucción de coincidencia de etiquetas.

```
Rule: {
    Name: "match_rule",
    Statement: {
        LabelMatchStatement: {
            Scope: "LABEL",
            Key: "awswaf:managed:aws:managed-rule-set:header:encoding:utf8"
        }
    },
    RuleLabels: [
        ...generate_more_labels...
    ],
    Action: { Block: {} }
}
```

## Comparación con un espacio de nombres local
<a name="waf-rule-label-match-examples-local-namespace"></a>

La siguiente lista de JSON muestra una instrucción de coincidencia de etiquetas para un espacio de nombres local.

```
Rule: {
    Name: "match_rule",
    Statement: {
        LabelMatchStatement: {
            Scope: "NAMESPACE",
            Key: "header:encoding:"
        }
    },
    Labels: [
        ...generate_more_labels...
    ],
    Action: { Block: {} }
}
```

De forma similar a la coincidencia local `Label`, si usa esta instrucción en la cuenta 111122223333, en una regla que defina para el paquete de protección (ACL web) `testWebACL`, coincidirá con la siguiente etiqueta. 

```
awswaf:111122223333:webacl:testWebACL:header:encoding:utf8
```

No coincidiría con la siguiente etiqueta porque la cuenta no es la misma, por lo que el prefijo no coincide. 

```
awswaf:444455556666:webacl:testWebACL:header:encoding:utf8
```

El prefijo tampoco coincide con ninguna etiqueta aplicada por los grupos de reglas administradas, como las siguientes. 

```
awswaf:managed:aws:managed-rule-set:header:encoding:utf8
```

## Comparación con un nombre de espacio de un grupo de reglas administradas
<a name="waf-rule-label-match-examples-mgd-rg-namespace"></a>

La siguiente lista de JSON muestra una instrucción de coincidencia de etiquetas para un espacio de nombres de grupo de reglas administradas. En el caso de un grupo de reglas de su propiedad, también tendrá que proporcionar el prefijo para que coincida con un espacio de nombres que esté fuera del contexto de la regla. 

```
Rule: {
    Name: "match_rule",
    Statement: {
        LabelMatchStatement: {
            Scope: "NAMESPACE",
            Key: "awswaf:managed:aws:managed-rule-set:header:"
        }
    },
    RuleLabels: [
        ...generate_more_labels...
    ],
    Action: { Block: {} }
}
```

Esta especificación coincide con las siguientes etiquetas de ejemplo. 

```
awswaf:managed:aws:managed-rule-set:header:encoding:utf8
```

```
awswaf:managed:aws:managed-rule-set:header:encoding:unicode
```

No coincide con la siguiente etiqueta.

```
awswaf:managed:aws:managed-rule-set:query:badstring
```