使用字符串匹配条件 - AWS WAF、AWS Firewall Manager 和 AWS Shield Advanced

使用字符串匹配条件

警告

AWS WAF Classic 支持将于 2025 年 9 月 30 日结束。

注意

这是 AWS WAF Classic 文档。仅当 2019 年 11 月之前在 AWS WAF 中创建了 AWS WAF 资源(例如规则和 Web ACL),但尚未将这些资源迁移到最新版本时,才应使用此版本。要迁移您的 Web ACL,请参阅 将 AWS WAF Classic 资源迁移到 AWS WAF

有关 AWS WAF 的最新版本,请参阅 AWS WAF

如果要基于出现在请求中的字符串允许或阻止 Web 请求,请创建一个或多个字符串匹配条件。字符串匹配条件确定要搜索的字符串,以及 AWS WAF Classic 应对 Web 请求检查该字符串的部分(如指定标头或查询字符串)。在这个过程中的稍后阶段,在创建 Web ACL 时,需要指定是允许还是阻止包含该字符串的请求。

创建字符串匹配条件

创建字符串匹配条件时,需要指定筛选条件以确定要搜索的字符串,以及 AWS WAF Classic 应对 Web 请求检查该字符串的部分(如 URI 或查询字符串)。您可以将多个筛选条件添加到字符串匹配条件,也可以为每个筛选条件创建单独的字符串匹配条件。下面是每种配置影响 AWS WAF Classic 行为的方式:

  • 每个字符串匹配条件一个筛选条件:将单独的字符串匹配条件添加到一个规则并将该规则添加到 Web ACL 时,Web 请求必须与所有条件匹配,AWS WAF Classic 才会基于条件允许或阻止请求。

    例如,假设您创建两个条件。一个条件与 User-Agent 标头中包含值 BadBot 的 Web 请求匹配。另一个条件与查询字符串中包含值 BadParameter 的 Web 请求匹配。如果这两个条件添加到同一个规则并将该规则添加到 Web ACL,则仅当请求同时包含这两个值时,AWS WAF Classic 才会允许或阻止请求。

  • 每个字符串匹配条件多个筛选条件:将包含多个筛选条件的字符串匹配条件添加到一个规则并将该规则添加到 Web ACL 时,Web 请求只需与字符串匹配条件中的一个筛选条件匹配,AWS WAF Classic 即可基于一个条件允许或阻止请求。

    假设您创建一个而不是两个条件,并且这一个条件包含与前面示例相同的两个筛选条件。AWS WAF如果请求在 User-Agent 标头中包含 BadBot在查询字符串中包含 BadParameter,则 Classic 会允许或阻止请求。

注意

将字符串匹配条件添加到规则时,您还可以将 AWS WAF Classic 配置为允许或阻止与条件中的值匹配的 Web 请求。

创建字符串匹配条件
  1. 登录 AWS Management Console,然后打开 AWS WAF 控制台,网址为:https://console.aws.amazon.com/wafv2/

    如果您在导航窗格中看到切换到 AWS WAF Classic,请将其选中。

  2. 在导航窗格中,选择 String and regex matching

  3. 选择 创建条件

  4. 指定适用的筛选条件设置。有关更多信息,请参阅 创建或编辑字符串匹配条件时指定的值

  5. 选择 添加筛选条件

  6. 如果要添加其他筛选条件,请重复步骤 4 和 5。

  7. 添加完筛选器后,选择 创建

创建或编辑字符串匹配条件时指定的值

创建或更新字符串匹配条件时,需要指定以下值:

名称

为字符串匹配条件输入名称。该名称只能包含字母数字字符(A-Z、a-z、0-9)或以下特殊字符:_-!"#`+*},./。条件的名称在创建后不可更改。

类型

选择 String match

Part of the request to filter on

选择您希望 AWS WAF Classic 检查其中是否有要匹配的值中所指定字符串的每个 Web 请求部分:

标题

指定的请求标头,例如 User-AgentReferer 标头。如果选择 Header,则在 Header 字段中指定标头的名称。

HTTP method

HTTP 方法,指示请求要求源执行的操作的类型。CloudFront 支持以下方法:DELETEGETHEADOPTIONSPATCHPOSTPUT

