Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

將 AWS WAF 與 Google SecOps 整合

本文說明如何將 AWS WAF 與 Google Security Operations (Google SecOps) 整合。

用途

AWS WAF 整合功能可讓您執行下列操作，保護網頁應用程式：

自動封鎖 IP：自動將 Google SecOps 偵測到的惡意 IP 位址新增至 AWS WAF IP 集，在網路邊緣封鎖流量。
管理存取控管清單 (ACL)：動態建立及更新 Web ACL，因應新興威脅。
統籌全域和區域安全性：透過單一介面管理區域資源 (例如 ALB) 和全域資源 (Amazon CloudFront) 的規則。

整合參數

請使用下列參數設定整合：

參數顯示名稱類型預設值為必填說明

AWS 存取金鑰 ID 字串不適用是要在整合中使用的 AWS 存取金鑰 ID。

AWS Secret Key 密碼不適用是要在整合中使用的 AWS Secret。

AWS 預設區域

字串

不適用

是

參數顯示名稱	類型	預設值	為必填	說明
AWS 存取金鑰 ID	字串	不適用	是	要在整合中使用的 AWS 存取金鑰 ID。
AWS Secret Key	密碼	不適用	是	要在整合中使用的 AWS Secret。
AWS 預設區域	字串	不適用	是	整合時使用的 AWS 預設區域，例如 us-west-2。 AWS WAF 中的 `Regional` 範圍會對應到此處設定的區域。`CloudFront` 範圍為全域，不依賴這個區域，但在 `Regional` 下建立的資源範圍會限定為這個值。如要管理多個 AWS 區域的 AWS WAF 資源，您必須為每個區域設定獨立的整合執行個體。

整合時使用的 AWS 預設區域，例如 us-west-2。

AWS WAF 中的 Regional 範圍會對應到此處設定的區域。CloudFront 範圍為全域，不依賴這個區域，但在 Regional 下建立的資源範圍會限定為這個值。

如要管理多個 AWS 區域的 AWS WAF 資源，您必須為每個區域設定獨立的整合執行個體。

如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」。

如有需要，您可以在後續階段進行變更。設定整合執行個體後，即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「在工作區回應待處理動作」和「在案件中執行手動動作」。

乒乓

測試與 AWS WAF 的連線。

參數

不適用

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功：「已使用提供的連線參數成功連線至 AWS WAF 伺服器！」動作應失敗並停止執行應對手冊：如果未成功：「無法連線至 AWS WAF 伺服器！錯誤為 {0}".format(exception.stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功：「已使用提供的連線參數成功連線至 AWS WAF 伺服器！」

動作應失敗並停止執行應對手冊：

如果未成功：「無法連線至 AWS WAF 伺服器！錯誤為 {0}".format(exception.stacktrace)

一般

建立 IP 集

根據實體在 AWS WAF 中建立 IP 集。

IP 集的建立格式如下：

Siemplify_NAME_IP Type`

參數

參數顯示名稱	類型	預設值	為必填	說明
名稱	字串	不適用	是	指定 IP 集的名稱。注意：這項動作會建立 IP 集，格式如下：Siemplify_{Name}_{IP Type}。名稱長度必須介於 1 到 128 個字元之間，有效字元：A-Z、a-z、0-9、- (連字號) 和 _ (底線)。
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定建立 IP 集的範圍。如果選取「Both」，這項動作會在區域和 Amazon CloudFront 範圍內建立 IP 集。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
說明	字串	不適用	否	指定 IP 集的說明。
標記	CSV	不適用	否	請指定要新增至 IP 集的其他標記。格式：key_1:value_1,key_2:value_1。

執行日期

這項動作會對 IP 位址實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
"Regional": ["IPv4_set", "IPv6_set"]
"Cloudfront":  ["IPv4_set", "IPv6_set"]
}

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一個提供的實體用於建立 IP 集 (is_success = true)： "Successfully created {0} {1} IP Set '{2}' in AWS WAF with the following IPs: \n {3}".format("Regional"/"Cloudfront", "IPv4"/"IPv6", full_name, entity.identifier list) If fail to use specific entities(is_success = true): "Action was not able to use the following IPs in order to create AWS WAF IP Set\n: {0}".format([entity.identifier]) 如果無法使用所有實體 (is_success = false)：「未建立任何 IP 集。原因：提供的 IP 實體皆無效。如果所有集合都已存在 (is_success=false)，或只有部分集合已存在 (is_success=true)： "The following {0} IP Pattern Sets '{1}' already exist: \n.".format("Regional/CloudFront", list_of_full_names) 動作應失敗並停止執行應對手冊：如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『建立 IP 集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一個提供的實體用於建立 IP 集 (is_success = true)： "Successfully created {0} {1} IP Set '{2}' in AWS WAF with the following IPs: \n {3}".format("Regional"/"Cloudfront", "IPv4"/"IPv6", full_name, entity.identifier list)

If fail to use specific entities(is_success = true): "Action was not able to use the following IPs in order to create AWS WAF IP Set\n: {0}".format([entity.identifier])

如果無法使用所有實體 (is_success = false)：「未建立任何 IP 集。原因：提供的 IP 實體皆無效。

如果所有集合都已存在 (is_success=false)，或只有部分集合已存在 (is_success=true)： "The following {0} IP Pattern Sets '{1}' already exist: \n.".format("Regional/CloudFront", list_of_full_names)

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『建立 IP 集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

將 IP 新增至 IP 集

將 IP 位址新增至 AWS WAF 的 IP 集。

參數

參數顯示名稱類型預設值為必填說明

IP 集名稱 CSV 不適用是指定以半形逗號分隔的 IP 集名稱清單。範例：name_1,name_2

範圍

DDL

參數顯示名稱	類型	預設值	為必填	說明
IP 集名稱	CSV	不適用	是	指定以半形逗號分隔的 IP 集名稱清單。範例：name_1,name_2
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定 IP 集的範圍。如果選取「兩者」，這項動作會將 IP 位址新增至 `Regional` 和 `CloudFront` 範圍內的 IP 集。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

是

指定 IP 集的範圍。如果選取「兩者」，這項動作會將 IP 位址新增至 Regional 和 CloudFront 範圍內的 IP 集。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

執行日期

這項動作會對 IP 位址實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一個 IP 位址新增至一個 IP 集(is_success = true)：「已成功將下列 IP 新增至 AWS WAF 中的 {0} IP 集 '{1}'：\n {2}」。format("Regional"/"Cloudfront", full_name, entity.identifier list) 如果無法將特定實體新增至其中一個 IP 集(is_success = true)： "Action was not able to add the following IPs to the {0} IP Set '{1}' in AWS WAF\n: {2}".format("Regional"/"Cloudfront", full_name,[entity.identifier]) 如果找不到其中一個 IP 集 (is_success = true)：「動作在 AWS WAF 中找不到下列『{0}』IP 集：\n {1}」。format("Regional"/Cloudfront",list of IP sets that were not found in that scope) 如果在所選範圍內找不到所有提供的 IP 集 (is_success=false)：「動作找不到提供的 IP 集。」動作應失敗並停止執行應對手冊：如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『將 IP 新增至 IP 集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一個 IP 位址新增至一個 IP 集(is_success = true)：「已成功將下列 IP 新增至 AWS WAF 中的 {0} IP 集 '{1}'：\n {2}」。format("Regional"/"Cloudfront", full_name, entity.identifier list)

如果無法將特定實體新增至其中一個 IP 集(is_success = true)： "Action was not able to add the following IPs to the {0} IP Set '{1}' in AWS WAF\n: {2}".format("Regional"/"Cloudfront", full_name,[entity.identifier])

如果找不到其中一個 IP 集 (is_success = true)：「動作在 AWS WAF 中找不到下列『{0}』IP 集：\n {1}」。format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

如果在所選範圍內找不到所有提供的 IP 集 (is_success=false)：「動作找不到提供的 IP 集。」

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『將 IP 新增至 IP 集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

建立規則運算式模式集

根據實體，在 AWS WAF 中建立規則運算式模式集。

每個規則運算式模式集只能包含 10 個模式，且總共只能有 10 個規則運算式模式集。

參數

參數顯示名稱	類型	預設值	為必填	說明
名稱	字串	不適用	是	指定規則運算式模式集的名稱。注意：名稱長度必須介於 1 到 128 個字元之間。有效字元：A-Z、a-z、0-9、- (連字號) 和 _ (底線)。
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定建立規則運算式模式集的範圍。如果選取「Both」，這項動作會在 `Regional` 和 `CloudFront` 範圍內建立規則運算式模式集。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
說明	字串	不適用	否	指定規則運算式模式集的說明。
標記	CSV	不適用	否	指定應新增至規則運算式模式集的其他標記。格式：key_1:value_1,key_2:value_1。
網域模式	核取方塊	已勾選	否	如果啟用，這項動作會從網址中擷取網域部分，並根據這些部分建立規則運算式模式，例如將 `http://test.com/folder` 轉換為 `^(http\|https)(:\/\/)(\Qtest.com\E).*".format(entity)`。
IP 模式	核取方塊	已勾選	否	如果啟用，這項動作會根據 IP 位址建構適當的規則運算式模式，而不是使用原始值，例如將 `10.0.0.1` 轉換為 `^(http\|https)(:\/\/)(\Q10.0.1\E).*".format(entity)`。

