AWS WAF 如何与 IAM 协同工作 - AWS WAF、AWS Firewall Manager、AWS Shield Advanced 和 AWS Shield 网络安全分析器

介绍 AWS WAF 的全新控制台体验

现在,您可以使用更新后的体验访问控制台中任意位置的 AWS WAF 功能。有关更多详细信息,请参阅 使用更新的控制台体验

AWS WAF 如何与 IAM 协同工作

本节介绍了如何将 IAM 的功能和 AWS WAF 搭配使用。

在使用 IAM 管理对 AWS WAF 的访问之前,您应该了解哪些 IAM 功能可用于 AWS WAF。

要大致了解 AWS WAF 和其他 AWS 服务如何与大多数 IAM 功能一起使用,请参阅《IAM 用户指南》中的与 IAM 一起使用的 AWS 服务

适用于 的基于身份的 策略AWS WAF

支持基于身份的策略:

基于身份的策略是可附加到身份(如 IAM 用户、用户组或角色)的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略,请参阅《IAM 用户指南》中的使用客户管理型策略定义自定义 IAM 权限

通过使用 IAM 基于身份的策略,您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素,请参阅《IAM 用户指南》中的 IAM JSON 策略元素引用

要查看 AWS WAF 基于身份的策略的示例,请参阅适用于 AWS WAF 的基于身份的策略示例

AWS WAF 内基于资源的策略

支持基于资源的策略:

基于资源的策略是附加到资源的 JSON 策略文档。基于资源的策略的示例包括 IAM 角色信任策略和 Amazon S3 存储桶策略。在支持基于资源的策略的服务中,服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源,策略定义指定主体可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中指定主体。主体可以包括账户、用户、角色、联合用户或 AWS 服务。

要启用跨账户访问,您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的主体。有关更多信息,请参阅《IAM 用户指南》中的 IAM 中的跨账户资源访问

AWS WAF 使用基于资源的策略来支持跨账户共享规则组。通过向 AWS WAF API 调用 PutPermissionPolicy 或者对等 CLI 或 SDK 调用提供基于资源的策略设置,您可以与其他 AWS 账户共享您拥有的规则组。有关更多信息,包括其他可用语言的示例和文档链接,请参阅 AWS WAF API 参考中的 PutPermissionPolicy。此功能无法通过其他方式使用,例如控制台或 CloudFormation。

适用于 AWS WAF 的策略操作

支持策略操作:

管理员可以使用 AWS JSON 策略来指定谁有权访问什么内容。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。在策略中包含操作以授予执行关联操作的权限。

要查看每个 AWS WAF 操作和权限的列表,请参阅服务授权参考中的 AWS WAF V2 定义的操作

AWS WAF 中的策略操作在操作前使用以下前缀:

wafv2

要在单个语句中指定多项操作,请使用逗号将它们隔开。

"Action": [ "wafv2:action1", "wafv2:action2" ]

您也可以使用通配符(*)指定多个操作。例如,要在 AWS WAF 中指定以 List 开头的所有操作,包括以下操作:

"Action": "wafv2:List*"

要查看 AWS WAF 基于身份的策略的示例,请参阅适用于 AWS WAF 的基于身份的策略示例

需要额外权限设置的操作

有些操作需要的权限无法在服务授权参考中的 AWS WAF V2 定义的操作中进行完整描述。本节提供其他权限信息。

AssociateWebACL 权限

本节列出使用 AWS WAF 操作 AssociateWebACL 将保护包(web ACL)与资源关联所需的权限。

对于 Amazon CloudFront 分配,请使用 CloudFront 操作 UpdateDistribution 代替此操作。有关信息,请参见 Amazon CloudFront API 参考UpdateDistribution

Amazon API Gateway REST API

需要权限才能在 REST API 资源类型上调用 API Gateway SetWebACL,并在保护包(web ACL)上调用 AWS WAF AssociateWebACL

