Instruction de correspondance de chaîne de règle - AWS WAF, AWS Firewall Manager, et AWS Shield Advanced
Caractéristiques de l'énoncé des règlesOù trouver cette déclaration de règle

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.

Instruction de correspondance de chaîne de règle

Cette section explique ce qu'est une instruction de correspondance de chaîne et comment elle fonctionne.

Une instruction de correspondance de chaîne indique la chaîne que vous souhaitez AWS WAF à rechercher dans une demande, où dans la demande et comment. Par exemple, vous pouvez rechercher une chaîne spécifique au début de n'importe quelle chaîne de requête de la demande ou comme correspondance exacte pour l'en-tête User-agent de la demande. Généralement, la chaîne est composée de ASCII caractères imprimables, mais vous pouvez utiliser n'importe quel caractère, de l'hexadécimal 0x00 à 0xFF (décimal 0 à 255).

Caractéristiques de l'énoncé des règles

Imbriquable : vous pouvez imbriquer ce type de déclaration.

WCUs— Le coût de base dépend du type d'allumette que vous utilisez.

  • Correspond exactement à la chaîne — 2

  • Commence par une chaîne — 2

  • Se termine par une ficelle — 2

  • Contient une chaîne — 10

  • Contient le mot — 10

Si vous utilisez le composant de requête Tous les paramètres de requête, ajoutez 10WCUs. Si vous utilisez le JSONcorps du composant de demande, doublez le coût de baseWCUs. Pour chaque transformation de texte que vous appliquez, ajoutez 10WCUs.

Ce type d'instruction fonctionne sur un composant de requête Web et nécessite les paramètres de composant de demande suivants :

  • Composant de demande : partie de la requête Web destinée à inspecter, par exemple, une chaîne de requête ou le corps de la requête.

    Avertissement

    Si vous inspectez le corps, le JSONcorps, les en-têtes ou les cookies des composants de la demande, renseignez-vous sur les limites relatives à la quantité de contenu AWS WAF peut inspecter àGestion des composants de requête Web surdimensionnés dans AWS WAF.

    Pour plus d'informations sur les composants des requêtes Web, consultezRéglage des paramètres des instructions de règle dans AWS WAF.

  • Transformations de texte facultatives : transformations souhaitées AWS WAF à exécuter sur le composant de requête avant de l'inspecter. Par exemple, vous pouvez passer en minuscules ou normaliser les espaces blancs. Si vous spécifiez plusieurs transformations, AWS WAF les traite dans l'ordre indiqué. Pour plus d’informations, veuillez consulter Utilisation de transformations de texte dans AWS WAF.

En outre, cette instruction nécessite les paramètres suivants :

  • Chaîne à correspondre — Il s'agit de la chaîne que vous souhaitez AWS WAF à comparer au composant de demande spécifié. Généralement, la chaîne est composée de ASCII caractères imprimables, mais vous pouvez utiliser n'importe quel caractère, de l'hexadécimal 0x00 à 0xFF (décimal 0 à 255).

  • Condition de correspondance des chaînes — Cela indique le type de recherche que vous souhaitez AWS WAF à exécuter.

    • Correspond exactement à la chaîne — La chaîne et la valeur du composant de requête sont identiques.

    • Commence par une chaîne — La chaîne apparaît au début du composant de demande.

    • Se termine par une chaîne — La chaîne apparaît à la fin du composant de demande.

    • Contient une chaîne — La chaîne apparaît n'importe où dans le composant de demande.

    • Contient un mot : la chaîne que vous spécifiez doit apparaître dans le composant de demande.

      Pour cette option, les chaînes que vous spécifiez doivent contenir uniquement des caractères alphanumériques ou un trait de soulignement (A-Z, a-z, 0-9 ou _).

      L'un des éléments suivants doit être vrai pour que la demande corresponde :

      • La chaîne correspond exactement à la valeur du composant de demande, telle que la valeur d'un en-tête.

      • La chaîne est au début du composant de demande et est suivie par un caractère autre qu'un caractère alphanumérique ou un soulignement (_) : par exemple, BadBot;.

      • La chaîne est à la fin du composant de demande et est suivie par un caractère autre qu'un caractère alphanumérique ou un soulignement (_) : par exemple, ;BadBot.

      • La chaîne est au milieu du composant de demande et est précédée et suivie de caractères autre que des caractères alphanumériques ou de soulignement (_) : par exemple, -BadBot;.

Où trouver cette déclaration de règle

  • Générateur de règles sur la console : pour le type Match, choisissez String match condition, puis renseignez les chaînes que vous souhaitez comparer.

  • API – ByteMatchStatement