View a markdown version of this page

AWS-AddWAFRegionalRuleToWebAcl - AWS Systems Manager 自动化运行手册参考

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWS-AddWAFRegionalRuleToWebAcl

描述

该AWS-AddWAFRegionalRuleToWebAcl运行手册将现有的 AWS WAF 区域规则、规则组或基于速率的规则添加到 AWS WAF 经典区域 Web 访问控制列表 (ACL) 中。本运行手册不更新由 AWS Firewall Manager管理的现有 AWS WAF 经典区域网络 ACL。

运行此自动化（控制台）

文档类型

自动化

所有者

Amazon

平台

Linux、macOS、Windows

参数

  • AutomationAssumeRole

    类型：字符串

    描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。

  • WebACLId

    类型：字符串

    描述：（必填）您要更新的网页 ACL 的 ID。

  • ActivatedRulePriority

    类型：整数

    描述：（必填）新规则的优先级。规则优先级决定了评估 Web ACL 中规则的顺序。值较低的规则的优先级高于值较高的规则。值必须是整数。如果您向区域 Web ACL 添加多个规则，则这些值不必是连续的。

  • ActivatedRuleRuleId

    类型：字符串

    描述：（必填）您要添加到 Web ACL 的常规规则、基于速率的规则或群组的 ID。

  • ActivatedRuleAction

    类型：字符串

    有效值：允许 | 阻止 | 计数

    描述：（可选）指定 Web 请求与规则条件匹配时 AWS WAF 采取的操作。

  • ActivatedRuleType

    类型：字符串

    有效值：常规 | 基于 RATE_BASED | 群组

    默认：常规

    描述：（可选）您要添加到 Web ACL 的规则类型。尽管此字段是可选字段，但请注意，如果您尝试在不设置类型的情况下向 Web ACL 添加RATE_BASED规则，则请求会失败，因为请求默认为REGULAR规则。

所需的 IAM 权限

AutomationAssumeRole 参数需要执行以下操作才能成功使用运行手册。

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • waf-regional:GetChangeToken

  • waf-regional:GetWebACL

  • waf-regional:UpdateWebACL

文档步骤

  • DetermineWebACLNotInFMSAndRulePriority (AWS: ExecuteScript)-验证 AWS WAF Web ACL 是否在防火墙管理器安全策略中，并验证优先级 ID 与现有 ACL 不冲突。

  • AddRuleOrRuleGroupToWebACL (AWS: ExecuteScript)-将指定规则添加到 Web ACL。 AWS WAF

  • VerifyRuleOrRuleGroupAddedToWebAcl (AWS: ExecuteScript)-验证指定的 AWS WAF 规则已添加到目标 Web ACL 中。

输出

  • DetermineWebACLNotInFMSAndRulePriority.PrereqResponse：该DetermineWebACLNotInFMSAndRulePriority步骤的输出。

  • VerifyRuleOrRuleGroupAddedToWebAcl.VerifyRuleOrRuleGroupAddedToWebACLResponse：该AddRuleOrRuleGroupToWebACL步骤的输出。

  • VerifyRuleOrRuleGroupAddedToWebAcl.ListActivatedRulesOrRuleGroupsInWebACLResponse：该VerifyRuleOrRuleGroupAddedToWebAcl步骤的输出。