

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 が定義するアクションとリソースタイプ (リソースタイプごとの ARN の形式を含む) の詳細については、「*サービス認可リファレンス*」の「[Amazon Polly のアクション、リソース、および条件キー](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonpolly.html)」を参照してください。

**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>

ID ベースのポリシーは、ユーザーのアカウント内で誰かが 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 アクセスアナライザー を使用して IAM ポリシーを検証し、安全で機能的な権限を確保する** - IAM アクセスアナライザー は、新規および既存のポリシーを検証して、ポリシーが IAM ポリシー言語 (JSON) および IAM のベストプラクティスに準拠するようにします。IAM アクセスアナライザーは 100 を超えるポリシーチェックと実用的な推奨事項を提供し、安全で機能的なポリシーの作成をサポートします。詳細については、*IAM ユーザーガイド* の [IAM Access Analyzer でポリシーを検証する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html) を参照してください。
+ **多要素認証 (MFA) を要求する** – で IAM ユーザーまたはルートユーザーを必要とするシナリオがある場合は AWS アカウント、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 Polly `ConsoleAccess`または `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 API にアクセス許可を付与します。必要な追加のアクセス権限はありません。コンソールの完全な機能を得るには、以下のポリシーを使用できます。

## 自分の権限の表示をユーザーに許可する
<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 Polly のすべての API にアクセス許可を付与します。

**注記**  
すべての例で、us-east-2 リージョンを使用し、架空のアカウント ID を含めています。

**Topics**
+ [例 1: すべての Amazon Polly アクションを許可する](#example-managed-policy-service-admin)
+ [例 2: DeleteLexicon を除くすべての Amazon Polly アクションを許可する](#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: DeleteLexicon を除くすべての Amazon Polly アクションを許可する
<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>

以下のアクセス許可ポリシーは、1 つのリージョン (この場合は 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"
      }
   ]
}
```

------