Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Depois de 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 ou os recursos do Amazon Lex V1. Se você estiver usando o Amazon Lex V2, consulte o guia do Amazon Lex V2 em vez disso.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Como o Amazon Lex funciona com o IAM
Antes de usar o IAM para gerenciar o acesso ao Amazon Lex, entenda que atributos do IAM estão disponíveis para uso com o Amazon Lex.
| Atributo do IAM | Suporte ao Amazon Lex |
|---|---|
|
Sim |
|
|
Não |
|
|
Sim |
|
|
Sim |
|
|
Sim |
|
|
Não |
|
|
Parcial |
|
|
Sim |
|
|
Sim |
|
|
Sim |
|
|
Sim |
Para ter uma visão de alto nível de como o Amazon Lex e outros AWS serviços funcionam com a maioria dos recursos do IAM, consulte AWS os serviços que funcionam com o IAM no Guia do usuário do IAM.
Políticas baseadas em identidade do Amazon Lex
Compatível com políticas baseadas em identidade: sim
As políticas baseadas em identidade são documentos de políticas de permissões JSON que você pode anexar a uma identidade, como usuário do IAM, grupo de usuários ou perfil. Essas políticas controlam quais ações os usuários e perfis podem realizar, em quais recursos e em que condições. Para saber como criar uma política baseada em identidade, consulte Definir permissões personalizadas do IAM com as políticas gerenciadas pelo cliente no Guia do Usuário do IAM.
Com as políticas baseadas em identidade do IAM, é possível especificar ações e recursos permitidos ou negados, assim como as condições sob as quais as ações são permitidas ou negadas. Para saber mais sobre todos os elementos que podem ser usados em uma política JSON, consulte Referência de elemento de política JSON do IAM no Guia do usuário do IAM.
Exemplos de políticas baseadas em identidade para o Amazon Lex
Para visualizar exemplos de políticas baseadas em identidade do Amazon Lex, consulte Exemplos de políticas baseadas em identidade para o Amazon Lex.
Políticas baseadas em recursos no Amazon Lex
Compatibilidade com políticas baseadas em recursos: não
Políticas baseadas em recursos são documentos de políticas JSON que você anexa a um recurso. São exemplos de políticas baseadas em recursos as políticas de confiança de perfil do IAM e as políticas de bucket do Amazon S3. Em serviços compatíveis com políticas baseadas em recursos, os administradores de serviço podem usá-las para controlar o acesso a um recurso específico. Para o atributo ao qual a política está anexada, a política define quais ações uma entidade principal especificado pode executar nesse atributo e em que condições. Você deve especificar uma entidade principal em uma política baseada em recursos. Os diretores podem incluir contas, usuários, funções, usuários federados ou. Serviços da AWS
Para permitir o acesso entre contas, você pode especificar uma conta inteira ou as entidades do IAM em outra conta como a entidade principal em uma política baseada em recursos. Consulte mais informações em Acesso a recursos entre contas no IAM no Guia do usuário do IAM.
Ações de políticas para o Amazon Lex
Compatível com ações de políticas: sim
Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.
O elemento Action de uma política JSON descreve as ações que podem ser usadas para permitir ou negar acesso em uma política. Incluem ações em uma política para conceder permissões para executar a operação associada.
Para ver uma lista de ações do Amazon Lex, consulte Ações definidas pelo Amazon Lex na Referência de autorização do serviço.
As ações de política no Amazon Lex usam o seguinte prefixo antes da ação:
lex
Para especificar várias ações em uma única instrução, separe-as com vírgulas.
"Action": [ "lex:action1", "lex:action2" ]
Você também pode especificar várias ações usando caracteres-curinga (*). Por exemplo, para especificar todas as ações que começam com a palavra Describe, inclua a seguinte ação:
"Action": "lex:Describe*"
Recursos de políticas para o Amazon Lex
Compatível com recursos de políticas: sim
Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.
O elemento de política JSON Resource especifica o objeto ou os objetos aos quais a ação se aplica. Como prática recomendada, especifique um recurso usando seu nome do recurso da Amazon (ARN). Para ações em que não é possível usar permissões em nível de recurso, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.
"Resource": "*"
O ARN de um recurso de bot do Amazon Lex tem o seguinte formato.
arn:aws:lex:${Region}:${Account}:bot:${Bot-Name}
Para obter mais informações sobre o formato de ARNs, consulte Amazon Resource Names (ARNs) e AWS Service Namespaces.
Por exemplo, para especificar o bot OrderFlowers em sua instrução, use o seguinte ARN.
"Resource": "arn:aws:lex:us-east-2:123456789012:bot:OrderFlowers"
Para especificar todos os bots que pertencem a uma conta específica, use o caractere curinga (*):
"Resource": "arn:aws:lex:us-east-2:123456789012:bot:*"
Algumas ações do Amazon Lex, como as que servem para a criação de recursos, não podem ser executadas em um recurso específico. Nesses casos, é necessário usar o caractere curinga (*).
"Resource": "*"
Para ver uma lista dos tipos de recursos do Amazon Lex e seus ARNs, consulte Recursos definidos pelo Amazon Lex na Referência de autorização de serviço. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte Ações definidas pelo Amazon Lex.
Chaves de condição de política para o Amazon Lex
Compatível com chaves de condição de política específicas de serviço: sim
Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos e em que condições.
O elemento Condition especifica quando as instruções são executadas com base em critérios definidos. É possível criar expressões condicionais que usem agentes de condição, como “igual a” ou “menor que”, para fazer a condição da política corresponder aos valores na solicitação. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia do usuário do IAM.
Para ver uma lista de chaves de condição do Amazon Lex, consulte Chaves de condição do Amazon Lex na Referência de autorização do serviço. Para saber com quais ações e recursos é possível usar a chave de condição, consulte Ações definidas pelo Amazon Lex.
A tabela a seguir mostra as chaves de condição do Amazon Lex aplicáveis aos recursos do Amazon Lex. Você pode incluir essas chaves em elementos Condition de uma política de permissões do IAM.
| Chave de condição do Amazon Lex | Description | Tipo de valor | Permissão |
|---|---|---|---|
lex:associatedIntents |
Faz os escopos do conjunto de intenções que podem ser usados ao criar ou modificar a definição de um bot. |
Matriz de strings |
|
lex:associatedSlotTypes |
Faz os escopos dos tipos de slots que podem ser usados ao criar ou modificar a definição de um tipo de slot. |
Matriz de strings |
|
lex:ChannelType |
Faz os escopos da associação de canal de bot que um usuário pode criar, obter ou excluir. |
String |
|
ACLs no Amazon Lex
Suportes ACLs: Não
As listas de controle de acesso (ACLs) controlam quais diretores (membros da conta, usuários ou funções) têm permissões para acessar um recurso. ACLs são semelhantes às políticas baseadas em recursos, embora não usem o formato de documento de política JSON.
ABAC com o Amazon Lex
Compatível com ABAC (tags em políticas): parcial
O controle de acesso por atributo (ABAC) é uma estratégia de autorização que define permissões com base em atributos chamados de tags. Você pode anexar tags a entidades e AWS recursos do IAM e, em seguida, criar políticas ABAC para permitir operações quando a tag do diretor corresponder à tag no recurso.
Para controlar o acesso baseado em tags, forneça informações sobre as tags no elemento de condição de uma política usando as aws:ResourceTag/, key-nameaws:RequestTag/ ou chaves de condição key-nameaws:TagKeys.
Se um serviço for compatível com as três chaves de condição para cada tipo de recurso, o valor será Sim para o serviço. Se um serviço for compatível com as três chaves de condição somente para alguns tipos de recursos, o valor será Parcial
Para obter mais informações sobre o ABAC, consulte Definir permissões com autorização do ABAC no Guia do usuário do IAM. Para visualizar um tutorial com etapas para configurar o ABAC, consulte Usar controle de acesso baseado em atributos (ABAC) no Guia do usuário do IAM.
É possível associar tags a determinados tipos de recursos do Amazon Lex para autorização. Para controlar o acesso baseado em tags, forneça informações sobre as tags no elemento de condição de uma política usando as chaves de condição lex:ResourceTag/${TagKey}, aws:RequestTag/${TagKey} ou aws:TagKeys.
Para ter mais informações sobre recursos de marcação do Amazon Lex, consulte Marcação de seus recursos do Amazon Lex.
Para visualizar um exemplo de política baseada em identidade para limitar o acesso a um recurso baseado em tags desse recurso, consulte Uso de uma tag para acessar um recurso.
A tabela a seguir lista as ações e os tipos de recursos correspondentes para o controle de acesso baseado em tags. Cada ação é autorizada com base nas tags associadas ao tipo de recurso correspondente.
| Ação | Tipo de recurso | Chaves de condição | Observações |
|---|---|---|---|
| CreateBotVersion | bot | lex:ResourceTag |
|
| DeleteBot | bot | lex:ResourceTag |
|
| DeleteBotAlias | alias | lex:ResourceTag |
|
| DeleteBotChannelAssociation | channel | lex:ResourceTag |
|
| DeleteBotVersion | bot | lex:ResourceTag |
|
| DeleteSession | bot ou alias | lex:ResourceTag |
Usa as tags associadas ao bot quando o alias é definido como $LATEST. Usa as tags associadas ao alias especificado quando usado com outros aliases. |
| DeleteUtterances | bot | lex:ResourceTag |
|
| GetBot | bot ou alias | lex:ResourceTag |
Usa as tags associadas ao bot quando versionOrAlias é definido como $LATEST ou versão numérica. Usa as tags associadas ao alias especificado quando usado com aliases |
| GetBotAlias | alias | lex:ResourceTag |
|
| GetBotChannelAssociation | canal | lex:ResourceTag |
|
| GetBotChannelAssociations | canal | lex:ResourceTag |
Usa as tags associadas ao bot quando o alias é definido como “-”. Usa as tags associadas ao alias especificado quando um alias de bot é especificado |
| GetBotVersions | bot | lex:ResourceTag |
|
| GetExport | bot | lex:ResourceTag |
|
| GetSession | bot ou alias | lex:ResourceTag |
Usa as tags associadas ao bot quando o alias é definido como $LATEST. Usa as tags associadas ao alias especificado quando usado com outros aliases. |
| GetUtterancesView | bot | lex:ResourceTag |
|
| ListTagsForResource | bot, alias ou canal | lex:ResourceTag |
|
| PostContent | bot ou alias | lex:ResourceTag |
Usa as tags associadas ao bot quando o alias é definido como $LATEST. Usa as tags associadas ao alias especificado quando usado com outros aliases. |
| PostText | bot ou alias | lex:ResourceTag |
Usa as tags associadas ao bot quando o alias é definido como $LATEST. Usa as tags associadas ao alias especificado quando usado com outros aliases. |
| PutBot | bot | lex:ResourceTag, aws:RequestTag,
aws:TagKeys |
|
| PutBotAlias | alias | lex:ResourceTag, aws:RequestTag,
aws:TagKeys |
|
| PutSession | bot ou alias | lex:ResourceTag |
Usa as tags associadas ao bot quando o alias é definido como $LATEST. Usa as tags associadas ao alias especificado quando usado com outros aliases. |
| StartImport | bot | lex:ResourceTag |
Baseia-se na política de acesso para a operação PutBot. As tags e permissões específicas para a operação StartImport são ignoradas. |
| TagResource | bot, alias ou canal | lex:ResourceTag, aws:RequestTag,
aws:TagKeys |
|
| UntagResource | bot, alias ou canal | lex:ResourceTag, aws:RequestTag,
aws:TagKeys |
Usar credenciais temporárias com o Amazon Lex
Compatível com credenciais temporárias: sim
As credenciais temporárias fornecem acesso de curto prazo aos AWS recursos e são criadas automaticamente quando você usa a federação ou troca de funções. AWS recomenda que você gere credenciais temporárias dinamicamente em vez de usar chaves de acesso de longo prazo. Para ter mais informações, consulte Credenciais de segurança temporárias no IAM e Serviços da Serviços da AWS que funcionam com o IAM no Guia do usuário do IAM.
É possível usar credenciais temporárias para fazer login com federação, assumir um perfil do IAM ou assumir um perfil entre contas. Você obtém credenciais de segurança temporárias chamando operações de AWS STS API, como AssumeRoleou GetFederationToken.
Permissões de entidades principais entre serviços para o Amazon Lex
Compatibilidade com o recurso de encaminhamento de sessões de acesso (FAS): sim
As sessões de acesso direto (FAS) usam as permissões do principal chamando um AWS service (Serviço da AWS), combinadas com a solicitação AWS service (Serviço da AWS) de fazer solicitações aos serviços posteriores. Para obter detalhes da política ao fazer solicitações de FAS, consulte Sessões de acesso direto.
Perfis de serviço para o Amazon Lex
Compatível com perfis de serviço: sim
O perfil de serviço é um perfil do IAM que um serviço assume para executar ações em seu nome. Um administrador do IAM pode criar, modificar e excluir um perfil de serviço do IAM. Para obter mais informações, consulte Criar um perfil para delegar permissões a um AWS service (Serviço da AWS) no Guia do Usuário do IAM.
Atenção
A alteração das permissões de um perfil de serviço pode interromper a funcionalidade do Amazon Lex. Edite perfis de serviço somente quando o Amazon Lex fornecer orientação para isso.
Escolher uma perfil do IAM no Amazon Lex
O Amazon Lex usa funções vinculadas a serviços para chamar o Amazon Comprehend e o Amazon Polly. Ele usa permissões em nível de recurso em suas AWS Lambda funções para invocá-las.
Você deve fornecer uma perfil do IAM para habilitar a marcação de conversa. Para obter mais informações, consulte Criar um perfil e políticas do IAM para logs de conversa.
Perfis vinculados ao serviço para o Amazon Lex
Compatibilidade com perfis vinculados a serviços: sim
Uma função vinculada ao serviço é um tipo de função de serviço vinculada a um. AWS service (Serviço da AWS) O serviço pode presumir o perfil para executar uma ação em seu nome. As funções vinculadas ao serviço aparecem em você Conta da AWS e são de propriedade do serviço. Um administrador do IAM pode visualizar, mas não editar as permissões para perfis vinculados a serviço.
Para obter detalhes sobre como criar ou gerenciar funções vinculadas ao serviço do Amazon Lex, consulte Uso de perfis vinculadas ao serviço para o Amazon Lex.