執行日期

這項動作會對下列實體執行：

IP 位址
網址

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
"Regional": "Regex_set"
"Cloudfront": "Regex_set"
}

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少使用一個提供的實體建立規則運算式集 (is_success = true)： "Successfully created {0} Regex Pattern Set '{1}' in AWS WAF with the following entities: \n {2}".format("Regional"/"Cloudfront", name, entity.identifier list) 如果用於建立規則運算式模式集的實體超過 10 個：「由於超過上限，動作無法使用所有提供的實體建立規則運算式模式集。已略過下列實體：{0}".format(entity.identifier) 如果 Set Already exists (is_success=false)： "{0} Regex Pattern Set '{1}' already exists.".format("Regional/CloudFront", name) 動作應失敗並停止執行應對手冊：如果是致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『建立規則運算式模式集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少使用一個提供的實體建立規則運算式集 (is_success = true)： "Successfully created {0} Regex Pattern Set '{1}' in AWS WAF with the following entities: \n {2}".format("Regional"/"Cloudfront", name, entity.identifier list)

如果用於建立規則運算式模式集的實體超過 10 個：「由於超過上限，動作無法使用所有提供的實體建立規則運算式模式集。已略過下列實體：{0}".format(entity.identifier)

如果 Set Already exists (is_success=false)： "{0} Regex Pattern Set '{1}' already exists.".format("Regional/CloudFront", name)

動作應失敗並停止執行應對手冊：

如果是致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『建立規則運算式模式集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

建立網路 ACL

在 AWS WAF 中建立 Web ACL。

參數

參數顯示名稱	類型	預設值	為必填	說明
名稱	字串	不適用	是	指定 Web ACL 的名稱。注意：名稱長度必須介於 1 至 128 個字元之間。有效字元：A-Z、a-z、0-9、- (連字號) 和 _ (底線)。
規則來源類型	DDL	IP 集可能的值 IP 集規則群組	是	指定要使用的規則類型。
規則來源名稱	字串	不適用	是	指定來源名稱，用於 Web ACL。如果「規則來源類型」為「IP 集」，這項動作會搜尋該名稱的 IP 集。如果「規則來源類型」是「規則群組」，這項動作會搜尋該名稱的規則群組。
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定建立 Web ACL 的範圍。如果選取「兩者」，這項動作會在 `Regional` 和 `CloudFront` 範圍內建立網路 ACL。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
啟用取樣要求	核取方塊	已取消勾選	是	如果啟用，AWS WAF 會儲存符合規則的網頁要求樣本。
啟用 CloudWatch 指標	核取方塊	已取消勾選	是	啟用後，相關聯的資源會將指標傳送至 CloudWatch。
CloudWatch 指標名稱	核取方塊	已取消勾選	是	指定 CloudWatch 指標的名稱。注意：名稱長度必須介於 1 至 128 個字元之間。有效字元：A-Z、a-z、0-9、- (連字號) 和 _ (底線)。
預設動作	DDL	允許可能的值包括：允許封鎖	是	針對不符合任何規則的要求，指定預設動作。
IP 集動作	DDL	封鎖可能的值：允許封鎖數量	否	為以 IP 集為基礎的規則指定動作。
規則優先權	整數	不適用	是	指定規則的優先順序。網路 ACL 中的優先順序不得重複。
說明	字串	不適用	否	指定網路 ACL 的說明。
標記	CSV	不適用	否	請指定應新增至網路 ACL 的其他標記。格式：key_1:value_1,key_2:value_1。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

