サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日を過ぎると、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにはアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに [Amazon Lex V2 ガイド](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Lex で IAM を使用する方法
IAM を使用して Amazon Lex へのアクセスを管理する前に、Amazon Lex で利用できる IAM の機能について学習します。
**Amazon Lex で使用できる IAM の機能**
| IAM 機能 | Amazon Lex のサポート |
| --- | --- |
| [アイデンティティベースのポリシー](#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) | はい |
| [ACL](#security_iam_service-with-iam-acls) | なし |
| [ABAC (ポリシー内のタグ)](#security_iam_service-with-iam-tags) | 部分的 |
| [一時認証情報](#security_iam_service-with-iam-roles-tempcreds) | あり |
| [プリンシパルアクセス権限](#security_iam_service-with-iam-principal-permissions) | あり |
| [サービスロール](#security_iam_service-with-iam-roles-service) | あり |
| [サービスリンクロール](#security_iam_service-with-iam-roles-service-linked) | はい |
Amazon Lex およびその他の AWS のサービスがほとんどの IAM 機能と連携する方法の概要については、「IAM *ユーザーガイド*」の[AWS 「IAM と連携する のサービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。
## Amazon Lex のアイデンティティベースのポリシー
**アイデンティティベースのポリシーのサポート:** あり
アイデンティティベースポリシーは、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)」を参照してください。
### Amazon Lex のアイデンティティベースのポリシー例
Amazon Lex のアイデンティティベースポリシーの例を確認するには、「[Amazon Lex のアイデンティティベースのポリシー例](security_iam_id-based-policy-examples.md)」を参照してください。
## Amazon Lex 内のリソースベースのポリシー
**リソースベースのポリシーのサポート:** なし
リソースベースのポリシーは、リソースに添付する 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)を参照してください。
## Amazon Lex のポリシーアクション
**ポリシーアクションのサポート:** あり
管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件下で****アクション**を実行できるかということです。
JSON ポリシーの `Action` 要素にはポリシー内のアクセスを許可または拒否するために使用できるアクションが記述されます。このアクションは関連付けられたオペレーションを実行するためのアクセス許可を付与するポリシーで使用されます。
Amazon Lex アクションのリストを確認するには、*「サービス認可リファレンス*」の[Amazon Lexで定義されるアクション](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-actions-as-permissions)」を参照してください。
Amazon Lex のポリシーアクションは、アクションの前にプレフィックス を使用します。
```
lex
```
単一のステートメントで複数のアクションを指定するには、アクションをカンマで区切ります。
```
"Action": [
"lex:{{action1}}",
"lex:{{action2}}"
]
```
ワイルドカード (\*) を使用して複数アクションを指定できます。例えば、`Describe` という単語で始まるすべてのアクションを指定するには次のアクションを含めます。
```
"Action": "lex:Describe*"
```
## Amazon Lex のポリシーリソース
**ポリシーリソースのサポート:** あり
管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件**下で**アクション**を実行できるかということです。
`Resource` JSON ポリシー要素はアクションが適用されるオブジェクトを指定します。ベストプラクティスとして、[Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) を使用してリソースを指定します。リソースレベルのアクセス許可をサポートしないアクションの場合は、ステートメントがすべてのリソースに適用されることを示すために、ワイルドカード (\*) を使用します。
```
"Resource": "*"
```
Amazon Lex ボットのリソースの ARN は、次の形式になります。
```
arn:aws:lex:${Region}:${Account}:bot:${Bot-Name}
```
ARN の形式の詳細については、[「Amazon リソースネーム (ARNs)」と AWS 「サービス名前空間](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)」を参照してください。
例えば、ステートメントで `OrderFlowers` ボットを指定するには、次の ARN を使用します。
```
"Resource": "arn:aws:lex:us-east-2:123456789012:bot:OrderFlowers"
```
特定のアカウントに属するすべてのボットを指定するには、ワイルドカード (\*) を使用します。
```
"Resource": "arn:aws:lex:us-east-2:123456789012:bot:*"
```
リソースの作成など、一部の Amazon Lex アクションは、特定のリソースで実行できません。このような場合は、ワイルドカード (\*) を使用する必要があります。
```
"Resource": "*"
```
Amazon Lex リソースタイプとその ARNs[Amazon Lexで定義されるリソース](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-resources-for-iam-policies)」を参照してください。 **どのアクションで各リソースの ARN を指定できるかについては、[「Amazon Lex で定義されるアクション」](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-actions-as-permissions)を参照してください。
## Amazon Lex のポリシー条件キー
**サービス固有のポリシー条件キーのサポート:** あり
管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件下で****アクション**を実行できるかということです。
`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)」を参照してください。
Amazon Lex 条件キーのリストを確認するには、*「サービス認可リファレンス*」の[Amazon Lexの条件キー](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-policy-keys)」を参照してください。条件キーを使用できるアクションとリソースについては、「[Amazon Lex で定義されるアクション](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-actions-as-permissions)」を参照してください。
以下の表では、Amazon Lex リソースに適用される Amazon Lex 条件キーを一覧表示しています。これらのキーは、IAM アクセス権限ポリシーの `Condition` 要素に含めることができます。
****
| Amazon Lex 条件キー | 説明 | 値の型 | アクセス許可 |
| --- | --- | --- | --- |
| lex:associatedIntents | ボットの定義を作成または変更するときに使用できる一連のインテントが対象です。 | 文字列の配列 | `lex:PutBot` |
| lex:associatedSlotTypes | スロットタイプの定義を作成または変更するときに使用できる一連のスロットタイプが対象です。 | 文字列の配列 | `lex:PutIntent` |
| lex:ChannelType | ユーザーが作成、取得、または削除できるボットチャンネル関連付けのタイプが対象です。 | String | `lex:CreateBotChannelAssociation`
`lex:DeleteBotChannelAssociation`
`lex:GetBotChannelAssociation` |
## Amazon Lex での ACL
**ACL のサポート:** なし
アクセスコントロールリスト (ACL) は、どのプリンシパル (アカウントメンバー、ユーザー、またはロール) がリソースにアクセスするためのアクセス許可を持つかを制御します。ACL はリソースベースのポリシーに似ていますが、JSON ポリシードキュメント形式は使用しません。
## Amazon Lex での ABAC
**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)でタグ情報を提供します。
サービスがすべてのリソースタイプに対して 3 つの条件キーすべてをサポートする場合、そのサービスの値は**あり**です。サービスが一部のリソースタイプに対してのみ 3 つの条件キーのすべてをサポートする場合、値は「**部分的**」になります。
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)」を参照してください。
承認のために、特定のタイプの Amazon Lex リソースにタグを関連付けることができます。タグに基づいてアクセスをコントロールするには、`lex:ResourceTag/${TagKey}`、`aws:RequestTag/${TagKey}`、または `aws:TagKeys` 条件キーを使用して、ポリシーの条件要素でタグ情報を提供します。
Amazon Lex リソースのタグ付けの詳細については、「[Amazon Lex リソースのタグ付け](how-it-works-tags.md)」を参照してください。
リソースのタグに基づいてリソースへのアクセスを制限するためのアイデンティティベースポリシーの例を表示するには、「[タグを使用したリソースへのアクセス](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-tag)」を参照してください。
次の表に、タグベースのアクセスコントロールのアクションと対応するリソースタイプを示します。各アクションは、対応するリソースタイプに関連付けられたタグに基づいて許可されます。
| Action | リソースタイプ | 条件キー | 注意事項 |
| --- | --- | --- | --- |
| [CreateBotVersion](API_CreateBotVersion.md) | ボット | lex:ResourceTag | |
| [DeleteBot](API_DeleteBot.md) | ボット | lex:ResourceTag | |
| [DeleteBotAlias](API_DeleteBotAlias.md) | alias | lex:ResourceTag | |
| [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) | チャンネル | lex:ResourceTag | |
| [DeleteBotVersion](API_DeleteBotVersion.md) | ボット | lex:ResourceTag | |
| [DeleteSession](API_runtime_DeleteSession.md) | ボットまたはエイリアス | lex:ResourceTag | エイリアスが $LATEST に設定されている場合、ボットに関連付けられたタグを使用します。他のエイリアスと共に使用する場合は、指定したエイリアスに関連付けられたタグを使用します。 |
| [DeleteUtterances](API_DeleteUtterances.md) | ボット | lex:ResourceTag | |
| [GetBot](API_GetBot.md) | ボットまたはエイリアス | lex:ResourceTag | versionOrAlias が $LATEST または数値バージョンに設定されている場合、ボットに関連付けられたタグを使用します。エイリアスと共に使用する場合は、指定したエイリアスに関連付けられたタグを使用します。 |
| [GetBotAlias](API_GetBotAlias.md) | alias | lex:ResourceTag | |
| [GetBotChannelAssociation](API_GetBotChannelAssociation.md) | チャンネル | lex:ResourceTag | |
| [GetBotChannelAssociations](API_GetBotChannelAssociations.md) | チャンネル | lex:ResourceTag | エイリアスが "-" に設定されている場合、ボットに関連付けられたタグを使用します。ボットエイリアスが指定されている場合は、指定したエイリアスに関連付けられたタグを使用します。 |
| [GetBotVersions](API_GetBotVersions.md) | ボット | lex:ResourceTag | |
| [GetExport](API_GetExport.md) | ボット | lex:ResourceTag | |
| [GetSession](API_runtime_GetSession.md) | ボットまたはエイリアス | lex:ResourceTag | エイリアスが $LATEST に設定されている場合、ボットに関連付けられたタグを使用します。他のエイリアスと共に使用する場合は、指定したエイリアスに関連付けられたタグを使用します。 |
| [GetUtterancesView](API_GetUtterancesView.md) | ボット | lex:ResourceTag | |
| [ListTagsForResource](API_ListTagsForResource.md) | ボット、エイリアス、またはチャンネル | lex:ResourceTag | |
| [PostContent](API_runtime_PostContent.md) | ボットまたはエイリアス | lex:ResourceTag | エイリアスが $LATEST に設定されている場合、ボットに関連付けられたタグを使用します。他のエイリアスと共に使用する場合は、指定したエイリアスに関連付けられたタグを使用します。 |
| [PostText](API_runtime_PostText.md) | ボットまたはエイリアス | lex:ResourceTag | エイリアスが $LATEST に設定されている場合、ボットに関連付けられたタグを使用します。他のエイリアスと共に使用する場合は、指定したエイリアスに関連付けられたタグを使用します。 |
| [PutBot](API_PutBot.md) | ボット | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
| [PutBotAlias](API_PutBotAlias.md) | alias | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
| [PutSession](API_runtime_PutSession.md) | ボットまたはエイリアス | lex:ResourceTag | エイリアスが $LATEST に設定されている場合、ボットに関連付けられたタグを使用します。他のエイリアスと共に使用する場合は、指定したエイリアスに関連付けられたタグを使用します。 |
| [StartImport](API_StartImport.md) | ボット | lex:ResourceTag | PutBot オペレーションのアクセスポリシーに依存します。StartImport オペレーションに固有のタグとアクセス許可は無視されます。 |
| [TagResource](API_TagResource.md) | ボット、エイリアス、またはチャンネル | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
| [UntagResource](API_UntagResource.md) | ボット、エイリアス、またはチャンネル | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
## Amazon Lex での一時的な認証情報の使用
**一時的な認証情報のサポート:** あり
一時的な認証情報は、 AWS リソースへの短期的なアクセスを提供し、フェデレーションまたはスイッチロールの使用時に自動的に作成されます。長期的なアクセスキーを使用する代わりに、一時的な認証情報を動的に生成 AWS することをお勧めします。詳細については、「*IAM ユーザーガイド*」の「[IAM の一時的な認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)」および「[AWS のサービス と IAM との連携](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。
一時的な認証情報を使用して、フェデレーションでサインインする、IAM 役割を引き受ける、またはクロスアカウント役割を引き受けることができます。一時的なセキュリティ認証情報を取得するには、[AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) や [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html) などの AWS STS API オペレーションを呼び出します。
## Amazon Lex のクロスサービスプリンシパルのアクセス許可
**転送アクセスセッション (FAS) のサポート:** あり
転送アクセスセッション (FAS) は、 を呼び出すプリンシパルのアクセス許可と AWS のサービス、ダウンストリームサービス AWS のサービス へのリクエストをリクエストする を使用します。FAS リクエストを行う際のポリシーの詳細については、「[転送アクセスセッション](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html)」を参照してください。
## Amazon Lex のサービスロール
**サービスロールのサポート:** あり
サービスロールとは、サービスがユーザーに代わってアクションを実行するために引き受ける [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)を参照してください。
**警告**
サービスロールのアクセス許可を変更すると、Amazon Lex の機能が破損する可能性があります。Amazon Lex が指示する場合以外は、サービスロールを編集しないでください。
### Amazon Lex での IAM ロールの選択
Amazon Lex は、Amazon Comprehend と Amazon Polly を呼び出すために、サービスリンクされたロールを使用しています。 AWS Lambda 関数に対するリソースレベルのアクセス許可を使用して関数を呼び出します。
会話のタグ付けを有効にするには、IAM ロールを指定する必要があります。詳細については、「[会話ログ用の IAM ロールとポリシーの作成](conversation-logs-policies.md#conversation-logs-role-and-policy)」を参照してください。
## Amazon Lex のサービスリンクロール
**サービスリンクロールのサポート:** あり
サービスにリンクされたロールは、 にリンクされたサービスロールの一種です AWS のサービス。サービスは、ユーザーに代わってアクションを実行するロールを引き受けることができます。サービスにリンクされたロールは に表示され AWS アカウント 、サービスによって所有されます。IAM 管理者は、サービスリンクロールのアクセス許可を表示できますが、編集することはできません。
Amazon Lex でのサービスにリンクされたロールの作成または管理の詳細については、「[Amazon Lex のサービスリンクロールの使用](using-service-linked-roles.md)」を参照してください。