查询字符串

URL 中在 ? 字符之后出现的部分 (如果有)。

URI

请求的 URI 路径,用于标识资源,例如 /images/daily-ad.jpg。这不包括 URI 的查询字符串或片段组件。有关信息,请参阅统一资源标识符 (URI):一般语法

除非指定了 转换,否则 URI 不会被标准化,并且会被检查,就像 AWS 是作为请求的一部分从客户端收到它一样。转换 将按指定方式重新设置 URI 的格式。

Body

请求中包含要作为 HTTP 请求正文发送到 Web 服务器的任何附加数据 (如表单数据) 的部分。

注意

如果选择正文作为要作为筛选条件的请求部分 的值,则 AWS WAF Classic 只检查前 8192 个字节 (8 KB)。要允许或阻止正文长度超过 8192 个字节的请求,可以创建大小约束条件。(AWS WAF Classic 会从请求标头获取正文的长度。) 有关更多信息,请参阅 使用大小约束条件

单一查询参数(仅限值)

您已定义为查询字符串的一部分的任何参数。例如,如果 URL 为“www.xyz.com?UserName=abc&SalesRegion=seattle”,您可以向 UserNameSalesRegion 参数添加一个筛选条件。

如果查询字符串中出现重复的参数,求出的值将为“OR”。也就是说,任一个值都将触发匹配。例如,在 URL“www.xyz.com?SalesRegion=boston&SalesRegion=seattle”中,要匹配的值 中无论是“boston”还是“seattle”,都会触发匹配。

如果您选择 单一查询参数(仅限值),您还将指定 查询参数名称。这是查询字符串中您将检查的参数,如 UserNameSalesRegion查询参数名称 的最大长度为 30 个字符。查询参数名称 不区分大小写。例如,如果您指定 UserName 作为 查询参数名称,这将匹配 UserName 的所有变体,如 usernameUsERName

所有查询参数(仅限值)

单一查询参数(仅限值)类似,但此处不是检查单一参数的值,而是 AWS WAF Classic 检查查询字符串中所有参数的值,以确定是否存在要匹配的值。例如,如果 URL 是“www.xyz.com?UserName=abc&SalesRegion=seattle”,并且您选择所有查询参数(仅限值),则当 UserNameSalesRegion 的值被指定为要匹配的值时,AWS WAF Classic 将触发匹配。

Header (仅当“Part of the request to filter on”是“Header”时)

如果您从要作为筛选条件的请求部分列表中选择标头,则从常见标头列表中选择标头,或输入您希望 AWS WAF Classic 检查的标头的名称。

Match type

在 AWS WAF Classic 应检查的请求部分中,选择要匹配的值中的字符串必须在哪个位置出现才与此筛选条件匹配:

包含

字符串在请求的指定部分中的任何位置出现。

Contains word

Web 请求的指定部分必须包含 要匹配的值,并且 要匹配的值 必须仅包含字母数字字符或下划线 (A-Z、a-z、0-9 或 _)。此外,要匹配的值 必须是单词,这表示以下一种情况:

  • 要匹配的值 与 Web 请求的指定部分的值精确匹配,如标头的值。

  • 要匹配的值 处于 Web 请求的指定部分的开头,并且后跟字母数字字符或下划线 (_) 之外的字符 (例如,BadBot;)。

  • 要匹配的值 处于 Web 请求的指定部分的末尾,并且前面是字母数字字符或下划线 (_) 之外的字符 (例如,;BadBot)。

  • 要匹配的值 处于 Web 请求的指定部分的中间,并且前面和后面是字母数字字符或下划线 (_) 之外的字符 (例如,-BadBot;)。

Exactly matches

字符串和请求的指定部分的值是相同的。

开始于

字符串出现在请求的指定部分的开头。

结束于

字符串出现在请求的指定部分的末尾。

Transformation

转换可在 AWS WAF Classic 检查 Web 请求之前重新格式化请求。这可消除一些不寻常的格式,可防范攻击者在 Web 请求中使用它们以试图绕过 AWS WAF Classic。

您只能指定一个类型的文本转换。

转换可以执行以下操作:

