標籤語法和命名要求 AWS WAF - AWS WAFAWS Firewall Manager、 和 AWS Shield Advanced
標籤語法標示規則的範例受管規則群組的標籤範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

標籤語法和命名要求 AWS WAF

本節介紹如何構建和匹配 AWS WAF 標籤。

標籤是由前綴，可選命名空間和名稱組成的字符串。標籤的組件用冒號分隔。標籤具有以下要求和特點：

  • 標籤區分大小寫。

  • 每個標籤命名空間或標籤名稱最多可包含 128 個字元。

  • 您最多可以在標籤中指定五個命名空間。

  • 標籤的組件由冒號（:）分隔。

  • 您無法在為標籤指定的命名空間或名稱中使用下列保留字串：awswafawswaf、rulegroup、webacl、、regexpatternsetipset、和managed。

標籤語法

完整標籤具有前置詞、可選命名空間和標籤名稱。前置詞可識別新增標籤之規ACL則的規則群組或 Web 前後關聯。命名空間可用於為標籤添加更多上下文。標示名稱提供標示的最低詳細等級。它通常指出將標籤添加到請求的特定規則。

標示字首會根據其原點而有所不同。

  • 您的標籤 — 以下內容顯示您在 Web ACL 和規則群組規則中建立的標籤的完整標籤語法。實體類型為rulegroup和webacl。

    awswaf:<entity owner account id>:<entity type>:<entity name>:<custom namespace>:...:<label name>

    • 標籤命名空間前綴：awswaf:<entity owner account id>:<entity type>:<entity name>:

    • 自訂命名空間新增：<custom namespace>:…:

    當您在規則群組或 Web 中定義規則的標籤時ACL，您可以控制自訂命名空間字串和標籤名稱。其餘的是由您生成的 AWS WAF. AWS WAF 自動將所有標籤加上帳戶awswaf和 Web ACL 或規則群組實體設定的前綴。

  • 受管規則群組標籤 — 下列內容顯示由受管規則群組中規則所建立之標籤的完整標籤語法。

    awswaf:managed:<vendor>:<rule group name>:<custom namespace>:...:<label name>

    • 標籤命名空間前綴：awswaf:managed:<vendor>:<rule group name>:

    • 自訂命名空間新增：<custom namespace>:…:

    全部 AWS 受管規則規則群組新增標籤。如需受管規則群組的相關資訊，請參閱 使用受管規則群組 AWS WAF。

  • 來自其他的標籤 AWS 處理程序 — 這些處理程序由 AWS 受管規則群組，因此您可以看到這些群組新增至您使用受管規則群組評估的 Web 要求中。以下顯示由受管規則群組呼叫的處理程序所建立之標籤的完整標籤語法。

    awswaf:managed:<process>:<custom namespace>:...:<label name>

    • 標籤命名空間前綴：awswaf:managed:<process>:

    • 自訂命名空間新增：<custom namespace>:…:

    此類型的標籤會針對呼叫 AWS 過程。如需受管規則群組的相關資訊，請參閱 使用受管規則群組 AWS WAF。

標示規則的範例

下列範例標籤是由屬於帳戶 111122223333 testRules 的規則群組中的規則所定義。

awswaf:111122223333:rulegroup:testRules:testNS1:testNS2:LabelNameA
awswaf:111122223333:rulegroup:testRules:testNS1:LabelNameQ
awswaf:111122223333:rulegroup:testRules:LabelNameZ

下列清單顯示中的範例標籤規格JSON。這些標籤名稱在結尾標籤名稱之前包括自訂命名空間字串。

Rule: {
    Name: "label_rule",
    Statement: {...}
    RuleLabels: [
        Name: "header:encoding:utf8",
        Name: "header:user_agent:firefox"
    ],
    Action: { Count: {} }
}
注意

您可以在主控台中透過規則JSON編輯器存取此類型的刊登物品。

如果您在與上述標籤範例相同的規則群組和帳戶中執行前述規則，則產生的完全合格標籤將如下所示：

awswaf:111122223333:rulegroup:testRules:header:encoding:utf8
awswaf:111122223333:rulegroup:testRules:header:user_agent:firefox

受管規則群組的標籤範例

以下顯示範例來自的標籤 AWS 受管規則規則群組及其所呼叫的程序。

awswaf:managed:aws:core-rule-set:NoUserAgent_Header
awswaf:managed:aws:sql-database:SQLiExtendedPatterns_QueryArguments
awswaf:managed:aws:atp:aggregate:attribute:compromised_credentials
awswaf:managed:token:accepted