{ "Sid": "AssociateWebACL1", "Effect": "Allow", "Action": [ "wafv2:AssociateWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "AssociateWebACL2", "Effect": "Allow", "Action": [ "apigateway:SetWebACL" ], "Resource": [ "arn:aws:apigateway:*::/restapis/*/stages/*" ] }
应用程序负载均衡器

需要权限才能在应用程序负载均衡器上调用 elasticloadbalancing:SetWebACL 操作,并在保护包(web ACL)上调用 AWS WAF AssociateWebACL

{ "Sid": "AssociateWebACL1", "Effect": "Allow", "Action": [ "wafv2:AssociateWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "AssociateWebACL2", "Effect": "Allow", "Action": [ "elasticloadbalancing:SetWebACL" ], "Resource": [ "arn:aws:elasticloadbalancing:*:account-id:loadbalancer/app/*/*" ] }
AWS AppSync GraphQL API

需要权限才能在 GraphQL API 资源类型上调用 AWS AppSync SetWebACL,并在保护包(web ACL)上调用 AWS WAF AssociateWebACL

{ "Sid": "AssociateWebACL1", "Effect": "Allow", "Action": [ "wafv2:AssociateWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "AssociateWebACL2", "Effect": "Allow", "Action": [ "appsync:SetWebACL" ], "Resource": [ "arn:aws:appsync:*:account-id:apis/*" ] }
Amazon Cognito 用户池

需要权限才能在用户池资源类型上调用 Amazon Cognito AssociateWebACL 操作,并在保护包(web ACL)上 调用 AWS WAF AssociateWebACL

{ "Sid": "AssociateWebACL1", "Effect": "Allow", "Action": [ "wafv2:AssociateWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "AssociateWebACL2", "Effect": "Allow", "Action": [ "cognito-idp:AssociateWebACL" ], "Resource": [ "arn:aws:cognito-idp:*:account-id:userpool/*" ] }
AWS App Runner 服务

需要权限才能在 App Runner 服务资源类型上调用 App Runner AssociateWebACL 操作,并在 web ACL 上调用 AWS WAF AssociateWebACL

{ "Sid": "AssociateWebACL1", "Effect": "Allow", "Action": [ "wafv2:AssociateWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "AssociateWebACL2", "Effect": "Allow", "Action": [ "apprunner:AssociateWebAcl" ], "Resource": [ "arn:aws:apprunner:*:account-id:service/*/*" ] }
AWS 已验证访问实例

需要权限才能在 Verified Access 实例资源类型上调用 ec2:AssociateVerifiedAccessInstanceWebAcl 操作并在 web ACL 上调用 AWS WAF AssociateWebACL

{ "Sid": "AssociateWebACL1", "Effect": "Allow", "Action": [ "wafv2:AssociateWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "AssociateWebACL2", "Effect": "Allow", "Action": [ "ec2:AssociateVerifiedAccessInstanceWebAcl" ], "Resource": [ "arn:aws:ec2:*:account-id:verified-access-instance/*" ] }

DisassociateWebACL 权限

本节列出了使用 AWS WAF 操作 DisassociateWebACL 将保护包(web ACL)与资源取消关联所需的权限。

对于 Amazon CloudFront 分配,请使用带空保护包(web ACL)ID 的 CloudFront 操作 UpdateDistribution 代替此操作。有关信息,请参见 Amazon CloudFront API 参考UpdateDistribution

Amazon API Gateway REST API

需要权限才能在 REST API 资源类型上调用 API Gateway SetWebACL。不需要调用 AWS WAF DisassociateWebACL 的权限。

{ "Sid": "DisassociateWebACL", "Effect": "Allow", "Action": [ "apigateway:SetWebACL" ], "Resource": [ "arn:aws:apigateway:*::/restapis/*/stages/*" ] }
应用程序负载均衡器

需要权限才能在应用程序负载均衡器资源类型上调用 elasticloadbalancing:SetWebACL 操作。不需要调用 AWS WAF DisassociateWebACL 的权限。

{ "Sid": "DisassociateWebACL", "Effect": "Allow", "Action": [ "elasticloadbalancing:SetWebACL" ], "Resource": [ "arn:aws:elasticloadbalancing:*:account-id:loadbalancer/app/*/*" ] }
AWS AppSync GraphQL API

需要权限才能在 GraphQL API 资源类型上调用 AWS AppSync SetWebACL。不需要调用 AWS WAF DisassociateWebACL 的权限。

{ "Sid": "DisassociateWebACL", "Effect": "Allow", "Action": [ "appsync:SetWebACL" ], "Resource": [ "arn:aws:appsync:*:account-id:apis/*" ] }
Amazon Cognito 用户池

需要权限才能在用户群体资源类型上调用 Amazon Cognito DisassociateWebACL 操作并调用 AWS WAF DisassociateWebACL

{ "Sid": "DisassociateWebACL1", "Effect": "Allow", "Action": "wafv2:DisassociateWebACL", "Resource": "*" }, { "Sid": "DisassociateWebACL2", "Effect": "Allow", "Action": [ "cognito-idp:DisassociateWebACL" ], "Resource": [ "arn:aws:cognito-idp:*:account-id:userpool/*" ] }
AWS App Runner 服务

需要权限才能在 App Runner 服务资源类型上调用 App Runner DisassociateWebACL 操作,并调用 AWS WAF DisassociateWebACL

{ "Sid": "DisassociateWebACL1", "Effect": "Allow", "Action": "wafv2:DisassociateWebACL", "Resource": "*" }, { "Sid": "DisassociateWebACL2", "Effect": "Allow", "Action": [ "apprunner:DisassociateWebAcl" ], "Resource": [ "arn:aws:apprunner:*:account-id:service/*/*" ] }
AWS 已验证访问实例

需要权限才能在 Verified Access 实例资源类型上调用 ec2:DisassociateVerifiedAccessInstanceWebAcl 操作并调用 AWS WAF DisassociateWebACL

{ "Sid": "DisassociateWebACL1", "Effect": "Allow", "Action": "wafv2:DisassociateWebACL", "Resource": "*" }, { "Sid": "DisassociateWebACL2", "Effect": "Allow", "Action": [ "ec2:DisassociateVerifiedAccessInstanceWebAcl" ], "Resource": [ "arn:aws:ec2:*:account-id:verified-access-instance/*" ] }

GetWebACLForResource 权限

本节列出使用 AWS WAF 操作 GetWebACLForResource 获取受保护资源的保护包(web ACL)所需的权限。

对于 Amazon CloudFront 分配,请使用 CloudFront 操作 GetDistributionConfig 代替此操作。有关信息,请参阅 Amazon CloudFront API 参考中的 GetDistributionConfig

注意

GetWebACLForResource 需要调用 GetWebACL 的权限。在这种情况下,AWS WAF 仅将 GetWebACL 用于验证您的账户是否具有访问 GetWebACLForResource 返回的保护包(web ACL)所需的权限。当您调用 GetWebACLForResource 时,您可能会收到一条错误消息,表明您的账户无权在资源上执行 wafv2:GetWebACL。AWS WAF 不会将此类错误添加到 AWS CloudTrail 事件历史记录中。

Amazon API Gateway REST API、应用程序负载均衡器 和 AWS AppSync GraphQL API

需要调用 AWS WAF GetWebACLForResourceGetWebACL 的权限,以获得保护包(web ACL)。

{ "Sid": "GetWebACLForResource", "Effect": "Allow", "Action": [ "wafv2:GetWebACLForResource", "wafv2:GetWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }
Amazon Cognito 用户池

需要权限才能在用户群体资源类型上调用 Amazon Cognito GetWebACLForResource 操作并调用 AWS WAF GetWebACLForResourceGetWebACL

{ "Sid": "GetWebACLForResource1", "Effect": "Allow", "Action": [ "wafv2:GetWebACLForResource", "wafv2:GetWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "GetWebACLForResource2", "Effect": "Allow", "Action": [ "cognito-idp:GetWebACLForResource" ], "Resource": [ "arn:aws:cognito-idp:*:account-id:userpool/*" ] }
AWS App Runner 服务

需要权限才能在 App Runner 服务资源类型上调用 App Runner DescribeWebAclForService 操作,并调用 AWS WAF GetWebACLForResourceGetWebACL

{ "Sid": "GetWebACLForResource1", "Effect": "Allow", "Action": [ "wafv2:GetWebACLForResource", "wafv2:GetWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "GetWebACLForResource2", "Effect": "Allow", "Action": [ "apprunner:DescribeWebAclForService" ], "Resource": [ "arn:aws:apprunner:*:account-id:service/*/*" ] }
AWS 已验证访问实例

需要权限才能在 Verified Access 实例资源类型上调用 ec2:GetVerifiedAccessInstanceWebAcl 操作并调用 AWS WAF GetWebACLForResourceGetWebACL

{ "Sid": "GetWebACLForResource1", "Effect": "Allow", "Action": [ "wafv2:GetWebACLForResource", "wafv2:GetWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "GetWebACLForResource2", "Effect": "Allow", "Action": [ "ec2:GetVerifiedAccessInstanceWebAcl" ], "Resource": [ "arn:aws:ec2:*:account-id:verified-access-instance/*" ] }

ListResourcesForWebACL 权限

本节列出使用 AWS WAF 操作 ListResourcesForWebACL 检索保护包(web ACL)的受保护资源列表所需的权限。

对于 Amazon CloudFront 分配,请使用 CloudFront 操作 ListDistributionsByWebACLId 代替此操作。有关信息,请参阅Amazon CloudFront API 参考中的 ListDistributionsByWebACLId

Amazon API Gateway REST API、应用程序负载均衡器 和 AWS AppSync GraphQL API

需要权限才能调用 AWS WAF ListResourcesForWebACL 以获得 web ACL。

{ "Sid": "ListResourcesForWebACL", "Effect": "Allow", "Action": [ "wafv2:ListResourcesForWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }
Amazon Cognito 用户池

需要权限才能在用户群体资源类型上调用 Amazon Cognito ListResourcesForWebACL 操作并调用 AWS WAF ListResourcesForWebACL

{ "Sid": "ListResourcesForWebACL1", "Effect": "Allow", "Action": [ "wafv2:ListResourcesForWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "ListResourcesForWebACL2", "Effect": "Allow", "Action": [ "cognito-idp:ListResourcesForWebACL" ], "Resource": [ "arn:aws:cognito-idp:*:account-id:userpool/*" ] }
AWS App Runner 服务

需要权限才能在 App Runner 服务资源类型上调用 App Runner ListAssociatedServicesForWebAcl 操作,并调用 AWS WAF ListResourcesForWebACL

{ "Sid": "ListResourcesForWebACL1", "Effect": "Allow", "Action": [ "wafv2:ListResourcesForWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "ListResourcesForWebACL2", "Effect": "Allow", "Action": [ "apprunner:ListAssociatedServicesForWebAcl" ], "Resource": [ "arn:aws:apprunner:*:account-id:service/*/*" ] }
AWS 已验证访问实例

需要权限才能在 Verified Access 实例资源类型上调用 ec2:DescribeVerifiedAccessInstanceWebAclAssociations 操作并调用 AWS WAF ListResourcesForWebACL

{ "Sid": "ListResourcesForWebACL1", "Effect": "Allow", "Action": [ "wafv2:ListResourcesForWebACL" ], "Resource": [ "arn:aws:wafv2:region:account-id:regional/webacl/*/*" ] }, { "Sid": "ListResourcesForWebACL2", "Effect": "Allow", "Action": [ "ec2:DescribeVerifiedAccessInstanceWebAclAssociations" ], "Resource": [ "arn:aws:ec2:*:account-id:verified-access-instance/*" ] }

AWS WAF 的策略资源

支持策略资源:

管理员可以使用 AWS JSON 策略来指定谁有权访问什么内容。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践,请使用其 Amazon 资源名称(ARN)指定资源。对于不支持资源级权限的操作,请使用通配符(*)来指示此语句应用于所有资源。

"Resource": "*"

要查看 AWS WAF 资源类型及其 ARN 的列表,请参阅由服务授权参考AWS WAF V2 定义的资源。要了解您可以在哪些操作中指定每个资源的 ARN,请参阅 AWS WAF V2 定义的操作。要允许或拒绝对 AWS WAF 资源子集的访问权限,请在策略的 resource 元素中包含资源的 ARN。

AWS WAF wafv2 资源的 ARN 具有以下格式:

arn:partition:wafv2:region:account-id:scope/resource-type/resource-name/resource-id

有关 ARN 的信息,请参阅 Amazon Web Services 一般参考 中的 Amazon 资源名称 (ARN)

以下列出了特定于 wafv2 资源 ARN 的要求:

  • 区域:对于用于保护 Amazon CloudFront 分配的 AWS WAF 资源,请将其设置为 us-east-1。否则,请将其设置为您正在使用受保护区域资源的区域。

  • 范围:将范围设置为 global,以便与 Amazon CloudFront 分配一起使用,或设置为 regional,以便与支持的任何区域资源一起使用。AWS WAF区域资源包括 Amazon API Gateway REST API、应用程序负载均衡器、AWS AppSync GraphQL API、Amazon Cognito 用户群体、AWS App Runner 服务和 AWS 已验证访问实例。

  • 资源类型:指定以下值之一:webaclrulegroupipsetregexpatternsetmanagedruleset

  • 资源名称:指定您为 AWS WAF 资源提供的名称,或指定通配符 (*) 以表示满足 ARN 中其他规格的所有资源。您必须指定资源名称和资源 ID,或者为两者指定通配符。

  • resource-id:指定 AWS WAF 资源的 ID,或指定通配符 (*) 以表示满足 ARN 中其他规格的所有资源。您必须指定资源名称和资源 ID,或者为两者指定通配符。

例如,以下 ARN 指定区域 us-west-1 中具有账户 111122223333 的区域作用域的所有保护包(web ACL):

arn:aws:wafv2:us-west-1:111122223333:regional/webacl/*/*

以下 ARN 为区域 us-east-1 中的账户 111122223333 指定了名为 MyIPManagementRuleGroup 全局范围规则组:

arn:aws:wafv2:us-east-1:111122223333:global/rulegroup/MyIPManagementRuleGroup/1111aaaa-bbbb-cccc-dddd-example-id

要查看 AWS WAF 基于身份的策略的示例,请参阅适用于 AWS WAF 的基于身份的策略示例

AWS WAF 的策略条件键

支持特定于服务的策略条件键:

管理员可以使用 AWS JSON 策略来指定谁有权访问什么内容。也就是说,哪个主体可以对什么资源执行操作,以及在什么条件下执行。

Condition 元素指定语句何时根据定义的标准执行。您可以创建使用条件运算符(例如,等于或小于)的条件表达式,以使策略中的条件与请求中的值相匹配。要查看所有 AWS 全局条件键,请参阅《IAM 用户指南》中的 AWS 全局条件上下文键

此外,AWS WAF 支持以下条件键,您可以使用这些键来为 IAM 策略提供精细筛选:

  • wafv2:LogDestinationResource

    此条件键采用日志记录目标的 Amazon 资源名称 (ARN)。这是您在使用 REST API 调用 PutLoggingConfiguration 时为日志记录目标提供的 ARN。

    您可以明确指定 ARN,也可以指定筛选 ARN。以下示例指定筛选具有特定位置和前缀的 Amazon S3 存储桶的 ARN。

    "Condition": { "ArnLike": { "wafv2:LogDestinationResource": "arn:aws:s3:::aws-waf-logs-suffix/custom-prefix/*" } }
  • wafv2:LogScope

    此条件键以字符串形式定义了日志记录配置的来源。当前始终设置为默认值 Customer,这表示日志记录目标归您所有和管理。

有关 AWS WAF 条件键的列表,请参阅服务授权参考中的 AWS WAF V2 的条件键。要了解您可以对哪些操作和资源使用条件键,请参阅 AWS WAF V2 定义的操作

要查看 AWS WAF 基于身份的策略的示例,请参阅适用于 AWS WAF 的基于身份的策略示例

AWS WAF 中的 ACL

支持 ACL:

访问控制列表(ACL)控制哪些主体(账户成员、用户或角色)有权访问资源。ACL 与基于资源的策略类似,但它们不使用 JSON 策略文档格式。

带有 AWS WAF 的 ABAC

支持 ABAC(策略中的标签):部分支持

基于属性的访问权限控制(ABAC)是一种授权策略,该策略基于称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和 AWS 资源,然后设计 ABAC 策略,以支持在主体的标签与资源上的标签匹配时执行操作。

要基于标签控制访问,您需要使用 aws:ResourceTag/key-nameaws:RequestTag/key-nameaws:TagKeys 条件键在策略的条件元素中提供标签信息。

如果某个服务对于每种资源类型都支持所有这三个条件键,则对于该服务,该值为。如果某个服务仅对于部分资源类型支持所有这三个条件键,则该值为部分

有关 ABAC 的更多信息,请参阅《IAM 用户指南》中的使用 ABAC 授权定义权限。要查看设置 ABAC 步骤的教程,请参阅 IAM 用户指南中的使用基于属性的访问权限控制(ABAC)

将临时凭证用于 AWS WAF

支持临时凭证:

临时凭证提供对 AWS 资源的短期访问权限,并且是在您使用联合身份验证或切换角色时自动创建的。AWS 建议您动态生成临时凭证,而不是使用长期访问密钥。有关更多信息,请参阅《IAM 用户指南》中的 IAM 中的临时安全凭证使用 IAM 的 AWS 服务

服务 AWS WAF 的转发访问会话

支持转发访问会话(FAS):

转发访问会话(FAS)使用调用 AWS 服务的主体的权限,与发出请求的 AWS 服务结合,来向下游服务发出请求。有关发出 FAS 请求时的策略详细信息,请参阅转发访问会话

AWS WAF 的服务角色

支持服务角色:

服务角色是由一项服务担任、代表您执行操作的 IAM 角色。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息,请参阅《IAM 用户指南》中的创建向 AWS 服务委派权限的角色

警告

更改服务角色的权限可能会破坏 AWS WAF 的功能。只有在 AWS WAF 提供指导时,才能编辑服务角色。

AWS WAF 的服务相关角色

支持服务相关角色:

服务相关角色是一种与 AWS 服务 相关的服务角色。服务可以代入代表您执行操作的角色。服务相关角色显示在您的 AWS 账户 中,并由该服务拥有。IAM 管理员可以查看但不能编辑服务相关角色的权限。

有关创建或管理 AWS WAF 服务相关角色的详细信息,请参阅 将服务相关角色用于 AWS WAF