JSON 結果

{
"Regional": "Web_Acl_name"
"Cloudfront": "Web_Acl_name"
}

案件總覽

結果類型值/說明類型

輸出訊息*

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Both」：「已成功在 `Regional` 和 `CloudFront` 範圍建立 Web ACL {0}。」.format(name) 如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Regional」：「Successfully created Web ACL {0} in Regional.」.format(name) 如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Cloudfront」：「Successfully created Web ACL {0} in Cloudfront scope.」.format(name) 如果網路 ACL 存在：列印「The Web ACL {} already exists in {} scope.」.format(web ACL name, scope)。如果找不到 IP 集/規則群組：「Action wasn't able to create Web ACL. 原因：在 AWS WAF 中找不到 {0}「{1}」".format("IP 集/規則群組", 規則來源名稱) 動作應失敗並停止執行應對手冊：如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器) 或其他錯誤：「執行『建立 Web ACL』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

動作不應失敗，也不應停止執行應對手冊：

如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Both」：「已成功在 Regional 和 CloudFront 範圍建立 Web ACL {0}。」.format(name)

如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Regional」： 「Successfully created Web ACL {0} in Regional.」.format(name)

如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Cloudfront」：「Successfully created Web ACL {0} in Cloudfront scope.」.format(name)

如果網路 ACL 存在：

列印「The Web ACL {} already exists in {} scope.」.format(web ACL name, scope)。

如果找不到 IP 集/規則群組：「Action wasn't able to create Web ACL. 原因：在 AWS WAF 中找不到 {0}「{1}」".format("IP 集/規則群組", 規則來源名稱)

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器) 或其他錯誤：「執行『建立 Web ACL』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

在 Web ACL 中新增規則

在 AWS WAF 中，根據 IP 集或規則群組，將規則新增至 Web ACL。網路 ACL 最多可包含 1,500 項規則。

參數

參數顯示名稱	類型	預設值	為必填	說明
網路 ACL 名稱	CSV	不適用	是	請指定以半形逗號分隔的網路 ACL 名稱清單。範例：name_1,name_2
規則來源類型	DDL	IP 集可能的值包括： IP 集規則群組	是	指定要使用的規則類型。
規則來源名稱	字串	不適用	是	指定來源名稱，用於 Web ACL。如果「規則來源類型」為「IP 集」，這項動作會搜尋該名稱的 IP 集。如果「規則來源類型」是「規則群組」，這項動作會搜尋該名稱的規則群組。
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定新規則的範圍。如果選取「兩者」，這項動作會在 `Regional` 和 `CloudFront` 範圍內，將規則新增至網路 ACL。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
規則優先權	整數	不適用	是	指定規則的優先順序。網路 ACL 中的優先順序不得重複。
IP 集動作	DDL	封鎖可能的值：允許封鎖數量	否	為以 IP 集為基礎的規則指定動作。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一項規則新增至一個 Web ACL(is_success = true)：「已成功將規則新增至 AWS WAF 中的下列 {0} Web ACL：'{1}'。」.format("Regional"/"Cloudfront", list of name) 如果找不到其中一個 Web ACL(is_success = true)：「Action wasn't able to find the following '{0}' Web ACLs in the AWS WAF:\n {1}".format("Regional"/Cloudfront", list of Web ACLs that were not found in that scope) 如果範圍內每個 Web ACL 已有名稱相同的規則 (is_success=true)：「動作無法將 {0} 規則新增至 AWS WAF 中的 Web ACL。原因：下列 Web ACL 中已有「{1}」{0}：\n{2}".format( rule source type, rule source name, list Web ACL with scope - structure {0} - {1}.format(scope, web acl name)) 動作應失敗並停止執行應對手冊：如果是致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『將規則新增至網路 ACL』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一項規則新增至一個 Web ACL(is_success = true)：「已成功將規則新增至 AWS WAF 中的下列 {0} Web ACL：'{1}'。」.format("Regional"/"Cloudfront", list of name)

如果找不到其中一個 Web ACL(is_success = true)：「Action wasn't able to find the following '{0}' Web ACLs in the AWS WAF:\n {1}".format("Regional"/Cloudfront", list of Web ACLs that were not found in that scope)

如果範圍內每個 Web ACL 已有名稱相同的規則 (is_success=true)：「動作無法將 {0} 規則新增至 AWS WAF 中的 Web ACL。原因：下列 Web ACL 中已有「{1}」{0}：\n{2}".format( rule source type, rule source name, list Web ACL with scope - structure {0} - {1}.format(scope, web acl name))

動作應失敗並停止執行應對手冊：

如果是致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『將規則新增至網路 ACL』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

建立規則群組

在 AWS WAF 中建立規則群組。

參數

參數顯示名稱	類型	預設值	為必填	說明
名稱	字串	不適用	是	指定規則群組的名稱。注意：名稱長度必須介於 1 至 128 個字元之間。有效字元：A-Z、a-z、0-9、- (連字號) 和 _ (底線)。
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定規則群組的建立範圍。如果選取「兩者」，這項動作會在 `Regional` 和 `CloudFront` 範圍內建立規則群組。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
容量	整數	100	是	指定規則群組的容量。注意：群組建立後，就無法變更容量。上限為 1500。
啟用取樣要求	核取方塊	已取消勾選	是	如果啟用，AWS WAF 會儲存符合規則的網頁要求樣本。
啟用 CloudWatch 指標	核取方塊	已取消勾選	是	啟用後，相關聯的資源會將指標傳送至 CloudWatch。
CloudWatch 指標名稱	核取方塊	已取消勾選	是	指定 CloudWatch 指標的名稱。注意：名稱長度必須介於 1 至 128 個字元之間。有效字元：A-Z、a-z、0-9、- (連字號) 和 _ (底線)。
說明	字串	不適用	否	指定規則群組的說明。
標記	CSV	不適用	否	指定要新增至規則群組的其他標記。格式：key_1:value_1,key_2:value_1。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型值/說明類型

