Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

引入全新的主机体验 Amazon WAF

现在，您可以使用更新的体验访问控制台中任意位置的 Amazon WAF 功能。有关更多详细信息，请参阅使用控制台。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

动态标签插值

动态标签插值允许您使用${namespace:}语法将标签值直接嵌入到自定义请求标头、自定义响应标头和自定义响应正文中。 Amazon WAF 在评估时会根据附加到请求的标签解析每个占位符，因此您不必为每个标签值编写单独的规则。

插值可在现有 Amazon WAF API 中运行，无需新字段或配置步骤。您可以在现有字符串值中使用占位符语法。现有的静态标头值继续保持不变。只有当值包含子句时，插值才会激活。${namespace:}

支持插值的地方

可以在以下${namespace:}位置使用插值：

插值语法和分辨率

要使用插值，请在标头值或自定义响应正文内容中包含${namespace:}子句。结尾的冒号很重要。它告诉 Amazon WAF 要解析该命名空间中的所有标签，而不是从字面上匹配单个标签。

Amazon WAF 使用以下规则在评估时解析每个子句：

合成标签

插值还支持合成标签。这些是从请求上下文而不是标签存储中 Amazon WAF 解析的内置值。可以在同一个值字符串中将合成标签和基于命名空间的标签组合在一起。

动态标签插值示例

使用动态标头发送应用程序信号

以下规则将多个 Bot Control 信号命名空间作为单独的标题转发到您的源。一条规则涵盖整个命名空间，因此当托管规则组添加新标签时，您无需更新规则。

{
  "Name": "forward-waf-signals",
  "Statement": {
    "LabelMatchStatement": {
      "Scope": "NAMESPACE",
      "Key": "awswaf:managed:aws:bot-control:bot:category:"
    }
  },
  "RuleAction": {
    "Count": {
      "CustomRequestHandling": {
        "InsertHeaders": [
          { "Name": "bot-category",
            "Value": "${awswaf:managed:aws:bot-control:bot:category:}" },
          { "Name": "bot-name",
            "Value": "${awswaf:managed:aws:bot-control:bot:name:}" },
          { "Name": "bot-signals",
            "Value": "${awswaf:managed:aws:bot-control:signal:}" },
          { "Name": "client-ip",
            "Value": "${awswaf:ip:}" }
        ]
      }
    }
  }
}

bot-signals标题（输出:x-amzn-waf-bot-signals）演示了多值分辨率。例如，signal:命名空间可能包含多个标签non_browser_user_agent,automated_browser，这些标签解析为逗号分隔的列表。client-ip标题（输出:x-amzn-waf-client-ip）使用合成标签。

包含调试信息的自定义区块页面

合成标签允许您构建包含特定请求上下文的区块页面。将客户的 IP 地址和 Amazon WAF 请求 ID 直接嵌入到响应正文中，以便在用户报告误报时向他们提供一些可以分享的内容。

{
  "CustomResponseBodies": {
    "BlockPage": {
      "Content": "Your request was blocked.\n\nIP: ${awswaf:ip:}\nRequest ID: ${awswaf:request_id:}\n\nIf you believe this is an error, contact support with the Request ID above.",
      "ContentType": "TEXT_PLAIN"
    }
  }
}

自定义标签插值

插值适用于任何标签命名空间，包括您在自己的规则中定义的自定义标签。以下示例按照 API 密钥对请求进行分类，并将等级值转发给源。

规则 1：根据 API 密钥对等级进行分类

此规则将请求与企业 API 密钥进行匹配并应用自定义标签。

{
{
  "Name": "classify-tier",
  "Priority": 100,
  "Statement": {
    "ByteMatchStatement": {
      "SearchString": "pk_enterprise_",
      "FieldToMatch": { "SingleHeader": { "Name": "x-api-key" } },
      "PositionalConstraint": "STARTS_WITH",
      "TextTransformations": [{ "Priority": 0, "Type": "NONE" }]
    }
  },
  "RuleLabels": [{ "Name": "app:tier:enterprise" }],
  "Action": { "Count": {} }
}

}

规则 2：转发已解决的等级值

此规则匹配app:tier命名空间中的任何标签，并将已解析的值作为标题转发。

{
{
  "Name": "forward-tier",
  "Priority": 200,
  "Statement": {
    "LabelMatchStatement": {
      "Scope": "NAMESPACE",
      "Key": "app:tier:"
    }
  },
  "Action": {
    "Count": {
      "CustomRequestHandling": {
        "InsertHeaders": [{
          "Name": "customer-tier",
          "Value": "${awswaf:ACCOUNT_ID:webacl:WEBACL_NAME:app:tier:}"
        }]
      }
    }
  }
}

第一条规则应用标签app:tier:enterprise。第二条规则匹配app:tier命名空间中的任何标签，并将已解析的值作为customer-tier标题转发。输出标头名称为x-amzn-waf-customer-tier。您可以为其他等级添加更多分类规则，例如app:tier:standard或app:tier:trial。转发规则在不做任何更改的情况下接收它们。

有关演示所有这些模式的可部署示例，请参阅上的 “Amazon WAF 动态标签插值” 示例。 GitHub