

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

# Amazon Polly 基于身份的策略示例
<a name="security_iam_id-based-policy-examples"></a>

原定设置情况下，用户和角色没有创建或修改 Amazon Polly 资源的权限。要授予用户对所需资源执行操作的权限，IAM 管理员可以创建 IAM 策略。

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》**中的[创建 IAM 策略（控制台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。

*有关 Amazon Polly 定义的操作和资源类型（包括每种资源类型的格式）的详细信息，请参阅《服务授权参考》中的 [Amazon Polly 的操作、资源和条件密钥](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonpolly.html)。 ARNs *

**Topics**
+ [策略最佳实践](#security_iam_service-with-iam-policy-best-practices)
+ [使用 Amazon Polly 控制台](#security_iam_id-based-policy-examples-console)
+ [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions)
+ [AWS 适用于 Amazon Polly 的托管（预定义）策略](#access-policy-aws-managed-policies)
+ [客户管理型策略示例](#access-policy-customer-managed-examples)

## 策略最佳实践
<a name="security_iam_service-with-iam-policy-best-practices"></a>

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 Amazon Polly 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：
+ **开始使用 AWS 托管策略并转向最低权限权限** — 要开始向用户和工作负载授予权限，请使用为许多常见用例授予权限的*AWS 托管策略*。它们在你的版本中可用 AWS 账户。我们建议您通过定义针对您的用例的 AWS 客户托管策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》**中的 [AWS 托管策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)或[工作职能的AWS 托管策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)。
+ **应用最低权限**：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为*最低权限许可*。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的策略和权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
+ **使用 IAM 策略中的条件进一步限制访问权限**：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定的方式使用的，则也可以使用条件来授予对服务操作的访问权限 AWS 服务，例如 CloudFormation。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素：条件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)。
+ **使用 IAM Access Analyzer 验证您的 IAM 策略，以确保权限的安全性和功能性**：IAM Access Analyzer 会验证新策略和现有策略，以确保策略符合 IAM 策略语言（JSON）和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议，以帮助您制定安全且功能性强的策略。有关更多信息，请参阅《IAM 用户指南》**中的[使用 IAM Access Analyzer 验证策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。
+ **需要多重身份验证 (MFA**)-如果 AWS 账户您的场景需要 IAM 用户或根用户，请启用 MFA 以提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》**中的[使用 MFA 保护 API 访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)。

有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的安全最佳实践](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)。

## 使用 Amazon Polly 控制台
<a name="security_iam_id-based-policy-examples-console"></a>

要访问 Amazon Polly 控制台，您必须具有一组最低的权限。这些权限必须允许您列出和查看有关您的 Amazon Polly 资源的详细信息。 AWS 账户如果创建比必需的最低权限更为严格的基于身份的策略，对于附加了该策略的实体（用户或角色），控制台将无法按预期正常运行。

对于仅调用 AWS CLI 或 AWS API 的用户，您无需为其设置最低控制台权限。相反，只允许访问与其尝试执行的 API 操作相匹配的操作。

为确保用户和角色仍然可以使用 Amazon Polly 控制台，还需要为实体附加 Amazon `ConsoleAccess` Polly `ReadOnly` AWS 或托管策略。有关更多信息，请参阅《IAM 用户指南》**中的[为用户添加权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)。

要使用 Amazon Polly 控制台，请向所有 Amazon Polly 授予权限。 APIs不需要额外的权限。要获取完整的控制台功能，您可以使用以下策略：

## 允许用户查看他们自己的权限
<a name="security_iam_id-based-policy-examples-view-own-permissions"></a>

该示例说明了您如何创建策略，以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用 AWS CLI 或 AWS API 以编程方式完成此操作的权限。

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}
```

## AWS 适用于 Amazon Polly 的托管（预定义）策略
<a name="access-policy-aws-managed-policies"></a>

AWS 通过提供由创建和管理的独立 IAM 策略来解决许多常见用例 AWS。这些 AWS 托管策略为常见用例授予必要的权限，这样您就可以不必调查需要哪些权限。有关更多信息，请参阅《IAM 用户指南》**中的 [AWS 托管式策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)。

以下 AWS 托管政策仅适用于 Amazon Polly，您可以将其附加到账户中的用户：
+ **AmazonPollyReadOnlyAccess**— 授予对资源的只读访问权限，允许列出词典、获取词典、列出可用语音和合成语音（包括将词典应用于合成语音）。
+ **AmazonPollyFullAccess**— 授予对资源和所有支持的操作的完全访问权限。

**注意**  
您可以通过登录到 IAM 控制台并在该控制台中搜索特定策略来查看这些权限策略。

此外，您还可以创建您自己的自定义 IAM 策略，以授予 Amazon Polly 操作和资源的相关权限。您可以将这些自定义策略附加到需要这些权限的 IAM 用户或组。

## 客户管理型策略示例
<a name="access-policy-customer-managed-examples"></a>

本节的用户策略示例介绍如何授予各 Amazon Polly 操作的权限。这些政策在您使用 AWS SDKs 或时起作用 AWS CLI. 当你使用主机时，请向所有 Amazon Pol APIs ly 授予权限。

**注意**  
所有示例都使用 us-east-2 区域并包含虚构账户。 IDs

**Topics**
+ [示例 1：允许所有 Amazon Polly 操作](#example-managed-policy-service-admin)
+ [示例 2：允许所有 Amazon Polly 操作除外 DeleteLexicon](#example-managed-policy-full-permissions-no-delete)
+ [示例 3：允许 DeleteLexicon](#example-managed-policy-delete-all-regions)
+ [示例 4：允许在指定区域中删除词典](#example-managed-policy-delete-one-region)
+ [示例 5：允许使用 DeleteLexicon 指定的词典](#example-managed-policy-delete-specific-lexicon)

### 示例 1：允许所有 Amazon Polly 操作
<a name="example-managed-policy-service-admin"></a>

在您注册后（请参阅 [Amazon Polly 入门](getting-started.md)），创建管理员用户来管理您的账户，包括创建用户和管理用户权限。

您可以创建对所有 Amazon Polly 操作具有权限的用户。将此用户视为特定于服务的管理员，以便使用 Amazon Polly。您可以将以下权限策略附加到该用户。

------
#### [ JSON ]

****  

```
{
   "Version":"2012-10-17",		 	 	 
   "Statement": [{
      "Sid": "AllowAllPollyActions",
      "Effect": "Allow",
      "Action": [
         "polly:*"],
      "Resource": "*"
      }
   ]
}
```

------

### 示例 2：允许所有 Amazon Polly 操作除外 DeleteLexicon
<a name="example-managed-policy-full-permissions-no-delete"></a>

以下权限策略用于授予用户执行所有操作（`DeleteLexicon` 除外）的用户权限，以及在所有区域中删除显式拒绝的权限。

### 示例 3：允许 DeleteLexicon
<a name="example-managed-policy-delete-all-regions"></a>

以下权限策略用于授予删除任何词典用户的权限，无论其位于哪个项目或区域中。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [{
      "Sid": "AllowDeleteLexicon",
      "Effect": "Allow",
      "Action": [
         "polly:DeleteLexicon"],
      "Resource": "*"
      }
   ]
}
```

------

### 示例 4：允许在指定区域中删除词典
<a name="example-managed-policy-delete-one-region"></a>

以下权限策略授予用户删除您位于单个区域（在本例中为 us-east-2）的任何项目中您拥有的任何词典的权限。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [{
      "Sid": "AllowDeleteSpecifiedRegion",
      "Effect": "Allow",
      "Action": [
         "polly:DeleteLexicon"],
      "Resource": "arn:aws:polly:us-east-2:111122223333:lexicon/*"
      }
   ]
}
```

------

### 示例 5：允许使用 DeleteLexicon 指定的词典
<a name="example-managed-policy-delete-specific-lexicon"></a>

以下权限策略授予用户删除您在特定区域（在本例中为us-east-2）中拥有的特定词典 (在本例中为 myLexicon) 的权限。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [{
      "Sid": "AllowDeleteForSpecifiedLexicon",
      "Effect": "Allow",
      "Action": [
         "polly:DeleteLexicon"],
      "Resource": "arn:aws:polly:us-east-2:111122223333:lexicon/myLexicon"
      }
   ]
}
```

------