輸出訊息*

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功列出可用的 IP 集(is_success = true) 且「範圍」==「兩者」：「已成功在 `Regional` 和 `CloudFront` 範圍中建立規則群組 {0}。」.format(name) >如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Regional」：「The Rule Group {} already exists in {} scope.」.format(web ACL name, scope)。 If successfully listed available IP Sets(is_success = true) and "Scope" == "Cloudfront": "Successfully created Rule Group {0} in Cloudfront scope.".format(name) 如果規則群組存在： "Successfully created Rule Group {0} in Cloudfront scope.".format(name) 如果無法建立規則群組："Action was not able to create Rule Group {} in {} scope".format(web ACL name, scope)。動作應失敗並停止執行應對手冊：如果是致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『建立規則群組』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般

動作不應失敗，也不應停止執行應對手冊：

如果成功列出可用的 IP 集(is_success = true) 且「範圍」==「兩者」：「已成功在 Regional 和 CloudFront 範圍中建立規則群組 {0}。」.format(name)

>如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Regional」：「The Rule Group {} already exists in {} scope.」.format(web ACL name, scope)。

If successfully listed available IP Sets(is_success = true) and "Scope" == "Cloudfront": "Successfully created Rule Group {0} in Cloudfront scope.".format(name)

如果規則群組存在： "Successfully created Rule Group {0} in Cloudfront scope.".format(name)

如果無法建立規則群組："Action was not able to create Rule Group {} in {} scope".format(web ACL name, scope)。

動作應失敗並停止執行應對手冊：

如果是致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『建立規則群組』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

將實體新增至規則運算式模式集

根據實體，將字串模式新增至 AWS WAF 中的規則運算式模式集。

每個規則運算式模式集只能包含 10 個模式。

參數

參數顯示名稱	類型	預設值	為必填	說明
規則運算式模式集名稱	CSV	不適用	是	指定以半形逗號分隔的規則運算式模式集名稱清單，例如 `name_1,name_2`。
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	規則運算式模式集的範圍。如果選取「Both」，這項動作會根據實體，將模式新增至 `Regional` 和 `CloudFront` 範圍內的規則運算式模式集。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
網域模式	核取方塊	已勾選	否	啟用後，這項動作會從網址中擷取網域部分，並根據這些部分建立規則運算式模式，例如將 `http://test.com/folder` 轉換為 `^(http\|https)(:\/\/)(\Qtest.com\E).*".format(entity)`。
IP 模式	核取方塊	已勾選	否	如果啟用，這項動作會根據 IP 位址建構適當的規則運算式模式，而不是使用原始值，例如將 `10.0.0.1` 轉換為 `^(http\|https)(:\/\/)(\Q10.0.1\E).*".format(entity)`。

執行日期

這項動作會對下列實體執行：

IP 位址
網址

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一個實體新增至一個規則運算式模式集(is_success = true)：「已成功將下列實體模式新增至 AWS WAF 中的 {0} 規則運算式模式集『{1}』：\n {2}」。format("Regional"/"Cloudfront", name, list of entity patterns) 如果用於建立規則運算式模式集的實體超過 10 個：「動作無法根據所有提供的實體，將模式新增至『{0}』規則運算式模式集『{1}』，因為已超出上限。已略過下列實體：{2}".forma("Regional"/"Cloudfront", name, entity.identifier) 如果找不到其中一個集合 (is_success = true)：「Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope) 如果在所選範圍內找不到所有提供的組合 (is_success=false)：「動作找不到提供的規則運算式模式組合。」動作應失敗並停止執行應對手冊： if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add Entity To Regex Pattern Set". 原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一個實體新增至一個規則運算式模式集(is_success = true)：「已成功將下列實體模式新增至 AWS WAF 中的 {0} 規則運算式模式集『{1}』：\n {2}」。format("Regional"/"Cloudfront", name, list of entity patterns)

如果用於建立規則運算式模式集的實體超過 10 個：「動作無法根據所有提供的實體，將模式新增至『{0}』規則運算式模式集『{1}』，因為已超出上限。已略過下列實體：{2}".forma("Regional"/"Cloudfront", name, entity.identifier)

如果找不到其中一個集合 (is_success = true)：「Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope)

如果在所選範圍內找不到所有提供的組合 (is_success=false)：「動作找不到提供的規則運算式模式組合。」

動作應失敗並停止執行應對手冊：

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Add Entity To Regex Pattern Set". 原因：{0}''.format(error.Stacktrace)

一般

將模式新增至規則運算式模式集

在 AWS WAF 的規則運算式模式集中新增字串模式。

每個規則運算式模式集只能包含 10 個模式。

參數

參數顯示名稱類型預設值為必填說明

規則運算式模式集名稱 CSV 不適用是指定以半形逗號分隔的規則運算式模式集名稱清單，例如 name_1,name_2。

模式 CSV 不適用是指定要新增至規則運算式模式集的模式清單 (以半形逗號分隔)，例如 pattern_1,pattern_2。

範圍

DDL

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

是

規則運算式模式集的範圍。如果選取「Both」，這項動作會根據實體，將模式新增至 Regional 和 CloudFront 範圍內的規則運算式模式集。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項	範例
is_success	True/False	is_success:False

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一個模式新增至一個規則運算式模式集(is_success = true)："Successfully added the following patterns to the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", name, list of patterns) 如果找不到其中一組 (is_success = true)：t "Action wasn't able to find the following '{0}' 規則運算式 Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope). 如果在所選範圍內找不到所有提供的組合 (is_success=false)：「動作找不到提供的規則運算式模式組合。」動作應失敗並停止執行應對手冊：如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器)，或其他錯誤：「執行『將模式新增至規則運算式模式集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一個模式新增至一個規則運算式模式集(is_success = true)："Successfully added the following patterns to the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", name, list of patterns)

如果找不到其中一組 (is_success = true)：t "Action wasn't able to find the following '{0}' 規則運算式 Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of regular expression pattern sets that were not found in that scope).

