**引入全新的主机体验 AWS WAF**

现在，您可以使用更新的体验访问控制台中任意位置的 AWS WAF 功能。有关更多详细信息，请参阅[使用控制台](https://docs.aws.amazon.com/waf/latest/developerguide/working-with-console.html)。

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

# 如何 AWS WAF 与 IAM 配合使用
<a name="security_iam_service-with-iam"></a>

本节介绍如何将 IAM 的功能与一起使用 AWS WAF。

在使用 IAM 管理访问权限之前 AWS WAF，请先了解哪些可用的 IAM 功能 AWS WAF。






**您可以搭配使用的 IAM 功能 AWS WAF**  

| IAM 功能 | AWS WAF 支持 | 
| --- | --- | 
|  [基于身份的策略](#security_iam_service-with-iam-id-based-policies)  |   是  | 
|  [基于资源的策略](#security_iam_service-with-iam-resource-based-policies)  |   是  | 
|  [策略操作](#security_iam_service-with-iam-id-based-policies-actions)  |   是  | 
|  [策略资源](#security_iam_service-with-iam-id-based-policies-resources)  |   是  | 
|  [策略条件键（特定于服务）](#security_iam_service-with-iam-id-based-policies-conditionkeys)  |   是  | 
|  [ACLs](#security_iam_service-with-iam-acls)  |   否   | 
|  [ABAC（策略中的标签）](#security_iam_service-with-iam-tags)  |   部分  | 
|  [临时凭证](#security_iam_service-with-iam-roles-tempcreds)  |   是  | 
|  [转发访问会话（FAS）](#security_iam_service-with-iam-principal-permissions)  |   是  | 
|  [服务角色](#security_iam_service-with-iam-roles-service)  |   是  | 
|  [服务关联角色](#security_iam_service-with-iam-roles-service-linked)  |   是  | 

要全面了解 AWS WAF 以及其他 AWS 服务如何与大多数 IAM 功能配合使用，请参阅 IAM *用户指南中的与 IAM* [配合使用的AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。

## 基于身份的策略 AWS WAF
<a name="security_iam_service-with-iam-id-based-policies"></a>

**支持基于身份的策略：**是

基于身份的策略是可附加到身份（如 IAM 用户、用户组或角色）的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》**中的[使用客户管理型策略定义自定义 IAM 权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。

通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素引用](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)。

要查看 AWS WAF 基于身份的策略的示例，请参阅。[基于身份的策略示例 AWS WAF](security_iam_id-based-policy-examples.md)

## 内部基于资源的政策 AWS WAF
<a name="security_iam_service-with-iam-resource-based-policies"></a>

**支持基于资源的策略：**是

基于资源的策略是附加到资源的 JSON 策略文档。基于资源的策略的示例包括 IAM *角色信任策略*和 Amazon S3 *存储桶策略*。在支持基于资源的策略的服务中，服务管理员可以使用它们来控制对特定资源的访问。对于在其中附加策略的资源，策略定义指定主体可以对该资源执行哪些操作以及在什么条件下执行。您必须在基于资源的策略中[指定主体](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)。委托人可以包括账户、用户、角色、联合用户或 AWS 服务。

要启用跨账户访问，您可以将整个账户或其他账户中的 IAM 实体指定为基于资源的策略中的主体。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的跨账户资源访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)。

AWS WAF 使用基于资源的策略来支持跨账户共享规则组。通过向 AWS WAF API 调用或等效的 CLI `PutPermissionPolicy` 或 SDK 调用提供基于资源的策略设置，您可以与其他 AWS 账户共享您拥有的规则组。如需了解更多信息，包括其他可用语言的示例和文档链接，请参阅 AWS WAF API 参考[PutPermissionPolicy](https://docs.aws.amazon.com/waf/latest/APIReference/API_PutPermissionPolicy.html)中的。此功能无法通过其他方式使用，例如控制台或 CloudFormation。

## 的政策行动 AWS WAF
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

**支持策略操作：**是

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

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



要查看每个 AWS WAF 操作和权限的列表，请参阅《*服务授权参考*》中的 [AWS WAF V2 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awswafv2.html#awswafv2-actions-as-permissions)。

正在执行的策略操作在操作前 AWS WAF 使用以下前缀：

```
wafv2
```

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

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



您也可以使用通配符（\$1）指定多个操作。例如，要指定以开头的所有操作`List`，请包括以下操作： AWS WAF 

```
"Action": "wafv2:List*"
```

要查看 AWS WAF 基于身份的策略的示例，请参阅。[基于身份的策略示例 AWS WAF](security_iam_id-based-policy-examples.md)

### 需要额外权限设置的操作
<a name="security_iam_action-additions"></a>

有些操作需要的权限无法在《*服务授权参考*》中的 [AWS WAF V2 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awswafv2.html#awswafv2-actions-as-permissions)中进行完整描述。本节提供其他权限信息。

**Topics**
+ [`AssociateWebACL` 权限](#security_iam_action-AssociateWebACL)
+ [`DisassociateWebACL` 权限](#security_iam_action-DisassociateWebACL)
+ [`GetWebACLForResource` 权限](#security_iam_action-GetWebACLForResource)
+ [`ListResourcesForWebACL` 权限](#security_iam_action-ListResourcesForWebACL)

#### `AssociateWebACL` 权限
<a name="security_iam_action-AssociateWebACL"></a>

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

对于 Amazon CloudFront 分配，请使用操作代替此 CloudFront 操作`UpdateDistribution`。有关信息，请参阅[UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)《*亚马逊 CloudFront API 参考*》。

**Amazon API Gateway REST API**  
需要权限才能在 REST API 资源类型`SetWebACL`上调用 API Gateway 以及调用 AWS WAF `AssociateWebACL`保护包（Web ACL）。

```
{
    "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/*"
    ]
}
```

**应用程序负载均衡器**  
需要权限才能调用 Applicati `elasticloadbalancing:SetWebACL` on Load Balancer 资源类型和调用 AWS WAF `AssociateWebACL`保护包 (Web ACL)。

```
{
    "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**  
需要权限才能调用 AWS AppSync `SetWebACL` GraphQL API 资源类型和调 AWS WAF `AssociateWebACL`用保护包（Web ACL）。

```
{
    "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` 操作和调用 AWS WAF `AssociateWebACL`保护包（Web ACL）。

```
{
    "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` 操作并调用 AWS WAF `AssociateWebACL` Web ACL。

```
{
    "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 已验证访问实例**  
需要权限才能在 “已验证访问权限” 实例资源类型上调用`ec2:AssociateVerifiedAccessInstanceWebAcl`操作并调用 AWS WAF `AssociateWebACL` Web ACL。

```
{
    "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` 权限
<a name="security_iam_action-DisassociateWebACL"></a>

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

对于 Amazon CloudFront 分配，请使用`UpdateDistribution`带有空保护包 (Web ACL) ID 的 CloudFront 操作，而不是此操作。有关信息，请参阅[UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html)《*亚马逊 CloudFront API 参考*》。

**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**  
需要权限才能调用 AWS AppSync `SetWebACL` GraphQL API 资源类型。不需要通话许可 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 已验证访问实例**  
需要权限才能在 “已验证访问权限” 实例资源类型上调用`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` 权限
<a name="security_iam_action-GetWebACLForResource"></a>

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

对于 Amazon CloudFront 分配，请使用操作代替此 CloudFront 操作`GetDistributionConfig`。有关信息，请参阅[GetDistributionConfig](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetDistributionConfig.html)《*亚马逊 CloudFront API 参考*》。

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

**亚马逊 API Gateway REST API、Application Load Balancer 和 AWS AppSync GraphQL API**  
需要通话 AWS WAF `GetWebACLForResource`权限才能`GetWebACL`使用保护包（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 `GetWebACLForResource`用和。`GetWebACL`

```
{
    "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 `GetWebACLForResource`和`GetWebACL`。

```
{
    "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 已验证访问实例**  
需要权限才能在 “已验证访问权限” 实例资源类型上调用`ec2:GetVerifiedAccessInstanceWebAcl`操作并调用 AWS WAF `GetWebACLForResource`和`GetWebACL`。

```
{
    "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` 权限
<a name="security_iam_action-ListResourcesForWebACL"></a>

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

对于 Amazon CloudFront 分配，请使用操作代替此 CloudFront 操作`ListDistributionsByWebACLId`。有关信息，请参阅[ListDistributionsByWebACLId](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html)《*亚马逊 CloudFront API 参考*》。

**亚马逊 API Gateway REST API、Application Load Balancer 和 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
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

**支持策略资源：**是

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

`Resource` JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 [Amazon 资源名称（ARN）](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)指定资源。对于不支持资源级权限的操作，请使用通配符 (\$1) 指示语句应用于所有资源。

```
"Resource": "*"
```

要查看 AWS WAF 资源类型及其列表 ARNs，请参阅《*服务授权参考*》中的 [AWS WAF V2 定义的资源](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awswafv2.html#awswafv2-resources-for-iam-policies)。要了解您可以使用哪些操作来指定每种资源的 ARN，请参阅 V2 [定义的 AWS WAF 操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awswafv2.html#awswafv2-actions-as-permissions)。要允许或拒绝访问 AWS WAF 资源子集，请在策略的`resource`元素中包含该资源的 ARN。

o AWS WAF `wafv2` f ARNs 资源的格式如下：

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

有关 ARN 规范的一般信息，请参阅中的 A [mazon 资源名称 (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。 Amazon Web Services 一般参考

以下列出了特定于 ARNs `wafv2`资源的要求：
+ *region*：对于用于保护 Amazon CloudFront 分配的 AWS WAF 资源，请将其设置为`us-east-1`。否则，请将其设置为您正在使用受保护区域资源的区域。
+ *scope*：将范围设置`global`为用于 Amazon CloudFront 分销或`regional`与 AWS WAF 支持的任何区域资源一起使用。区域资源是 Amazon API Gateway REST API、应用程序负载均衡器、 AWS AppSync GraphQL API、Amazon Cognito 用户池、服务和 AWS 已验证访问实 AWS App Runner 例。
+ *resource-type*：指定以下值之一：`webacl`、`rulegroup`、`ipset``regexpatternset`、或`managedruleset`。
+ *resource-name*：指定您为 AWS WAF 资源提供的名称，或指定通配符 (`*`) 以表示满足 ARN 中其他规格的所有资源。您必须指定资源名称和资源 ID，或者为两者指定通配符。
+ *resource-id*：指定 AWS WAF 资源的 ID，或指定通配符 (`*`) 以表示满足 ARN 中其他规格的所有资源。您必须指定资源名称和资源 ID，或者为两者指定通配符。

例如，以下 ARN 为区域中的账户`111122223333`指定了所有具有区域范围的保护包（网络 ACLs）：`us-west-1`

```
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](security_iam_id-based-policy-examples.md)

## 的策略条件密钥 AWS WAF
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

**支持特定于服务的策略条件键：**是

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

`Condition` 元素根据定义的条件指定语句何时执行。您可以创建使用[条件运算符](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。要查看所有 AWS 全局条件键，请参阅 *IAM 用户指南*中的[AWS 全局条件上下文密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)。

此外，还 AWS WAF 支持以下条件键，您可以使用这些条件键为您的 IAM 策略提供精细筛选：
+ **wafv2：LogDestinationResource**

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

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

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

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

要查看 AWS WAF 条件键列表，请参阅《*服务授权参考*》中的 [AWS WAF V2 条件密钥](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awswafv2.html#awswafv2-policy-keys)。要了解可以使用条件键的操作和资源，请参阅 [AWS WAF V2 定义的操作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awswafv2.html#awswafv2-actions-as-permissions)。

要查看 AWS WAF 基于身份的策略的示例，请参阅。[基于身份的策略示例 AWS WAF](security_iam_id-based-policy-examples.md)

## ACLs in AWS WAF
<a name="security_iam_service-with-iam-acls"></a>

**支持 ACLs：**否 

访问控制列表 (ACLs) 控制哪些委托人（账户成员、用户或角色）有权访问资源。 ACLs 与基于资源的策略类似，尽管它们不使用 JSON 策略文档格式。

## ABAC with AWS WAF
<a name="security_iam_service-with-iam-tags"></a>

**支持 ABAC（策略中的标签）：**部分支持

基于属性的访问权限控制（ABAC）是一种授权策略，该策略基于称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和 AWS 资源，然后设计 ABAC 策略以允许在委托人的标签与资源上的标签匹配时进行操作。

要基于标签控制访问，您需要使用 `aws:ResourceTag/key-name``aws:RequestTag/key-name` 或 `aws:TagKeys` 条件键在策略的[条件元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)中提供标签信息。

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

有关 ABAC 的更多信息，请参阅《IAM 用户指南》**中的[使用 ABAC 授权定义权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)。要查看设置 ABAC 步骤的教程，请参阅《IAM 用户指南》**中的[使用基于属性的访问权限控制（ABAC）](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html)。

## 将临时证书与 AWS WAF
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

**支持临时凭证：**是

临时证书提供对 AWS 资源的短期访问权限，并且是在您使用联合身份或切换角色时自动创建的。 AWS 建议您动态生成临时证书，而不是使用长期访问密钥。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的临时安全凭证](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)和[使用 IAM 的。AWS 服务](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)

## 转发服务的访问会话 AWS WAF
<a name="security_iam_service-with-iam-principal-permissions"></a>

**支持转发访问会话（FAS）：**是

 转发访问会话 (FAS) 使用调用主体的权限 AWS 服务，再加上 AWS 服务 向下游服务发出请求的请求。有关发出 FAS 请求时的策略详情，请参阅[转发访问会话](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)。

## 的服务角色 AWS WAF
<a name="security_iam_service-with-iam-roles-service"></a>

**支持服务角色：**是

 服务角色是由一项服务担任、代表您执行操作的 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)。IAM 管理员可以在 IAM 中创建、修改和删除服务角色。有关更多信息，请参阅《IAM 用户指南》**中的[创建向 AWS 服务委派权限的角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。

**警告**  
更改服务角色的权限可能会中断 AWS WAF 功能。只有在 AWS WAF 提供操作指导时才编辑服务角色。

## 的服务相关角色 AWS WAF
<a name="security_iam_service-with-iam-roles-service-linked"></a>

**支持服务关联角色：**是

 服务相关角色是一种链接到的服务角色。 AWS 服务服务可以代入代表您执行操作的角色。服务相关角色出现在您的中 AWS 账户 ，并且归服务所有。IAM 管理员可以查看但不能编辑服务关联角色的权限。

有关创建或管理 AWS WAF 服务相关角色的详细信息，请参阅[将服务相关角色用于 AWS WAF](using-service-linked-roles.md)。