AWS WAF 標籤語法和命名需求 - AWS WAF、 AWS Firewall Manager、和 AWS Shield Advanced

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

AWS WAF 標籤語法和命名需求

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

  • 標籤區分大小寫。

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

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

  • 標籤的組件由冒號(:)分隔。

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

標籤語法

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

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

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

    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 處理序的標籤 — 這些程序會由 AWS Managed Rules 規則群組使用,因此您可以看到這些程序新增至您使用受管規則群組評估的 Web 要求中。以下顯示由受管規則群組呼叫的處理程序所建立之標籤的完整標籤語法。

    awswaf:managed:<process>:<custom namespace>:...:<label name>
    • 標籤命名空間前綴:awswaf:managed:<process>:

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

    此類型的標籤會針對呼叫 AWS 程序的受管規則群組列出。如需受管規則群組的相關資訊,請參閱 受管規則群組

標示規則的範例

下列範例標籤是由屬於帳戶 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