如果在所選範圍內找不到所有提供的組合 (is_success=false)：「動作找不到提供的規則運算式模式組合。」

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器)，或其他錯誤：「執行『將模式新增至規則運算式模式集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

從網路 ACL 移除規則

從 AWS WAF 的網路 ACL 移除規則。

參數

參數顯示名稱類型預設值為必填說明

網路 ACL 名稱

CSV

是

參數顯示名稱	類型	預設值	為必填	說明
網路 ACL 名稱	CSV		是	請指定以半形逗號分隔的網路 ACL 名稱清單。範例：name_1,name_2
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定移除網路 ACL 的範圍。如果選取「兩者」，這項操作會移除 `Regional` 和 `CloudFront` 範圍中的 Web ACL。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
規則名稱	字串	不適用	是	指定要刪除的規則名稱。

請指定以半形逗號分隔的網路 ACL 名稱清單。範例：name_1,name_2

範圍

DDL

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

是

指定移除網路 ACL 的範圍。如果選取「兩者」，這項操作會移除 Regional 和 CloudFront 範圍中的 Web ACL。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

規則名稱

字串

不適用

是

指定要刪除的規則名稱。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一項規則從一個規則群組中移除：列印「Successfully removed a rule from the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names) 如果一個規則群組失敗：列印「動作無法從 AWS WAF 的下列 {0} 網路 ACL「{1}」中移除規則。」.format("Regional"/"Cloudfront", list of names) if unsuccessful for one Web ACL, because rule wasn't found in one ACL: print "Action wasn't able to find the specified rule in the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names Web ACL) 如果找不到其中一個規則群組：列印「動作無法在 AWS WAF 中找到下列『{0}』Web ACL：\n {1}」。format("Regional"/Cloudfront", list of Rule Group that were not found in that scope) 如果在所需範圍內找不到所有提供的組合：列印「動作找不到提供的網路 ACL」。動作應失敗並停止執行應對手冊： if fatal error, SDK error, like wrong credentials, no connection to server, other: print "Error executing action "Remove Rule From Web ACL". 原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一項規則從一個規則群組中移除：列印「Successfully removed a rule from the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names)

如果一個規則群組失敗：列印「動作無法從 AWS WAF 的下列 {0} 網路 ACL「{1}」中移除規則。」.format("Regional"/"Cloudfront", list of names)

if unsuccessful for one Web ACL, because rule wasn't found in one ACL: print "Action wasn't able to find the specified rule in the following {0} Web ACLs '{1}' in AWS WAF.".format("Regional"/"Cloudfront", list of names Web ACL)

