AWS-AddWAFRegionalRuleToRuleGroup - AWS Systems Manager 自動化手冊參考

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

AWS-AddWAFRegionalRuleToRuleGroup

Description

AWS-AddWAFRegionalRuleToRuleGrouprunbook 將現有的 AWS WAF 地區規則新增至 AWS WAF 地區規則群組。僅支援 AWS WAF 傳統地區規則群組。 AWS WAF 傳統區域規則群組最多可以有 10 個規則。

運行此自動化（控制台）

文件類型

 自動化

擁有者

Amazon

平台

Linux,macOS, Windows

參數

  • AutomationAssumeRole

    類型：字串

    描述：(選用) 允許 Systems Manager 自動化代表您執行動作的 AWS Identity and Access Management (IAM) 角色的 Amazon 資源名稱 ()。ARN如果未指定角色，Systems Manager 自動化會使用啟動此 runbook 的使用者的權限。

  • RuleGroupId

    類型：字串

    描述：(必要) 您要更新之規則群組的識別碼。

  • RulePriority

    類型：整數

    描述：(必要) 新規則的優先順序。規則優先順序決定區域群組中規則的評估順序。值較低的規則的優先順序高於具有較高值的規則。值必須是唯一的整數。如果您將多個規則新增至地區規則群組，則這些值不一定是連續的。

  • RuleId

    類型：字串

    描述：(必要) 您要新增至地區規則群組之規則的 ID。

  • RuleAction

    類型：字串

    描述：(必要) 指定當 Web 要求符合規則條件時所 AWS WAF 採取的動作。

    有效值：ALLOW| BLOCK | COUNT

必要的IAM權限

此AutomationAssumeRole參數需要執行下列動作，才能成功使用 Runbook。

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • waf-regional:GetChangeToken

  • waf-regional:GetChangeTokenStatus

  • waf-regional:ListActivatedRulesInRuleGroup

  • waf-regional:UpdateRuleGroup

文件步驟

  • G etWAFChange 令牌（aws:executeAwsApi）-檢索 AWS WAF 更改令牌以確保 runbook 不會向服務提交衝突的請求。

  • A ddWAFRule T oWAFRegional RuleGroup (aws:executeScript)-將指定的規則新增至 AWS WAF 區域規則群組。

  • VerifyChangeTokenPropagating （aws: waitForAwsResourceProperty）-驗證更改令牌的狀態為PENDING或INSYNC。

  • VerifyRuleAddedToRuleGroup (aws:executeScript)-驗證指定的 AWS WAF 規則已新增至目標區域規則群組。

輸出

  • VerifyRuleAddedToRuleGroup。 VerifyRuleAddedToRuleGroupResponse -驗證新規則是否已連接至區域規則群組的步驟輸出。

  • VerifyRuleAddedToRuleGroup。 ListActivatedRulesInRuleGroupResponse -ListActivatedRulesInRuleGroup API 操作的輸出。