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

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

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

# 将服务相关角色用于 Amazon WAF Classic
<a name="classic-using-service-linked-roles"></a>

**警告**  
Amazon WAF Classic 正在经历计划中的生命周期终结流程。有关您所在地区的里程碑和日期，请参阅您的 Amazon Health 控制面板。

**注意**  
这是 **Amazon WAF Classic** 文档。只有在 2019 年 11 月 Amazon WAF 之前创建了 Amazon WAF 资源（如规则和 Web ACL），并且尚未将其迁移到最新版本时，才应使用此版本。要迁移您的 web ACL，请参阅 [将您的 Amazon WAF 经典资源迁移到 Amazon WAF](waf-migrating-from-classic.md)。  
**有关的最新版本 Amazon WAF，**请参阅[Amazon WAF](waf-chapter.md)。

Amazon WAF 经典用户 Amazon Identity and Access Management (IAM) [服务相关角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服务相关角色是一种独特的 IAM 角色，直接关联到 Cl Amazon WAF assic。 Service-linked 角色由 Amazon WAF Classic 预定义，包括该服务代表您调用其他 Amazon 服务所需的所有权限。

服务相关角色可以更轻松地设置 Amazon WAF Classic，因为您不必手动添加必要的权限。 Amazon WAF Classic 定义了其服务相关角色的权限，除非另有定义，否则只有 Amazon WAF Classic 可以担任其角色。定义的权限包括信任策略和权限策略。这些权限策略不能附加到任何其他 IAM 实体。

只有在先删除角色的相关资源后，才能删除服务相关角色。这样可以保护您的 Amazon WAF 经典资源，因为您不能无意中删除访问这些资源的权限。

有关支持服务相关角色的其它服务的信息，请参阅[使用 IAM 的Amazon 服务](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)并查找**Service-Linked 角色**列中显示为**是**的服务。请选择**是**与查看该服务的服务关联角色文档的链接。

## Service-linked 的角色权限 Amazon WAF Classic
<a name="classic-slr-permissions"></a>

Amazon WAF Classic 使用以下服务相关角色：
+ `AWSServiceRoleForWAFLogging`
+ `AWSServiceRoleForWAFRegionalLogging`

Amazon WAF Classic 使用这些与服务相关的角色将日志写入 Amazon Data Firehose。只有在启用登录功能后才会使用这些角色 Amazon WAF。有关更多信息，请参阅 [记录 Web ACL 流量信息](classic-logging.md)。

`AWSServiceRoleForWAFLogging` 和 `AWSServiceRoleForWAFRegionalLogging` 服务相关角色（分别）信任以下服务以代入该角色：
+ `waf.amazonaws.com`

  `waf-regional.amazonaws.com`

角色的权限策略允许 Amazon WAF Classic 对指定资源完成以下操作：
+ 操作：Amazon Data Firehose 数据流资源上名称以“aws-waf-logs-”开头的 `firehose:PutRecord` 和 `firehose:PutRecordBatch`。例如 `aws-waf-logs-us-east-2-analytics`。
+ 操作：`kms:GenerateDataKey`然后`kms:Decrypt`允许 Amazon Data Firehose 使用客户托管的 Amazon KMS 密钥来加密数据。 Amazon Key Management Service 

您必须配置权限，允许 IAM 实体（如用户、组或角色）创建、编辑或删除服务关联角色。有关更多信息，请参阅 *IAM 用户指南*中的[Service-Linked 角色权限](https://docs.amazonaws.cn/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。

## 为 创建服务相关角色 Amazon WAF Classic
<a name="classic-create-slr"></a>

您无需手动创建服务关联角色。当您在上启用 Classi Amazon WAF c 登录 Amazon Web Services 管理控制台，或者在 Amazon WAF 经典 CLI 或经 Amazon WAF 典 API 中`PutLoggingConfiguration`发出请求时，Cl Amazon WAF assic 会为您创建服务相关角色。

您必须具有 `iam:CreateServiceLinkedRole` 权限以启用日志记录。

如果您删除该服务关联角色，然后需要再次创建，您可以使用相同流程在账户中重新创建此角色。启用 Amazon WAF 经典日志记录后，C Amazon WAF lassic 会再次为您创建服务相关角色。

## 为 编辑服务相关角色 Amazon WAF Classic
<a name="classic-edit-slr"></a>

Amazon WAF Classic 不允许您编辑`AWSServiceRoleForWAFLogging`和`AWSServiceRoleForWAFRegionalLogging`服务相关角色。在创建服务相关角色后，您将无法更改角色的名称，因为可能有多种实体引用该角色。不过，您可以使用 IAM 编辑角色的说明。有关更多信息，请参阅 *IAM 用户指南*中的[编辑 Service-Linked 角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。

## 删除 的服务相关角色 Amazon WAF Classic
<a name="classic-delete-slr"></a>

如果不再需要使用某个需要服务关联角色的功能或服务，我们建议您删除该角色。这样就没有未被主动监控或维护的未使用实体。但是，必须先清除服务相关角色的资源，然后才能手动删除它。

**注意**  
如果您尝试删除资源时，C Amazon WAF lassic 服务正在使用该角色，则删除可能会失败。如果发生这种情况，请等待几分钟后重试。

**删除 Amazon WAF `AWSServiceRoleForWAFLogging`和使用的经典资源 `AWSServiceRoleForWAFRegionalLogging`**

1. 在 Amazon WAF 经典版控制台上，从每个 Web ACL 中删除日志记录。有关更多信息，请参阅 [记录 Web ACL 流量信息](classic-logging.md)。

1. 使用 API 或 CLI，为已启用日志记录的每个 web ACL 提交 `DeleteLoggingConfiguration` 请求。有关更多信息，请参阅 [Amazon WAF Classic API 参考](https://docs.amazonaws.cn/waf/latest/APIReference/Welcome.html)。

**使用 IAM 手动删除服务关联角色**

使用 IAM 控制台、IAM CLI 或 IAM API 删除 `AWSServiceRoleForWAFLogging` 和 `AWSServiceRoleForWAFRegionalLogging` 服务相关角色。有关更多信息，请参阅 *IAM 用户指南*中的[删除Service-Linked 角色](https://docs.amazonaws.cn/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。

## 支持的区域 Amazon WAF 经典服务相关角色
<a name="classic-slr-regions"></a>

Amazon WAF Classic 支持在以下内容 Amazon Web Services 区域中使用服务相关角色。


****  

| 区域名称 | 区域标识 |  Amazon WAF 经典版 Support | 
| --- | --- | --- | 
| 美国东部（弗吉尼亚州北部） | us-east-1 | 是 | 
| 美国东部（俄亥俄州） | us-east-2 | 是 | 
| 美国西部（北加利福尼亚） | us-west-1 | 是 | 
| 美国西部（俄勒冈州） | us-west-2 | 是 | 
| 亚太地区（孟买） | ap-south-1 | 是 | 
| 亚太地区（大阪） | ap-northeast-3 | 是 | 
| 亚太地区（首尔） | ap-northeast-2 | 是 | 
| 亚太地区（新加坡） | ap-southeast-1 | 是 | 
| 亚太地区（悉尼） | ap-southeast-2 | 是 | 
| 亚太地区（东京） | ap-northeast-1 | 是 | 
| 加拿大（中部） | ca-central-1 | 是 | 
| 欧洲地区（法兰克福） | eu-central-1 | 是 | 
| 欧洲地区（爱尔兰） | eu-west-1 | 是 | 
| 欧洲地区（伦敦） | eu-west-2 | 是 | 
| 欧洲地区（巴黎） | eu-west-3 | 是 | 
| 南美洲（圣保罗） | sa-east-1 | 是 | 
| 中国（北京） | cn-north-1 | 否 |