如果找不到其中一個規則群組：列印「動作無法在 AWS WAF 中找到下列『{0}』Web ACL：\n {1}」。format("Regional"/Cloudfront", list of Rule Group that were not found in that scope)

如果在所需範圍內找不到所有提供的組合：列印「動作找不到提供的網路 ACL」。

動作應失敗並停止執行應對手冊：

if fatal error, SDK error, like wrong credentials, no connection to server, other: print "Error executing action "Remove Rule From Web ACL". 原因：{0}''.format(error.Stacktrace)

一般

列出 Web ACL

列出 AWS WAF 中可用的網路 ACL。

參數

參數顯示名稱類型預設值為必填說明

範圍

DDL

參數顯示名稱	類型	預設值	為必填	說明
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用		指定網路 ACL 清單的範圍。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
要傳回的 Web ACL 數量上限	整數	50	否	指定要傳回的網路 ACL 數量。預設值為 50。上限為 100。

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

指定網路 ACL 清單的範圍。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

要傳回的 Web ACL 數量上限整數 50 否指定要傳回的網路 ACL 數量。預設值為 50。上限為 100。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

JSON 結果

[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]

案件總覽

結果類型	值/說明	類型 (實體 \ 一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功列出可用的 IP 集，且「範圍」==「兩者」：「已成功列出區域和 Cloudfront 範圍內可用的 Web ACL。」如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Regional」：「成功列出區域範圍內可用的 Web ACL。」如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Cloudfront」：「已成功列出 Cloudfront 範圍內可用的 Web ACL。」如果沒有可用值(is_success = false) 且「Scope」==「Both」：「在區域和 Cloudfront 範圍內找不到可用的 Web ACL。」如果沒有可用值 (is_success = false) 且「Scope」==「Regional」：「在區域範圍內找不到可用的 Web ACL。」如果沒有可用值(is_success = false) 且「Scope」==「Cloudfront」：「在 Cloudfront 範圍內找不到可用的 Web ACL。」動作應失敗並停止執行應對手冊： if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Web ACLs". 原因：{0}''.format(error.Stacktrace)	一般
案件總覽表格 (如果「範圍」==「區域」或「兩者」)	資料表名稱：區域規則 ACL 表格欄：名稱 ID 說明鎖定權杖 ARN	一般
案件總覽表格 (如果「Scope」==「CloudFront」或「Both」)	資料表名稱：CloudFront 規則 ACL 表格欄：名稱 ID 說明鎖定權杖 ARN	一般

結果類型

值/說明

類型 (實體 \ 一般)

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功列出可用的 IP 集，且「範圍」==「兩者」：「已成功列出區域和 Cloudfront 範圍內可用的 Web ACL。」

如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Regional」：「成功列出區域範圍內可用的 Web ACL。」

如果成功列出可用的 IP 集(is_success = true) 且「Scope」==「Cloudfront」：「已成功列出 Cloudfront 範圍內可用的 Web ACL。」

如果沒有可用值(is_success = false) 且「Scope」==「Both」：「在區域和 Cloudfront 範圍內找不到可用的 Web ACL。」

如果沒有可用值 (is_success = false) 且「Scope」==「Regional」：「在區域範圍內找不到可用的 Web ACL。」

如果沒有可用值(is_success = false) 且「Scope」==「Cloudfront」：「在 Cloudfront 範圍內找不到可用的 Web ACL。」

動作應失敗並停止執行應對手冊：

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Web ACLs". 原因：{0}''.format(error.Stacktrace)

一般

案件總覽表格

(如果「範圍」==「區域」或「兩者」)

資料表名稱：區域規則 ACL

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

案件總覽表格

(如果「Scope」==「CloudFront」或「Both」)

資料表名稱：CloudFront 規則 ACL

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

從規則群組中移除規則

從 AWS WAF 的規則群組中移除規則。

參數

參數顯示名稱類型預設值為必填說明

規則群組名稱 CSV 是指定規則群組名稱清單 (以半形逗號分隔)。範例：name_1,name_2

範圍

DDL

參數顯示名稱	類型	預設值	為必填	說明
規則群組名稱	CSV		是	指定規則群組名稱清單 (以半形逗號分隔)。範例：name_1,name_2
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定規則群組的移除範圍。如果選取「兩者」，這項動作會移除 `Regional` 和 `CloudFront` 範圍中的規則群組。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
規則名稱	字串	不適用	是	指定要刪除的規則名稱。

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

是

指定規則群組的移除範圍。如果選取「兩者」，這項動作會移除 Regional 和 CloudFront 範圍中的規則群組。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

規則名稱

字串

不適用

是

指定要刪除的規則名稱。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一項規則從一個規則群組中移除：「已成功從 AWS WAF 的下列 {0} 規則群組『{1}』中移除規則。」.format("Regional"/"Cloudfront", list of names) 如果無法移除一個規則群組：「動作無法從 AWS WAF 的下列 {0} 規則群組『{1}』中移除規則。」.format("Regional"/"Cloudfront", list of names) 如果因在某個規則群組中找不到規則，導致該規則群組執行失敗：「動作無法在 AWS WAF 的下列 {0} 規則群組『{1}』中找到指定規則。」.format("Regional"/"Cloudfront", list of rule group names) 如果找不到其中一個規則群組：「動作無法在 AWS WAF 中找到下列『{0}』規則群組：\n {1}」。format("Regional"/Cloudfront", list of Rule Group that were not found in that scope) 如果在所需範圍內找不到所有提供的組合：「動作找不到提供的規則群組。」動作應失敗並停止執行應對手冊：如果系統回報致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『從規則群組中移除規則』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一項規則從一個規則群組中移除：「已成功從 AWS WAF 的下列 {0} 規則群組『{1}』中移除規則。」.format("Regional"/"Cloudfront", list of names)

如果無法移除一個規則群組：「動作無法從 AWS WAF 的下列 {0} 規則群組『{1}』中移除規則。」.format("Regional"/"Cloudfront", list of names)

如果因在某個規則群組中找不到規則，導致該規則群組執行失敗：「動作無法在 AWS WAF 的下列 {0} 規則群組『{1}』中找到指定規則。」.format("Regional"/"Cloudfront", list of rule group names)

如果找不到其中一個規則群組：「動作無法在 AWS WAF 中找到下列『{0}』規則群組：\n {1}」。format("Regional"/Cloudfront", list of Rule Group that were not found in that scope)

如果在所需範圍內找不到所有提供的組合：「動作找不到提供的規則群組。」

動作應失敗並停止執行應對手冊：

如果系統回報致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『從規則群組中移除規則』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

列出規則群組

列出 AWS WAF 中的可用規則群組。

參數

參數顯示名稱類型預設值為必填說明

範圍

DDL

參數顯示名稱	類型	預設值	為必填	說明
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用		指定規則群組清單的範圍。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
要傳回的規則群組數量上限	整數	50	否	指定要傳回的規則群組數量。預設值為 50。上限為 100。

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

指定規則群組清單的範圍。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

要傳回的規則群組數量上限整數 50 否指定要傳回的規則群組數量。預設值為 50。上限為 100。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

JSON 結果

[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]

案件總覽

結果類型	值/說明	類型 (實體 \ 一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功列出可用的 IP 集，且「Scope」==「Both」：「Successfully listed available Rule groups in Regional and Cloudfront scopes.」如果成功列出可用的 IP 集，且「範圍」==「區域」：「已成功列出區域範圍內可用的規則群組。」 If successfully listed available IP Sets and "Scope" == "Cloudfront": "Successfully listed available Rule groups in Cloudfront scope."> 如果沒有可用值，且「Scope」==「Both」：「在區域和 Cloudfront 範圍中找不到可用的規則群組。」如果沒有可用值，且「Scope」==「Regional」：「在區域範圍內找不到可用的規則群組。」如果沒有可用值，且「範圍」==「Cloudfront」：「在 Cloudfront 範圍內找不到可用的規則群組。」動作應失敗並停止執行應對手冊：如果系統回報致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『列出規則群組』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般
Case Wall Table (如果「範圍」==「區域」或「兩者」)	資料表名稱：區域規則群組表格欄：名稱 ID 說明鎖定權杖 ARN	一般
Case Wall Table (如果「Scope」==「CloudFront」或「Both」)	資料表名稱：CloudFront 規則群組表格欄：名稱 ID 說明鎖定權杖 ARN	一般

結果類型

值/說明

類型 (實體 \ 一般)

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功列出可用的 IP 集，且「Scope」==「Both」：「Successfully listed available Rule groups in Regional and Cloudfront scopes.」

如果成功列出可用的 IP 集，且「範圍」==「區域」：「已成功列出區域範圍內可用的規則群組。」

If successfully listed available IP Sets and "Scope" == "Cloudfront": "Successfully listed available Rule groups in Cloudfront scope.">

如果沒有可用值，且「Scope」==「Both」：「在區域和 Cloudfront 範圍中找不到可用的規則群組。」

如果沒有可用值，且「Scope」==「Regional」：「在區域範圍內找不到可用的規則群組。」

如果沒有可用值，且「範圍」==「Cloudfront」：「在 Cloudfront 範圍內找不到可用的規則群組。」

動作應失敗並停止執行應對手冊：

如果系統回報致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『列出規則群組』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

Case Wall Table

(如果「範圍」==「區域」或「兩者」)

資料表名稱：區域規則群組

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

Case Wall Table

(如果「Scope」==「CloudFront」或「Both」)

資料表名稱：CloudFront 規則群組

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

列出 IP 集

列出 AWS WAF 中可用的 IP 集。

參數

參數顯示名稱類型預設值為必填說明

範圍

DDL

參數顯示名稱	類型	預設值	為必填	說明
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用		指定 IP 集清單的範圍。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
要傳回的 IP 集數量上限	整數	50	否	指定要傳回的 IP 集數量。預設值為 50。上限為 100。

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

指定 IP 集清單的範圍。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

要傳回的 IP 集數量上限整數 50 否指定要傳回的 IP 集數量。預設值為 50。上限為 100。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

JSON 結果

[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]

案件總覽

結果類型	值/說明	類型 (實體 \ 一般)
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功列出可用的 IP 集，且「Scope」==「Both」：「Successfully listed available IP sets in Regional and Cloudfront scopes.」如果成功列出可用的 IP 集，且「Scope」==「Regional」：「已成功列出區域範圍內可用的 IP 集。」如果成功列出可用的 IP 集，且「Scope」==「Cloudfront」：「已成功列出 Cloudfront 範圍內可用的 IP 集。」如果沒有可用值，且「Scope」==「Both」：列印「在區域和 Cloudfront 範圍中找不到可用的 IP 集」。如果沒有可用值，且「Scope」==「Regional」：「在區域範圍內找不到可用的 IP 集。」如果沒有可用值，且「Scope」==「Cloudfront」：「在 Cloudfront 範圍內找不到可用的 IP 集。」動作應失敗並停止執行應對手冊：如果系統回報致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「Error executing action "List IP Sets". 原因：{0}''.format(error.Stacktrace)	一般
Case Wall Table (如果「範圍」==「區域」或「兩者」)	資料表名稱：區域規則群組表格欄：名稱 ID 說明鎖定權杖 ARN	一般
Case Wall Table (如果「Scope」==「CloudFront」或「Both」)	資料表名稱：CloudFront 規則群組表格欄：名稱 ID 說明鎖定權杖 ARN	一般

結果類型

值/說明

類型 (實體 \ 一般)

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功列出可用的 IP 集，且「Scope」==「Both」：「Successfully listed available IP sets in Regional and Cloudfront scopes.」

如果成功列出可用的 IP 集，且「Scope」==「Regional」：「已成功列出區域範圍內可用的 IP 集。」

如果成功列出可用的 IP 集，且「Scope」==「Cloudfront」：「已成功列出 Cloudfront 範圍內可用的 IP 集。」

如果沒有可用值，且「Scope」==「Both」：列印「在區域和 Cloudfront 範圍中找不到可用的 IP 集」。

如果沒有可用值，且「Scope」==「Regional」：「在區域範圍內找不到可用的 IP 集。」

如果沒有可用值，且「Scope」==「Cloudfront」：「在 Cloudfront 範圍內找不到可用的 IP 集。」

動作應失敗並停止執行應對手冊：

如果系統回報致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「Error executing action "List IP Sets". 原因：{0}''.format(error.Stacktrace)

一般

Case Wall Table

(如果「範圍」==「區域」或「兩者」)

資料表名稱：區域規則群組

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

Case Wall Table

(如果「Scope」==「CloudFront」或「Both」)

資料表名稱：CloudFront 規則群組

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

從規則運算式模式集移除模式

從 AWS WAF 的規則運算式組合中移除模式。

參數

參數顯示名稱類型預設值為必填說明

規則運算式模式集名稱 CSV 是指定以半形逗號分隔的規則運算式集名稱清單，例如 name_1,name_2。

模式 CSV 是指定要從規則運算式集中移除的模式清單 (以半形逗號分隔)，例如 pattern_1,pattern_2。

範圍

DDL

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

是

組合的範圍。如果選取「Both」，這項動作會從 Regional 和 CloudFront 範圍的規則運算式組合中移除模式。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一個模式集從一個 regex 集移除：「Successfully removed the following patterns from the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}」。format("Regional"/"Cloudfront", full_name, list of entity patterns) 如果模式從未存在於該模式集中： "The following patterns were not found in the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of patterns) 如果無法移除所有規則運算式模式集中的所有模式：「未從提供的規則運算式模式集中移除任何模式。」如果找不到其中一個模式集：「Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of sets that were not found in that scope) 如果在指定範圍內找不到所有提供的規則運算式模式組合：「動作找不到提供的規則運算式模式組合。」動作應失敗並停止執行應對手冊：如果系統回報嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『從規則運算式模式集移除模式』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一個模式集從一個 regex 集移除：「Successfully removed the following patterns from the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}」。format("Regional"/"Cloudfront", full_name, list of entity patterns)

如果模式從未存在於該模式集中： "The following patterns were not found in the {0} Regex Pattern Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, list of patterns)

如果無法移除所有規則運算式模式集中的所有模式：「未從提供的規則運算式模式集中移除任何模式。」

如果找不到其中一個模式集：「Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of sets that were not found in that scope)

如果在指定範圍內找不到所有提供的規則運算式模式組合：「動作找不到提供的規則運算式模式組合。」

動作應失敗並停止執行應對手冊：

如果系統回報嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『從規則運算式模式集移除模式』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

從 IP 集移除 IP

從 AWS WAF 的 IP 集移除 IP 位址。

參數

參數顯示名稱類型預設值為必填說明

IP 集名稱 CSV 是指定以半形逗號分隔的 IP 集名稱清單。範例：name_1,name_2

範圍

DDL

參數顯示名稱	類型	預設值	為必填	說明
IP 集名稱	CSV		是	指定以半形逗號分隔的 IP 集名稱清單。範例：name_1,name_2
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	指定 IP 集的範圍。如果選取「兩者」，這項動作會從 `Regional` 和 `CloudFront` 範圍的 IP 集移除 IP 位址。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

是

指定 IP 集的範圍。如果選取「兩者」，這項動作會從 Regional 和 CloudFront 範圍的 IP 集移除 IP 位址。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

執行日期

這項動作會對 IP 實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

案件總覽

結果類型	值/說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果成功，且至少有一個 IP 位址從一個 IP 集移除：「Successfully removed the following IPs from the {0} IP Set '{1}' in AWS WAF: \n {2}」。format("Regional"/"Cloudfront", full_name, entity.identifier list) 如果 IP 從未存在於該 IP 集： "The following IPs were not a part of the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list) 如果無法移除所有 IP 集中的所有實體：「未從提供的 IP 集中移除任何 IP。」如果找不到其中一個 IP 集：P "Action wasn't able to find the following '{0}' IP Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope) 如果在所需範圍內找不到所有提供的 IP 集：「動作找不到提供的 IP 集。」動作應失敗並停止執行應對手冊：如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)，系統會回報：「Error executing action "Remove IP From IP Set". 原因：{0}''.format(error.Stacktrace)	一般

結果類型

值/說明

類型

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一個 IP 位址從一個 IP 集移除：「Successfully removed the following IPs from the {0} IP Set '{1}' in AWS WAF: \n {2}」。format("Regional"/"Cloudfront", full_name, entity.identifier list)

如果 IP 從未存在於該 IP 集： "The following IPs were not a part of the {0} IP Set '{1}' in AWS WAF: \n {2}".format("Regional"/"Cloudfront", full_name, entity.identifier list)

如果無法移除所有 IP 集中的所有實體：「未從提供的 IP 集中移除任何 IP。」

如果找不到其中一個 IP 集：P "Action wasn't able to find the following '{0}' IP Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

如果在所需範圍內找不到所有提供的 IP 集：「動作找不到提供的 IP 集。」

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)，系統會回報：「Error executing action "Remove IP From IP Set". 原因：{0}''.format(error.Stacktrace)

一般

列出規則運算式模式集

列出 AWS WAF 中可用的規則運算式集。

參數

參數顯示名稱類型預設值為必填說明

範圍

DDL

參數顯示名稱	類型	預設值	為必填	說明
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用		指定 IP 集清單的範圍。
要傳回的規則運算式模式集數量上限	整數	5	否	指定要傳回的規則運算式組合數量。預設值為 5。最多 10 個。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。

CloudFront

可能的值包括：

CloudFront
區域
兩者並用

指定 IP 集清單的範圍。

要傳回的規則運算式模式集數量上限

整數

否

指定要傳回的規則運算式組合數量。預設值為 5。最多 10 個。

CloudFront 是與 Amazon CloudFront 搭配使用的資源全域範圍。Regional 是指在 AWS Default Region 整合參數中設定的特定 AWS 區域。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

JSON 結果

[
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]
"CloudFront": [
    {
        "Name": "example",
        "Id": "ID",
        "Description": "example",
        "LockToken": "7e76581b-f152-4448-aafe-b733a33c8fa2",
        "ARN": "arn:aws:wafv2:us-east-1:regional/ipset/example/ID"
    }
]

案件總覽

結果類型

值/說明

類型 (實體 \ 一般)

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功列出可用的 Regex 集，且「範圍」==「兩者」：「已成功列出區域和 Cloudfront 範圍內可用的 Regex 模式集。」

如果成功列出可用的 IP 集，且「Scope」==「Regional」：「Successfully listed available Regex Pattern sets in Regional scope.」

如果成功列出可用的 IP 集，且「Scope」==「Cloudfront」：「已成功列出 Cloudfront 範圍內可用的規則運算式模式集。」

如果沒有可用值，且「Scope」==「Both」：「在區域和 Cloudfront 範圍中找不到可用的規則運算式模式集。」

如果沒有可用值，且「Scope」==「Regional」：「在區域範圍內找不到可用的規則運算式模式集。」

如果沒有可用值，且「Scope」==「Cloudfront」：「在 Cloudfront 範圍內找不到可用的規則運算式模式集。」

動作應失敗並停止執行應對手冊：

如果系統回報致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『列出規則運算式模式集』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

Case Wall Table

(如果「範圍」==「區域」或「兩者」)

資料表名稱：區域規則群組

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

Case Wall Table

(如果「Scope」==「CloudFront」或「Both」)

資料表名稱：CloudFront 規則群組

表格欄：

名稱
ID
說明
鎖定權杖
ARN

一般

從規則運算式模式集移除實體

從 AWS WAF 的規則運算式集中，移除以實體為基礎的字串模式。

參數

參數顯示名稱	類型	預設值	為必填	說明
規則運算式模式集名稱	CSV		是	指定以半形逗號分隔的規則運算式集名稱清單，例如 `name_1,name_2`。
範圍	DDL	CloudFront 可能的值包括： CloudFront 區域兩者並用	是	設定範圍。如果選取「Both」，則會根據 `Regional` 和 `CloudFront` 範圍內規則運算式組合中的實體，移除模式。 `CloudFront` 是與 Amazon CloudFront 搭配使用的資源全域範圍。`Regional` 是指在 `AWS Default Region` 整合參數中設定的特定 AWS 區域。
網域模式	核取方塊	是	否	啟用後，這項動作會從網址擷取網域部分，並在規則運算式集中搜尋以該部分為基礎的規則運算式，例如 `http://test.com/folder` 會變成 `^(http\|https)(:\/\/)(\Qtest.com\E).*`。
IP 模式	核取方塊	是	否	如果啟用，動作會搜尋 IP 位址的規則運算式，而非原始值，例如 `10.0.0.1` 變成 `^(http\|https)(:\/\/)(\Q10.0.1\E).*`。

執行日期

這項動作會對下列實體執行：

IP 位址
網址

動作執行結果

指令碼執行結果

指令碼執行結果名稱	值選項
is_success	is_success=False
is_success	is_success=True

案件總覽

結果類型

值/說明

類型 (實體 \ 一般)

輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

如果成功，且至少有一個實體從一個 IP 集移除：「已成功從 AWS WAF 的 {0} 規則運算式模式集『{1}』中移除下列實體模式：\n {2}」。format("Regional"/"Cloudfront", full_name, list of entity patterns)

如果實體從未存在於該 Regex 模式集中：「在 AWS WAF 的 {0} Regex 模式集『{1}』中找不到下列模式：\n {2}」。format("Regional"/"Cloudfront", full_name, list of entity patterns)

如果無法移除所有 IP 集中的所有實體：「未從提供的規則運算式模式集中移除任何模式。」

如果找不到其中一個 IP 集：「Action wasn't able to find the following '{0}' Regex Pattern Sets in the AWS WAF:\n {1}".format("Regional"/Cloudfront",list of IP sets that were not found in that scope)

如果在指定範圍內找不到所有提供的規則運算式模式組合：「動作找不到提供的規則運算式模式組合。」

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器)，系統會回報其他錯誤：「執行『從規則運算式模式集移除實體』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

一般

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求解答。