翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Translate のアイデンティティベースのポリシーの例
デフォルトでは、ユーザーおよびロールには Amazon Translate リソースを作成または変更するアクセス許可がありません。また、 AWS マネジメントコンソール、 AWS CLI、または AWS API を使用してタスクを実行することはできません。IAM 管理者は、指定されたリソースに対して特定の API オペレーションを実行するために必要なアクセス許可を付与する IAM ポリシーを作成する必要があります。続いて、管理者はそれらのアクセス許可が必要な ユーザーまたはロールに、そのポリシーをアタッチします。
JSON ポリシードキュメントのこれらの例を使用して、IAM アイデンティティベースのポリシーを作成する方法については、*IAM ユーザーガイド*の「[JSON タブでのポリシーの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)」を参照してください。
**Topics**
+ [アイデンティティベースのポリシーのベストプラクティス](#security_iam_service-with-iam-policy-best-practices)
+ [Amazon Translate コンソールへのアクセスを許可する](#security_iam_id-based-policy-examples-console)
+ [自分の権限の表示をユーザーに許可する](#security_iam_id-based-policy-examples-view-own-permissions)
+ [ポリシーでのリソースの指定](#iam_id-policy-examples-resource-permissions)
+ [カスタム用語でカスタマーマネージドキーを使用するためのアクセス許可](#kms-permissions)
## アイデンティティベースのポリシーのベストプラクティス
アイデンティティベースのポリシーは、ユーザーのアカウント内で誰かが Amazon Translate リソースを作成、アクセス、または削除できるどうかを決定します。これらのアクションでは、 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 Translate コンソールへのアクセスを許可する
Amazon Translate コンソールにアクセスするには、許可の最小限のセットが必要です。これらのアクセス許可により、 AWS アカウントの Amazon Translate リソースの詳細を一覧表示および表示できます。最小限必要な許可よりも制限が厳しいアイデンティティベースのポリシーを作成すると、そのポリシーを持つエンティティ (ユーザー、グループ、またはロール) に対してコンソールが意図したとおりに機能しません。
Amazon Translate コンソールのアクセス許可については、`TranslateFullAccess` AWS 管理ポリシーをエンティティにアタッチできます。詳細については、「[AWS Amazon Translate の マネージドポリシー](security-iam-awsmanpol.md)」を参照してください。
また、次のポリシーに示すアクションにアクセス許可を付与する必要があります。これらのアクセス許可は、`TranslateFullAccess` ポリシーに含まれています。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:ListRoles",
"iam:GetRole",
"s3:ListAllMyBuckets",
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource": "*"
}
]
}
```
------
AWS CLI または AWS API のみを呼び出すユーザーには、最小限のコンソールアクセス許可を付与する必要はありません。代わりに、実行しようとしている API オペレーションに一致するアクションのみへのアクセスが許可されます。詳細については、「IAM ユーザーガイド」の「[ユーザーへのアクセス許可の追加](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)」を参照してください。
## 自分の権限の表示をユーザーに許可する
この例では、ユーザーアイデンティティにアタッチされたインラインおよびマネージドポリシーの表示を 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": "*"
}
]
}
```
## ポリシーでのリソースの指定
多くの Amazon Translate API アクションでは、アクションで許可されている (または許可されていない) リソースを指定することによって、ポリシーの範囲を制限できます。リソースを指定できるアクションのリストについては、「[Amazon Translate で定義されるアクション](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazontranslate.html#amazontranslate-actions-as-permissions)」を参照してください。ポリシーでは以下のリソースを指定できます。
+ **Custom terminology** - 次の ARN 形式を使用します。
`arn:partition:translate:region:account:terminology/terminology-name/LATEST`
+ **Parallel data** - 次の ARN 形式を使用します。
`arn:partition:translate:region:account:parallel-data/parallel-data-name`
ワイルドカード文字を使用すると、ポリシーで複数のリソースを指定できます。以下のポリシー例では、すべての Amazon Translate アクションに対してすべてのカスタム用語リソースを許可します。
**Example**
```
{
"Sid": "Example1",
"Effect": "Allow",
"Action": "translate:*",
"Resource": [
"arn:aws:translate:us-west-2:123456789012:terminology/*"
]
}
```
次のポリシー例では、**GetParallelData** アクションの特定の並列データリソースへのアクセスを拒否します。
**Example**
```
{
"Sid": "Example2",
"Effect": "Deny",
"Action": "translate:GetParallelData",
"Resource": [
"arn:aws:translate:us-west-2:123456789012:parallel-data/test-parallel-data"
]
}
```
## カスタム用語でカスタマーマネージドキーを使用するためのアクセス許可
Amazon Translate カスタム用語で AWS Key Management Service (AWS KMS) カスタマーマネージドキーを使用する場合は、KMS キーポリシーに追加のアクセス許可が必要になる場合があります。
カスタマーマネージドキーを使用して `ImportTerminology` オペレーションを呼び出すには、既存の KMS キーポリシーに以下のアクセス許可を追加します。
------
#### [ JSON ]
****
```
{
"Id": "key-consolepolicy-3",
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow access for use with Amazon Translate",
"Effect": "Allow",
"Principal": {
"AWS": "IAM USER OR ROLE ARN"
},
"Action": [
"kms:CreateAlias",
"kms:CreateGrant",
"kms:DescribeKey",
"kms:GenerateDataKey",
"kms:GetKeyPolicy",
"kms:PutKeyPolicy",
"kms:RetireGrant"
],
"Resource": "*"
}
]
}
```
------
KMS カスタマーマネージドキーでインポートされたカスタム用語に対して `GetTerminology` オペレーションを呼び出すには、KMS キーポリシーに以下のアクセス許可を追加します。
------
#### [ JSON ]
****
```
{
"Id": "key-consolepolicy-3",
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow access for use with Amazon Translate",
"Effect": "Allow",
"Principal": {
"AWS": "IAM USER OR ROLE ARN"
},
"Action": [
"kms:Decrypt",
"kms:GetKeyPolicy",
"kms:PutKeyPolicy"
],
"Resource": "*"
}
]
}
```
------
カスタマーマネージドキーでインポートされたカスタム用語の `ListTerminologies`または `DeleteTermionlogy`オペレーションを呼び出すには、特別な AWS KMS アクセス許可は必要ありません。
すべてのカスタム用語オペレーションでカスタマーマネージドキーを使用するには、KMS キーポリシーに以下のアクセス許可を追加します。
------
#### [ JSON ]
****
```
{
"Id": "key-consolepolicy-3",
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Allow access for use with Amazon Translate",
"Effect": "Allow",
"Principal": {
"AWS": "IAM USER OR ROLE ARN"
},
"Action": [
"kms:CreateGrant",
"kms:Decrypt",
"kms:DescribeKey",
"kms:GenerateDataKey",
"kms:GetKeyPolicy",
"kms:PutKeyPolicy",
"kms:RetireGrant"
],
"Resource": "*"
}
]
}
```
------
Amazon Translate のオペレーションとリソースの詳細については、*「サービス認可リファレンス*」の[Amazon Translate のアクション、リソース、および条件キー](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazontranslate.html)」を参照してください。