AWS WAF Classic 在针对要匹配的值中的字符串检查 Web 请求之前,不会对它执行任何文本转换。

转换为小写形式

AWS WAF Classic 将大写字母 (A-Z) 转换为小写字母 (a-z)。

HTML decode

AWS WAF Classic 将 HTML 编码的字符替换为未编码的字符:

  • " 替换为 &

  •   替换为不间断空格

  • &lt; 替换为 <

  • &gt; 替换为 >

  • 将以十六进制格式表示的字符 &#xhhhh; 替换为对应字符

  • 将以十进制格式表示的字符 &#nnnn; 替换为对应字符

规范化空格

AWS WAF Classic 将以下字符替换为空格字符(十进制 32):

  • \f,换页符,十进制 12

  • \t,制表符,十进制 9

  • \n,换行符,十进制 10

  • \r,回车符,十进制 13

  • \v,垂直制表符,十进制 11

  • 不间断空格,十进制 160

此外,此选项将多个空格替换为一个空格。

Simplify command line

如果您担心攻击者注入操作系统命令行命令并使用异常格式伪装部分或所有命令,使用此选项可执行以下转换:

  • 删除以下字符:\ " ' ^

  • 删除以下字符之前的空格:/ (

  • 将以下字符替换为空格:, ;

  • 将多个空格替换为一个空格

  • 将大写字母 (A-Z) 转换为小写字母 (a-z)

URL decode

解码 URL 编码的请求。

Value is base64 encoded

如果 要匹配的值 中的值进行了 base64 编码,则选中此复选框。使用 base64 编码可指定攻击者在其请求中包含的不可打印的字符 (如制表符和换行符)。

Value to match

指定 AWS WAF Classic 应在 Web 请求中搜索的值。最大长度为 50 个字节。如果要对值进行 base64 编码,则 50 字节的最大长度适用于编码之前的值。

在字符串匹配条件中添加和删除筛选条件

您可以将筛选条件添加到字符串匹配条件或删除筛选条件。要更改筛选条件,请添加一个新筛选条件并删除旧条件。

在字符串匹配条件中添加或删除筛选条件
  1. 登录 AWS Management Console,然后打开 AWS WAF 控制台,网址为:https://console.aws.amazon.com/wafv2/

    如果您在导航窗格中看到切换到 AWS WAF Classic,请将其选中。

  2. 在导航窗格中,选择 String and regex matching

  3. 选择要在其中添加或删除筛选条件的条件。

  4. 要添加筛选条件,请执行以下步骤:

    1. 选择 添加筛选条件

    2. 指定适用的筛选条件设置。有关更多信息,请参阅 创建或编辑字符串匹配条件时指定的值

    3. 选择添加

  5. 要删除筛选条件,请执行以下步骤:

    1. 选择要删除的筛选条件。

    2. 选择 删除筛选条件

删除字符串匹配条件

如果要删除某个字符串匹配条件,需要先删除该条件中的所有筛选条件,然后从使用该条件的所有规则中将其删除,如以下过程中所述。

删除字符串匹配条件
  1. 登录 AWS Management Console,然后打开 AWS WAF 控制台,网址为:https://console.aws.amazon.com/wafv2/

    如果您在导航窗格中看到切换到 AWS WAF Classic,请将其选中。

  2. 从使用某个字符串匹配条件的规则中删除该条件:

    1. 在导航窗格中,选择规则

    2. 选择使用要删除的字符串匹配条件的规则的名称。

    3. 在右窗格中,选择 编辑规则

    4. 选择要删除的条件旁边的 X

    5. 选择更新

    6. 对使用要删除的字符串匹配条件的所有其余规则重复这些步骤。

  3. 从要删除的条件中删除筛选条件:

    1. 在导航窗格中,选择 String and regex matching

    2. 选择要删除的字符串匹配条件的名称。

    3. 在右窗格中,选中 筛选条件 旁边的复选框来选择所有筛选条件。

    4. 选择 删除筛选器

  4. 在导航窗格中,选择 String and regex matching

  5. String and regex match conditions 窗格中,选择要删除的字符串匹配条件。

  6. 选择 删除 删除所选条件。