**Présentation d'une nouvelle expérience de console pour AWS WAF**

Vous pouvez désormais utiliser l'expérience mise à jour pour accéder aux AWS WAF fonctionnalités n'importe où dans la console. Pour plus de détails, consultez la section [Utilisation de la console](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-console.html). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation des conditions de correspondance d'expression régulière
<a name="classic-web-acl-regex-conditions"></a>

**Avertissement**  
AWS WAF Classic suit un end-of-life processus planifié. Consultez votre AWS Health tableau de bord pour connaître les étapes et les dates spécifiques à votre région.

**Note**  
Il s'agit d'une documentation **AWS WAF classique**. Vous ne devez utiliser cette version que si vous avez créé AWS WAF des ressources, telles que des règles et du Web ACLs, AWS WAF avant novembre 2019, et que vous ne les avez pas encore migrées vers la dernière version. Pour migrer votre site Web ACLs, consultez[Migration de vos ressources AWS WAF classiques vers AWS WAF](waf-migrating-from-classic.md).  
**Pour la dernière version de AWS WAF**, voir[AWS WAF](waf-chapter.md). 

Si vous souhaitez autoriser ou bloquer des demandes web basées sur les chaînes correspondant à un modèle d'expression régulière qui apparaissent dans les demandes, créez une ou plusieurs conditions de correspondance d'expression régulière. Une condition de correspondance regex est un type de condition de correspondance de chaîne qui identifie le modèle que vous souhaitez rechercher et la partie des requêtes Web, telle qu'un en-tête spécifié ou la chaîne de requête, que AWS WAF Classic doit inspecter pour détecter le modèle. Ultérieurement dans le processus, lorsque vous créez une liste ACL web, vous spécifiez s'il convient d'autoriser ou de bloquer les demandes qui contiennent le modèle.

