Aviso de fin de soporte: el 15 de septiembre de 2025, AWS dejaremos de ofrecer soporte para Amazon Lex V1. Después del 15 de septiembre de 2025, ya no podrá acceder a la consola de Amazon Lex V1 ni a los recursos de Amazon Lex V1. Si utiliza Amazon Lex V2, consulte en su lugar la [guía Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Cómo funciona Amazon Lex con IAM
Antes de utilizar IAM para administrar el acceso a Amazon Lex, obtenga información sobre qué características de IAM se encuentran disponibles con Amazon Lex.
**Características de IAM que puede utilizar con Amazon Lex**
| Característica de IAM | Soporte de Amazon Lex V2 |
| --- | --- |
| [Políticas basadas en identidades](#security_iam_service-with-iam-id-based-policies) | Sí |
| [Políticas basadas en recursos](#security_iam_service-with-iam-resource-based-policies) | No |
| [Acciones de políticas](#security_iam_service-with-iam-id-based-policies-actions) | Sí |
| [Recursos de políticas](#security_iam_service-with-iam-id-based-policies-resources) | Sí |
| [Claves de condición de política (específicas del servicio)](#security_iam_service-with-iam-id-based-policies-conditionkeys) | Sí |
| [ACLs](#security_iam_service-with-iam-acls) | No |
| [ABAC (etiquetas en políticas)](#security_iam_service-with-iam-tags) | Parcial |
| [Credenciales temporales](#security_iam_service-with-iam-roles-tempcreds) | Sí |
| [Permisos de entidades principales](#security_iam_service-with-iam-principal-permissions) | Sí |
| [Roles de servicio](#security_iam_service-with-iam-roles-service) | Sí |
| [Roles vinculados al servicio](#security_iam_service-with-iam-roles-service-linked) | Sí |
Para obtener una visión general de cómo funcionan Amazon Lex y otros AWS servicios con la mayoría de las funciones de IAM, consulte [AWS los servicios que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la Guía del usuario de *IAM*.
## Políticas de Amazon Lex basadas en identidades
**Compatibilidad con las políticas basadas en identidad:** sí
Las políticas basadas en identidad son documentos de políticas de permisos JSON que puede asociar a una identidad, como un usuario de IAM, un grupo de usuarios o un rol. Estas políticas controlan qué acciones pueden realizar los usuarios y los roles, en qué recursos y en qué condiciones. Para obtener más información sobre cómo crear una política basada en la identidad, consulte [Definición de permisos de IAM personalizados con políticas administradas por el cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) en la *Guía del usuario de IAM*.
Con las políticas basadas en identidades de IAM, puede especificar las acciones y los recursos permitidos o denegados, así como las condiciones en las que se permiten o deniegan las acciones. Para obtener más información sobre los elementos que puede utilizar en una política de JSON, consulte [Referencia de los elementos de la política de JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) en la *Guía del usuario de IAM*.
### Ejemplos de políticas basadas en identidades para Amazon Lex
Para ver ejemplos de políticas basadas en identidad de Amazon Lex, consulte [Ejemplos de políticas basadas en identidades para Amazon Lex](security_iam_id-based-policy-examples.md).
## Políticas de Amazon Lex basadas en recursos
**Admite políticas basadas en recursos:** no
Las políticas basadas en recursos son documentos de política JSON que se asocian a un recurso. Los ejemplos de políticas basadas en recursos son las *políticas de confianza de roles* de IAM y las *políticas de bucket* de Amazon S3. En los servicios que admiten políticas basadas en recursos, los administradores de servicios pueden utilizarlos para controlar el acceso a un recurso específico. Para el recurso al que se asocia la política, la política define qué acciones puede realizar una entidad principal especificada en ese recurso y en qué condiciones. Debe [especificar una entidad principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) en una política basada en recursos. Los directores pueden incluir cuentas, usuarios, roles, usuarios federados o. Servicios de AWS
Para habilitar el acceso entre cuentas, puede especificar toda una cuenta o entidades de IAM de otra cuenta como la entidad principal de una política en función de recursos. Para obtener más información, consulte [Acceso a recursos entre cuentas en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) en la *Guía del usuario de IAM*.
## Acciones de políticas para Amazon Lex
**Compatibilidad con las acciones de políticas:** sí
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.
El elemento `Action` de una política JSON describe las acciones que puede utilizar para conceder o denegar el acceso en una política. Incluya acciones en una política para conceder permisos y así llevar a cabo la operación asociada.
Para ver una lista de las acciones de Amazon Lex, consulte [Acciones definidas por Amazon Lex](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-actions-as-permissions) en la *Referencia de autorizaciones de servicio*.
Las acciones de políticas de Amazon Lex utilizan el siguiente prefijo antes de la acción:
```
lex
```
Para especificar varias acciones en una única instrucción, sepárelas con comas.
```
"Action": [
"lex:action1",
"lex:action2"
]
```
Puede utilizar caracteres comodín (\$1) para especificar varias acciones . Por ejemplo, para especificar todas las acciones que comiencen con la palabra `Describe`, incluya la siguiente acción:
```
"Action": "lex:Describe*"
```
## Recursos de políticas para Amazon Lex
**Compatibilidad con los recursos de políticas:** sí
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.
El elemento `Resource` de la política JSON especifica el objeto u objetos a los que se aplica la acción. Como práctica recomendada, especifique un recurso utilizando el [Nombre de recurso de Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). En el caso de las acciones que no admiten permisos por recurso, utilice un carácter comodín (\$1) para indicar que la instrucción se aplica a todos los recursos.
```
"Resource": "*"
```
Un ARN de un recurso de bot de Amazon Lex tiene el siguiente formato.
```
arn:aws:lex:${Region}:${Account}:bot:${Bot-Name}
```
Para obtener más información sobre el formato de ARNs, consulte [Amazon Resource Names (ARNs) y AWS Service Namespaces](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Por ejemplo, para especificar el bot de `OrderFlowers` en su instrucción, utilice el siguiente ARN.
```
"Resource": "arn:aws:lex:us-east-2:123456789012:bot:OrderFlowers"
```
Para especificar todos los bots que pertenecen a una cuenta específica, utilice el carácter comodín (\$1).
```
"Resource": "arn:aws:lex:us-east-2:123456789012:bot:*"
```
Algunas acciones de Amazon Lex, como las que se utilizan para crear recursos, no se pueden llevar a cabo en un recurso específico. En dichos casos, debe utilizar el carácter comodín, (\$1).
```
"Resource": "*"
```
Para ver una lista de los tipos de recursos de Amazon Lex y sus tipos ARNs, consulte [Recursos definidos por Amazon Lex](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-resources-for-iam-policies) en la *Referencia de autorización de servicio*. Para obtener información acerca de las acciones con las que puede especificar el ARN de cada recurso, consulte [Acciones definidas por Amazon Lex](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-actions-as-permissions).
## Claves de condiciones de políticas para Amazon Lex
**Compatibilidad con claves de condición de políticas específicas del servicio:** sí
Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.
El elemento `Condition` especifica cuándo se ejecutan las instrucciones en función de criterios definidos. Puede crear expresiones condicionales que utilizan [operadores de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), tales como igual o menor que, para que la condición de la política coincida con los valores de la solicitud. Para ver todas las claves de condición AWS globales, consulte las claves de [contexto de condición AWS globales](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) en la *Guía del usuario de IAM*.
Para ver una lista de las claves de condición de Amazon Lex, consulte [Claves de condición para Amazon Lex](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-policy-keys) en la *Referencia de autorizaciones de servicio*. Para obtener más información acerca de las acciones y los recursos con los que puede utilizar una clave de condición, consulte [Acciones definidas por Amazon Lex](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlex.html#your_service-actions-as-permissions).
En la siguiente tabla se enumeran las claves de condición de Amazon Lex que se aplican a los recursos de Amazon Lex. Puede incluir estas claves en los elementos `Condition` de una política de permisos de IAM.
****
| Clave de condición de Amazon Lex | Description (Descripción) | Tipo de valor | Permiso |
| --- | --- | --- | --- |
| lex:associatedIntents | Delimita el ámbito del conjunto de intenciones que se pueden utilizar al crear o modificar la definición de un bot. | Matriz de cadenas | `lex:PutBot` |
| lex:associatedSlotTypes | Delimita el ámbito del conjunto de tipos de slot que se pueden utilizar al crear o modificar la definición de un tipo de slot. | Matriz de cadenas | `lex:PutIntent` |
| lex:ChannelType | Delimita el ámbito del tipo de asociación de canal de bot que un usuario puede crear, obtener o eliminar. | Cadena | `lex:CreateBotChannelAssociation` `lex:DeleteBotChannelAssociation` `lex:GetBotChannelAssociation` |
## ACLs en Amazon Lex
**Soportes ACLs:** No
Las listas de control de acceso (ACLs) controlan qué directores (miembros de la cuenta, usuarios o roles) tienen permisos para acceder a un recurso. ACLs son similares a las políticas basadas en recursos, aunque no utilizan el formato de documento de políticas JSON.
## ABAC con Amazon Lex
**Compatibilidad con ABAC (etiquetas en las políticas):** parcial
El control de acceso basado en atributos (ABAC) es una estrategia de autorización que define permisos en función de atributos denominados etiquetas. Puede adjuntar etiquetas a las entidades y AWS los recursos de IAM y, a continuación, diseñar políticas de ABAC para permitir las operaciones cuando la etiqueta del director coincida con la etiqueta del recurso.
Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el [elemento de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) de una política utilizando las claves de condición `aws:ResourceTag/key-name`, `aws:RequestTag/key-name` o `aws:TagKeys`.
Si un servicio admite las tres claves de condición para cada tipo de recurso, el valor es **Sí** para el servicio. Si un servicio admite las tres claves de condición solo para algunos tipos de recursos, el valor es **Parcial**.
*Para obtener más información sobre ABAC, consulte [Definición de permisos con la autorización de ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) en la Guía del usuario de IAM*. Para ver un tutorial con los pasos para configurar ABAC, consulte [Uso del control de acceso basado en atributos (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html) en la *Guía del usuario de IAM*.
Puede asociar etiquetas con determinados tipos de recursos de Amazon Lex para la autorización. Para controlar el acceso utilizando etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política utilizando las claves de condición `lex:ResourceTag/${TagKey}`, `aws:RequestTag/${TagKey}` o `aws:TagKeys`.
Para obtener más información acerca del etiquetado de recursos de Amazon Lex, consulte [Etiquetado de los recursos de Amazon Lex](how-it-works-tags.md).
Para consultar un ejemplo de política basada en la identidad para limitar el acceso a un recurso en función de las etiquetas de ese recurso, consulte [Usar una etiqueta para acceder a un recurso](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-tag).
En la tabla siguiente se enumeran las acciones y los tipos de recursos correspondientes para el control de acceso basado en etiquetas. Cada acción se autoriza en función de las etiquetas asociadas al tipo de recurso correspondiente.
| Action | Tipo de recurso | Claves de condición | Notas |
| --- | --- | --- | --- |
| [CreateBotVersion](API_CreateBotVersion.md) | bot | lex:ResourceTag | |
| [DeleteBot](API_DeleteBot.md) | bot | lex:ResourceTag | |
| [DeleteBotAlias](API_DeleteBotAlias.md) | alias | lex:ResourceTag | |
| [DeleteBotChannelAssociation](API_DeleteBotChannelAssociation.md) | channel | lex:ResourceTag | |
| [DeleteBotVersion](API_DeleteBotVersion.md) | bot | lex:ResourceTag | |
| [DeleteSession](API_runtime_DeleteSession.md) | bot o alias | lex:ResourceTag | Utiliza etiquetas asociadas con el bot cuando el alias se define en \$1LATEST. Utiliza etiquetas asociadas al alias especificado cuando se utiliza con otros alias. |
| [DeleteUtterances](API_DeleteUtterances.md) | bot | lex:ResourceTag | |
| [GetBot](API_GetBot.md) | bot o alias | lex:ResourceTag | Utiliza etiquetas asociadas con el bot cuando versionOrAlias se define en \$1LATEST o versión numérica. Utiliza etiquetas asociadas al alias especificado cuando se utiliza con alias |
| [GetBotAlias](API_GetBotAlias.md) | alias | lex:ResourceTag | |
| [GetBotChannelAssociation](API_GetBotChannelAssociation.md) | chanel | lex:ResourceTag | |
| [GetBotChannelAssociations](API_GetBotChannelAssociations.md) | chanel | lex:ResourceTag | Utiliza etiquetas asociadas con el bot cuando el alias se define en «-». Utiliza etiquetas asociadas al alias especificado cuando se especifica un alias bot |
| [GetBotVersions](API_GetBotVersions.md) | bot | lex:ResourceTag | |
| [GetExport](API_GetExport.md) | bot | lex:ResourceTag | |
| [GetSession](API_runtime_GetSession.md) | bot o alias | lex:ResourceTag | Utiliza etiquetas asociadas con el bot cuando el alias se define en \$1LATEST. Utiliza etiquetas asociadas al alias especificado cuando se utiliza con otros alias. |
| [GetUtterancesView](API_GetUtterancesView.md) | bot | lex:ResourceTag | |
| [ListTagsForResource](API_ListTagsForResource.md) | bot, alias o canal | lex:ResourceTag | |
| [PostContent](API_runtime_PostContent.md) | bot o alias | lex:ResourceTag | Utiliza etiquetas asociadas con el bot cuando el alias se define en \$1LATEST. Utiliza etiquetas asociadas al alias especificado cuando se utiliza con otros alias. |
| [PostText](API_runtime_PostText.md) | bot o alias | lex:ResourceTag | Utiliza etiquetas asociadas con el bot cuando el alias se define en \$1LATEST. Utiliza etiquetas asociadas al alias especificado cuando se utiliza con otros alias. |
| [PutBot](API_PutBot.md) | bot | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
| [PutBotAlias](API_PutBotAlias.md) | alias | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
| [PutSession](API_runtime_PutSession.md) | bot o alias | lex:ResourceTag | Utiliza etiquetas asociadas con el bot cuando el alias se define en \$1LATEST. Utiliza etiquetas asociadas al alias especificado cuando se utiliza con otros alias. |
| [StartImport](API_StartImport.md) | bot | lex:ResourceTag | Se basa en la política de acceso para la operación PutBot. Se omiten las etiquetas y los permisos específicos de la operación StartImport. |
| [TagResource](API_TagResource.md) | bot, alias o canal | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
| [UntagResource](API_UntagResource.md) | bot, alias o canal | lex:ResourceTag, aws:RequestTag, aws:TagKeys | |
## Uso de credenciales temporales con Amazon Lex
**Compatibilidad con credenciales temporales:** sí
Las credenciales temporales proporcionan acceso a AWS los recursos a corto plazo y se crean automáticamente cuando se utiliza la federación o se cambia de rol. AWS recomienda generar credenciales temporales de forma dinámica en lugar de utilizar claves de acceso a largo plazo. Para obtener más información, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) y [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la *Guía del usuario de IAM*.
Puede utilizar credenciales temporales para iniciar sesión con federación, asumir un rol de IAM o asumir un rol de acceso entre cuentas. Las credenciales de seguridad temporales se obtienen llamando a operaciones de AWS STS API como [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)o [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html).
## Permisos de entidades principales entre servicios de Amazon Lex
**Admite sesiones de acceso directo (FAS):** sí
Las sesiones de acceso directo (FAS) utilizan los permisos de la persona principal que llama y los que solicitan Servicio de AWS para realizar solicitudes a los servicios descendentes. Servicio de AWS Para obtener información sobre las políticas a la hora de realizar solicitudes de FAS, consulte [Sesiones de acceso directo](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html).
## Roles de servicio para Amazon Lex
**Compatible con roles de servicio:** sí
Un rol de servicio es un [rol de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) que asume un servicio para realizar acciones en su nombre. Un administrador de IAM puede crear, modificar y eliminar un rol de servicio desde IAM. Para obtener más información, consulte [Crear un rol para delegar permisos a un Servicio de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) en la *Guía del usuario de IAM*.
**aviso**
Cambiar los permisos de un rol de servicio podría interrumpir la funcionalidad de Amazon Lex. Edite los roles de servicio solo cuando Amazon Lex proporcione orientación para hacerlo.
### Elección de un rol de IAM en Amazon Lex
Amazon Lex utiliza roles vinculados a servicios para llamar a Amazon Comprehend y a Amazon Polly. Utiliza permisos a nivel de recursos en AWS Lambda las funciones para invocarlas.
Debe proporcionar un rol de IAM para habilitar el etiquetado de conversaciones. Para obtener más información, consulte [Crear un rol de IAM y políticas para registros de conversación](conversation-logs-policies.md#conversation-logs-role-and-policy).
## Roles vinculados a servicios para Amazon Lex
**Compatible con roles vinculados al servicio:** sí
Un rol vinculado a un servicio es un tipo de rol de servicio que está vinculado a un. Servicio de AWS El servicio puede asumir el rol para realizar una acción en su nombre. Los roles vinculados al servicio aparecen en usted Cuenta de AWS y son propiedad del servicio. Un administrador de IAM puede ver, pero no editar, los permisos de los roles vinculados a servicios.
Para obtener más información sobre cómo crear o administrar roles vinculados a servicios de Amazon Lex, consulte [Uso de roles vinculados a servicios para Amazon Lex](using-service-linked-roles.md).