字串比對規則陳述式

字串比對陳述式會指出您要 AWS WAF 在請求中搜尋的字串、要在請求中搜尋的位置，以及如何搜尋。例如，您可以在請求中任何查詢字串的開頭尋找特定字串，或是在請求的 User-agent 標頭中尋找完全相符項目。通常，字串包含可列印 ASCII 字元，但您可以使用十六進位 0x00 到 0xFF 的任何字元 (小數 0 到 255)。

可形成巢狀— 您可以將此陳述式類型巢狀化。

WCU— 基本成本取決於您使用的比對類型。

• 完全符合字串—2

• 開頭字串—2

• 結尾字串—2

• 包含字串—10

• 包含的字—10

如果您使用請求組件所有查詢參數中，新增 10 個 WSU。如果您使用請求組件JSON 主體，則陳述式的基本成本 WSU 加倍。Flow Eat文字轉換，請新增 10 個 WSU。

此陳述式會在 Web 要求元件上運作，且需要下列要求元件設定：

• 請求元件— 要檢查的 Web 請求部分，例如查詢字串或本文。如需更多詳細資訊，請參閱 請求元件。

• 選用的文字轉換-你想要的轉換AWS WAF在檢查請求組件之前執行。例如，您可以轉換為小寫或標準化空格。如果您指定多於一個的轉換，則AWS WAF依序列出現在的順序列出現在日期。如需更多詳細資訊，請參閱 文字轉換。

此外，此陳述式需要下列設定：

• 要比對的字串— 這是您想要的字串AWS WAF與指定的請求元件比較。通常，字串包含可列印 ASCII 字元，但您可以使用十六進位 0x00 到 0xFF 的任何字元 (小數 0 到 255)。

• 字串比對條件— 這表示您想要的搜尋類型AWS WAF執行。

  • 完全符合字串— 字串和請求元件的數值相同。

  • 開頭字串— 該字串會出現在請求元件的開頭。

  • 結尾字串— 該字串會出現在請求元件的結尾。

  • 包含字串— 該字串會出現在請求元件中的任何位置。

  • 包含的字— 您指定的字串必須全出現在請求元件中。對於此選項，您指定的字串必須只包含英數字元或底線 (A-Z、a-z、0-9 或 _)。

    下列其中一項必須為 true，才能比對請求：

    • 該字串與請求元件的數值 (如標頭值) 完全相符。

    • 該字串位於請求元件的開頭，後面加上非英數字元或底線 (_) 的字元，例如 BadBot;。

    • 該字串位於請求元件的尾端，前面加上非英數字元或底線 (_) 的字元，例如 ;BadBot。

    • 該字串位於請求元件的中間，前後加上非英數字元或底線 (_) 的字元，例如 -BadBot;。

哪裡可以找到此項

• 規則建置器在控制台上 — 對於符合類型中，選擇字串比對條件，然後填入您要比對的字串。

• API 陳述式–ByteMatchStatement