**Topics**
+ [Création d'une condition de correspondance d'expression régulière](#classic-web-acl-regex-conditions-creating)
+ [Valeurs que vous spécifiez lorsque vous créez ou modifiez des conditions de RegEx correspondance](#classic-web-acl-regex-conditions-values)
+ [Modification d'une condition de correspondance d'expression régulière](#classic-web-acl-regex-conditions-editing)

## Création d'une condition de correspondance d'expression régulière
<a name="classic-web-acl-regex-conditions-creating"></a>

Lorsque vous créez des conditions de correspondance d'expression régulière, vous spécifiez les ensembles de modèle qui identifient la chaîne (à l'aide d'une expression régulière) que vous souhaitez rechercher. Vous ajoutez ensuite ces ensembles de modèles aux filtres qui spécifient la partie des requêtes Web que AWS WAF Classic doit inspecter pour ce jeu de modèles, telle que l'URI ou la chaîne de requête.

Vous pouvez ajouter plusieurs expressions régulières à un seul ensemble de modèles. Dans ce cas, ces expressions sont associées avec un *OR*. Ainsi, une demande web correspond à l'ensemble des modèles si la partie appropriée de la demande correspond à l'une des expressions répertoriées.

Lorsque vous ajoutez une condition de correspondance regex à une règle, vous pouvez également configurer AWS WAF Classic pour autoriser ou bloquer les requêtes Web qui *ne correspondent pas* aux valeurs de la condition.

AWS WAF Classic prend en charge la plupart des [expressions régulières compatibles Perl (PCRE) standard](http://www.pcre.org/). Cependant, les éléments suivants ne sont pas pris en charge :
+ Références arrières et capture de sous-expressions
+ Assertions arbitraires de largeur zéro
+ Références de sous-routines et modèles récursifs
+ Modèles conditionnels
+ Verbes de contrôle de suivi arrière
+ Directive octet unique \$1C
+ Directive de correspondance de nouvelle ligne \$1R
+ Début \$1K de directive de réinitialisation de correspondance
+ Légendes et code intégré
+ Regroupement atomique et quantificateurs possessifs<a name="classic-web-acl-regex-conditions-creating-procedure"></a>

**Pour créer une condition de correspondance d'expression régulière**

1. Connectez-vous à la AWS WAF console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/wafv2/](https://console.aws.amazon.com/wafv2/). 

   Si le **bouton Passer à la AWS WAF version classique** apparaît dans le volet de navigation, sélectionnez-le.

1. Dans le volet de navigation, sélectionnez **String and regex matching**.

1. Choisissez **Create condition**.

1. Indiquez les paramètres de filtre applicables. Pour de plus amples informations, veuillez consulter [Valeurs que vous spécifiez lorsque vous créez ou modifiez des conditions de RegEx correspondance](#classic-web-acl-regex-conditions-values).

1. Choisissez **Create pattern set and add filter** (si vous avez créé un nouvel ensemble de modèles) ou **Add filter** si vous avez utilisé un ensemble de modèles existant.

1. Choisissez **Créer**.

## Valeurs que vous spécifiez lorsque vous créez ou modifiez des conditions de RegEx correspondance
<a name="classic-web-acl-regex-conditions-values"></a>

Lorsque vous créez ou mettez à jour une condition de correspondance d'expression régulière, vous spécifiez les valeurs suivantes : 

**Nom**  
Saisissez un nom pour la condition de correspondance d'expression régulière. Le nom ne peut contenir que des caractères alphanumériques (A-Z, a-z, 0-9) ou les caractères spéciaux suivants : \$1-\$1"\$1`\$1\$1\$1,./. Vous ne pouvez pas modifier la nom d'une condition après l'avoir créée.

**Type**  
Choisissez **Regex match**.

**Partie de la requête à filtrer**  
Choisissez la partie de chaque requête Web que AWS WAF Classic doit inspecter pour déterminer le modèle que vous spécifiez dans **Value to match** :    
**En-tête**  
Un en-tête de requête spécifié, par exemple, l'en-tête `User-Agent` ou `Referer`. Si vous choisissez **Header**, précisez le nom de l'en-tête dans le champs **Header**.  
**Méthode HTTP**  
La méthode HTTP, qui indique le type d'opération que la requête demande à l'origine d'effectuer. CloudFront prend en charge les méthodes suivantes : `DELETE`, `GET`, `HEAD`, `OPTIONS`, `PATCH`, `POST` et `PUT`.  
**Chaîne de requête**  
La partie d'une URL qui s'affiche après un caractère `?`, le cas échéant.  
**URI**  
Le chemin URI de la demande, qui identifie la ressource, par exemple,`/images/daily-ad.jpg`. Cela n'inclut pas la chaîne de requête ou les composants du fragment de l'URI. Pour plus d'informations, voir [Uniform Resource Identifier (URI) : syntaxe générique](https://tools.ietf.org/html/rfc3986#section-3.3).   
À moins qu'une **transformation** ne soit spécifiée, un URI n'est pas normalisé et est inspecté au moment AWS où il est reçu du client dans le cadre de la demande. Une **Transformation** reformate l'URI comme spécifié.  
**Corps de texte**  
La partie d'une requête qui contient les données supplémentaires que vous souhaitez envoyer à votre serveur web en tant que corps de la requête HTTP, telles que les données d'un formulaire.  
Si vous choisissez **Body** pour la valeur d'**une partie de la demande à filtrer**, AWS WAF Classic inspecte uniquement les 8 192 premiers octets (8 Ko). Pour autoriser ou bloquer les demandes dont le corps est supérieur à 8 192 octets, vous pouvez créer une condition de contrainte de taille. (AWS WAF Classic obtient la longueur du corps à partir des en-têtes de requête.) Pour de plus amples informations, veuillez consulter [Utilisation des conditions de contrainte de taille](classic-web-acl-size-conditions.md).  
**Paramètre de requête unique (valeur uniquement)**  
Tous les paramètres que vous avez définis dans le cadre de la chaîne de requête. Par exemple, si l'URL est « www.xyz.com ? UserName =abc& SalesRegion =seattle », vous pouvez ajouter un filtre au paramètre or. *UserName*SalesRegion**   
Si les paramètres dupliqués apparaissent dans la chaîne de requête, les valeurs sont évaluées en tant que « OU ». Autrement dit, n'importe quelle valeur déclenchera une correspondance. Par exemple, dans l'URL « www.xyz.com ? SalesRegion =boston& SalesRegion =seattle », un modèle qui correspond à « boston » ou à « seattle » dans **Value** to match déclenchera une correspondance.  
Si vous choisissez **Single query parameter (value only) (Paramètre de requête unique (valeur uniquement))**, vous spécifierez également un **Query parameter name (Nom du paramètre de requête)**. Il s'agit du paramètre de la chaîne de requête que vous allez inspecter, tel que *UserName*ou *SalesRegion*. La longueur maximale de **Query parameter name (Nom du paramètre de requête)** est de 30 caractères. **Query parameter name (Nom du paramètre de requête)** n'est pas sensible à la casse. Par exemple, si vous spécifiez *UserName*comme **nom du paramètre Query**, celui-ci correspondra à toutes les variantes de *UserName*, telles que *username et *Us ERName**.  
**Tous les paramètres de requête (valeurs uniquement)**  
Semblable au **paramètre de requête unique (valeur uniquement)**, mais plutôt que d'inspecter la valeur d'un seul paramètre, AWS WAF Classic inspecte la valeur de tous les paramètres de la chaîne de requête afin de détecter le modèle spécifié dans la **valeur à mettre** en correspondance. Par exemple, dans l'URL « www.xyz.com ? UserName =abc& SalesRegion =seattle », un modèle dans **Value to match qui correspond à la valeur** contenue dans ou déclenchera une correspondance. *UserName*SalesRegion**

**En-tête (uniquement lorsque « Part of the request to filter on » est défini sur « Header »)**  
Si vous avez choisi **En-tête** **dans la partie de la demande à filtrer** dans la liste, choisissez un en-tête dans la liste des en-têtes courants ou entrez le nom d'un en-tête que AWS WAF Classic doit inspecter.

**Transformation**  
Une transformation reformate une requête Web avant que AWS WAF Classic ne l'inspecte. Cela élimine une partie du formatage inhabituel utilisé par les attaquants dans les requêtes Web dans le but de contourner AWS WAF Classic.   
Vous ne pouvez spécifier qu'un seul type de transformation de texte.  
Les transformations peuvent effectuer les opérations suivantes :    
**Aucune**  
AWS WAF Classic n'effectue aucune transformation de texte sur la requête Web avant de l'inspecter pour détecter la **correspondance de la chaîne dans Value**.  
**Convertir en minuscules**  
AWS WAF Classic convertit les lettres majuscules (A-Z) en minuscules (a-z).  
**Décodage d'HTML**  
AWS WAF Classic remplace les caractères codés en HTML par des caractères non codés :  
+ Remplace `&quot;` par `&`
+ Remplace `&nbsp;` par un espace insécable
+ Remplace `&lt;` par `<`
+ Remplace `&gt;` par `>`
+ Remplace les caractères qui sont représentées au format hexadécimal, `&#xhhhh;`, par les caractères correspondants
+ Remplace les caractères qui sont représentés au format décimal, `&#nnnn;`, par les caractères correspondants  
**Normalisation des espaces blancs**  
AWS WAF Classic remplace les caractères suivants par un espace (32 décimal) :  
+ \$1f, saut de page, décimale 12
+ \$1t, tabulation, décimale 9
+ \$1n, nouvelle ligne, décimale 10
+ \$1r, retour chariot, décimale 13
+ \$1v, tabulation verticale, décimale 11
+ Espace insécable, décimale 160
En outre, cette option remplace plusieurs espaces par un seul.  
**Simplifier la ligne de commande**  
Lorsque vous êtes préoccupé par le fait que des pirates puissent injecter une commande de ligne de commande du système d'exploitation et utilisent un formatage inhabituel pour masquer l'ensemble ou une partie de la commande, utilisez cette option pour effectuer les transformations suivantes :  
+ Supprimer les caractères suivants : \$1 " ' ^
+ Supprimer les espaces avant les caractères suivants : / (
+ Remplacer les caractères suivants par un espace : , ;
+ Remplacer plusieurs espaces par un espace
+ Convertit les lettres majuscules (A-Z) en lettres minuscules (a-z)  
**Décodage d'URL**  
Décoder une requête encodée par URL.

**Modèle d'expression régulière pour correspondre aux demandes**  
Vous pouvez choisir un ensemble de modèles existant ou en créer un. Si vous en créez un nouveau, spécifiez ce qui suit :    
Nouveau nom d'ensemble de modèles  
Entrez un nom, puis spécifiez le modèle d'expression régulière que vous souhaitez que AWS WAF Classic recherche.   
Si vous ajoutez plusieurs expressions régulières à un ensemble de modèles, ces expressions sont associées avec un *OR*. Ainsi, une demande web correspond à l'ensemble des modèles si la partie appropriée de la demande correspond à l'une des expressions répertoriées.  
La longueur maximale de **Value to match** est 70 caractères. 

## Modification d'une condition de correspondance d'expression régulière
<a name="classic-web-acl-regex-conditions-editing"></a>

Vous pouvez apporter les modifications suivantes à une condition de correspondance d'expression régulière existante :
+ Supprimer un modèle à partir d'un ensemble de modèles existant
+ Ajouter un modèle à un ensemble de modèles existant
+ Supprimer un filtre d'une condition de correspondance d'expression régulière existante
+ Ajoutez un filtre à une condition de correspondance regex existante (vous ne pouvez avoir qu'un seul filtre dans une condition de correspondance regex. Par conséquent, pour ajouter un filtre, vous devez d'abord supprimer le filtre existant.)
+ Supprimer une condition de correspondance d'expression régulière existante

**Note**  
Vous ne pouvez pas ajouter un ensemble de modèles à un filtre existant ou l'en supprimer. Vous devez modifier l'ensemble de modèles, ou supprimer le filtre et créer un nouveau filtre avec un nouvel ensemble de modèles.<a name="classic-web-acl-regex-conditions-editing-procedure-delete-pattern"></a>

**Pour supprimer un modèle d'un ensemble de modèles existant**

1. Connectez-vous à la AWS WAF console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/wafv2/](https://console.aws.amazon.com/wafv2/). 

   Si le **bouton Passer à la AWS WAF version classique** apparaît dans le volet de navigation, sélectionnez-le.

1. Dans le volet de navigation, sélectionnez **String and regex matching**.

1. Choisissez **View regex pattern sets**.

1. Choisissez le nom de l'ensemble de modèles que vous voulez modifier.

1. Choisissez **Modifier**.

1. Choisissez le **X** en regard du modèle que vous voulez supprimer.

1. Choisissez **Enregistrer**.<a name="classic-web-acl-regex-conditions-editing-procedure-add-pattern"></a>

**Pour ajouter un modèle à un ensemble de modèles existant**

1. Connectez-vous à la AWS WAF console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/wafv2/](https://console.aws.amazon.com/wafv2/). 

   Si le **bouton Passer à la AWS WAF version classique** apparaît dans le volet de navigation, sélectionnez-le.

1. Dans le volet de navigation, sélectionnez **String and regex matching**.

1. Choisissez **View regex pattern sets**.

1. Choisissez le nom de l'ensemble de modèles à modifier.

1. Choisissez **Modifier**.

1. Saisissez un nouveau modèle d'expression régulière.

1. Choisissez le **\$1** en regard du nouveau modèle.

1. Choisissez **Enregistrer**.<a name="classic-web-acl-regex-conditions-editing-procedure-delete-filter"></a>

**Pour supprimer un filtre d'une condition de correspondance d'expression régulière existante**

1. Connectez-vous à la AWS WAF console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/wafv2/](https://console.aws.amazon.com/wafv2/). 

   Si le **bouton Passer à la AWS WAF version classique** apparaît dans le volet de navigation, sélectionnez-le.

1. Dans le volet de navigation, sélectionnez **String and regex matching**.

1. Choisissez le nom de la condition associée au filtre que vous souhaitez supprimer.

1. Cochez la case en regard du filtre que vous voulez supprimer.

1. Choisissez **Delete filter**.<a name="classic-web-acl-regex-conditions-editing-procedure-delete-regex-condition"></a>

**Pour supprimer une condition de correspondance d'expression régulière**

1. Connectez-vous à la AWS WAF console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/wafv2/](https://console.aws.amazon.com/wafv2/). 

   Si le **bouton Passer à la AWS WAF version classique** apparaît dans le volet de navigation, sélectionnez-le.

1. Supprimez le filtre de la condition regex. Pour plus d'instructions, consultez [Pour supprimer un filtre d'une condition de correspondance d'expression régulière existante](#classic-web-acl-regex-conditions-editing-procedure-delete-filter).)

1. Supprimez la condition de correspondance d'expression régulière des règles qui l'utilisent :

   1. Dans le panneau de navigation, choisissez **Rules**.

   1. Choisissez le nom d'une règle qui utilise la condition de correspondance d'expression régulière que vous souhaitez supprimer.

   1. Dans le volet droit, choisissez **Edit rule**.

   1. Choisissez le **X** en regard de la condition que vous voulez supprimer.

   1. Choisissez **Mettre à jour**.

   1. Répétez les étapes pour toutes les autres règles qui utilisent la condition de correspondance d'expression régulière que vous souhaitez supprimer.

1. Dans le volet de navigation, sélectionnez **String and regex matching**.

1. Sélectionnez le bouton en regard de la condition que vous voulez supprimer.

1. Sélectionnez **Delete (Supprimer)**.<a name="classic-web-acl-regex-conditions-editing-procedure-add-filter"></a>

**Pour ajouter un filtre à une condition de correspondance d'expression régulière existante ou le modifier**

Vous pouvez n'avoir qu'un seul filtre dans une condition de correspondance d'expression régulière. Si vous souhaitez ajouter ou modifier le filtre, vous devez d'abord supprimer le filtre existant.

1. Connectez-vous à la AWS WAF console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/wafv2/](https://console.aws.amazon.com/wafv2/). 

   Si le **bouton Passer à la AWS WAF version classique** apparaît dans le volet de navigation, sélectionnez-le.

1. Supprimez le filtre de la condition d'expression régulière que vous voulez modifier. Pour plus d'instructions, consultez [Pour supprimer un filtre d'une condition de correspondance d'expression régulière existante](#classic-web-acl-regex-conditions-editing-procedure-delete-filter).)

1. Dans le volet de navigation, sélectionnez **String and regex matching**.

1. Choisissez le nom de la condition que vous voulez modifier.

1. Choisissez **Add filter**.

1. Entrez les valeurs appropriées pour le nouveau filtre et choisissez **Add**.