Como o Amazon Lex funciona com IAM - Amazon Lex V1

Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.

 

Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.

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 IAM

Antes de usar IAM para gerenciar o acesso ao Amazon Lex, saiba quais IAM recursos estão disponíveis para uso com o Amazon Lex.

Para ter uma visão de alto nível de como o Amazon Lex e outros AWS serviços funcionam com a maioria dos IAM recursos, consulte AWS os serviços que funcionam com IAM no Guia do IAM usuário.

Políticas baseadas em identidade do Amazon Lex

Compatível com políticas baseadas em identidade: Sim

Políticas baseadas em identidade são documentos de políticas de JSON permissões que você pode anexar a uma identidade, como um IAM usuário, grupo de usuários ou função. 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 Criação de IAM políticas no Guia do IAMusuário.

Com políticas IAM baseadas em identidade, você pode especificar ações e recursos permitidos ou negados, bem como as condições sob as quais as ações são permitidas ou negadas. Você não pode especificar a entidade principal em uma política baseada em identidade porque ela se aplica ao usuário ou perfil ao qual ela está anexada. Para saber mais sobre todos os elementos que você pode usar em uma JSON política, consulte a referência IAM JSON de elementos de política no Guia IAM do usuário.

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

Suporte a políticas baseadas em recursos: não

Políticas baseadas em recursos são documentos JSON de política que você anexa a um recurso. Exemplos de políticas baseadas em recursos são as políticas de confiança de IAM funções e as políticas de bucket do Amazon S3. Em serviços que suportem políticas baseadas em recursos, os administradores de serviço podem usá-las para controlar o acesso a um recurso específico. Para o recurso ao qual a política está anexada, a política define quais ações um principal especificado pode executar nesse recurso 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 habilitar o acesso entre contas, você pode especificar uma conta ou IAM entidades inteiras em outra conta como principal em uma política baseada em recursos. Adicionar uma entidade principal entre contas à política baseada em recurso é apenas metade da tarefa de estabelecimento da relação de confiança. Quando o principal e o recurso são diferentes Contas da AWS, um IAM administrador na conta confiável também deve conceder permissão à entidade principal (usuário ou função) para acessar o recurso. Eles concedem permissão ao anexar uma política baseada em identidade para a entidade. No entanto, se uma política baseada em recurso conceder acesso a uma entidade principal na mesma conta, nenhuma política baseada em identidade adicional será necessária. Para obter mais informações, consulte Acesso a recursos entre contas IAM no Guia do IAM usuário.

Ações de políticas para o Amazon Lex

Compatível com ações de políticas: Sim

Os administradores podem usar AWS JSON políticas 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 Action elemento de uma JSON política descreve as ações que você pode usar para permitir ou negar acesso em uma política. As ações de política geralmente têm o mesmo nome da AWS API operação associada. Há algumas exceções, como ações somente com permissão que não têm uma operação correspondente. API Algumas operações também exigem várias ações em uma política. Essas ações adicionais são chamadas de ações dependentes.

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 AWS JSON políticas 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 Resource JSON de política especifica o objeto ou objetos aos quais a ação se aplica. As instruções devem incluir um elemento Resource ou NotResource. Como prática recomendada, especifique um recurso usando seu Amazon Resource Name (ARN). Isso pode ser feito para ações que oferecem compatibilidade com um tipo de recurso específico, conhecido como permissões em nível de recurso.

Para ações que não oferecem compatibilidade com permissões em nível de recurso, como operações de listagem, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.

"Resource": "*"

Um recurso de bot do Amazon Lex ARN tem o seguinte formato.

arn:aws:lex:${Region}:${Account}:bot:${Bot-Name}

Para obter mais informações sobre o formato deARNs, consulte Amazon Resource Names (ARNs) e AWS Service Namespaces.

Por exemplo, para especificar o OrderFlowers bot em sua declaração, use o seguinteARN.

"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 seusARNs, consulte Recursos definidos pelo Amazon Lex na Referência de autorização de serviço. Para saber com quais ações você pode especificar cada recurso, consulte Ações definidas pelo Amazon Lex. ARN

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 AWS JSON políticas 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 (ou bloco Condition) permite que você especifique condições nas quais uma instrução estiver em vigor. O elemento Condition é opcional. É 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.

Se você especificar vários elementos Condition em uma instrução ou várias chaves em um único Condition elemento, a AWS os avaliará usando uma operação lógica AND. Se você especificar vários valores para uma única chave de condição, AWS avalia a condição usando uma OR operação lógica. Todas as condições devem ser atendidas antes que as permissões da instrução sejam concedidas.

Você também pode usar variáveis de espaço reservado ao especificar condições. Por exemplo, você pode conceder permissão a um IAM usuário para acessar um recurso somente se ele estiver marcado com o nome de IAM usuário. Para obter mais informações, consulte elementos de IAM política: variáveis e tags no Guia IAM do usuário.

AWS suporta chaves de condição globais e chaves de condição específicas do serviço. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia IAM do usuário.

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 Condition elementos em uma política de IAM permissões.

Chave de condição do Amazon Lex Descrição 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:PutBot

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:PutIntent

lex:ChannelType

Faz os escopos da associação de canal de bot que um usuário pode criar, obter ou excluir.

String

lex:CreateBotChannelAssociation

lex:DeleteBotChannelAssociation

lex:GetBotChannelAssociation

ACLsno Amazon Lex

SuportesACLs: 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. ACLssão semelhantes às políticas baseadas em recursos, embora não usem o formato de documento JSON de política.

ABACcom o Amazon Lex

Suportes ABAC (tags nas políticas): Parciais

O controle de acesso baseado em atributos (ABAC) é uma estratégia de autorização que define permissões com base em atributos. Em AWS, esses atributos são chamados de tags. Você pode anexar tags a IAM entidades (usuários ou funções) e a muitos AWS recursos. Marcar entidades e recursos é a primeira etapa doABAC. Em seguida, você cria ABAC políticas para permitir operações quando a tag do diretor corresponde à tag do recurso que ele está tentando acessar.

ABACé útil em ambientes que estão crescendo rapidamente e ajuda em situações em que o gerenciamento de políticas se torna complicado.

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-name, aws:RequestTag/key-name ou chaves de condição aws:TagKeys.

Se um serviço oferecer suporte às três chaves de condição para cada tipo de recurso, o valor será Sim para o serviço. Se um serviço oferecer suporte às três chaves de condição somente para alguns tipos de recursos, o valor será Parcial

Para obter mais informações sobreABAC, consulte O que éABAC? no Guia do IAM usuário. Para ver um tutorial com etapas de configuraçãoABAC, consulte Usar controle de acesso baseado em atributos (ABAC) no Guia do IAMusuário.

É 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 atributos 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

Alguns Serviços da AWS não funcionam quando você faz login usando credenciais temporárias. Para obter informações adicionais, incluindo quais Serviços da AWS funcionam com credenciais temporárias, consulte Serviços da AWS esse trabalho IAM no Guia do IAM usuário.

Você está usando credenciais temporárias se fizer login AWS Management Console usando qualquer método, exceto um nome de usuário e senha. Por exemplo, quando você acessa AWS usando o link de login único (SSO) da sua empresa, esse processo cria automaticamente credenciais temporárias. Você também cria automaticamente credenciais temporárias quando faz login no console como usuário e, em seguida, alterna perfis. Para obter mais informações sobre a troca de funções, consulte Alternando para uma função (console) no Guia IAM do usuário.

Você pode criar manualmente credenciais temporárias usando o AWS CLI ou AWS API. Em seguida, você pode usar essas credenciais temporárias para acessar AWS. AWS recomenda que você gere credenciais temporárias dinamicamente em vez de usar chaves de acesso de longo prazo. Para obter mais informações, consulte Credenciais de segurança temporárias emIAM.

Você pode usar credenciais temporárias para entrar com a federação, assumir uma IAM função ou assumir uma função entre contas. Você obtém credenciais de segurança temporárias ligando para AWS STS API operações como AssumeRoleou GetFederationToken.

Permissões de entidades principais entre serviços para o Amazon Lex

Suporta sessões de acesso direto (FAS): Sim

Quando você usa um IAM usuário ou uma função para realizar ações em AWS, você é considerado principal. Ao usar alguns serviços, você pode executar uma ação que inicia outra ação em um serviço diferente. FASusa as permissões do diretor chamando um Serviço da AWS, combinadas com a solicitação Serviço da AWS para fazer solicitações aos serviços posteriores. FASas solicitações são feitas somente quando um serviço recebe uma solicitação que requer interações com outros Serviços da AWS ou com recursos para ser concluída. Nesse caso, você precisa ter permissões para executar ambas as ações. Para obter detalhes da política ao fazer FAS solicitações, consulte Encaminhar sessões de acesso.

Perfis de serviço para o Amazon Lex

Compatível com perfis de serviço: Sim

Uma função de serviço é uma IAMfunção que um serviço assume para realizar ações em seu nome. Um IAM administrador pode criar, modificar e excluir uma função de serviço internamenteIAM. Para obter mais informações, consulte Criação de uma função para delegar permissões a uma Serviço da AWS no Guia do IAM usuário.

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.

Escolha de uma IAM função 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 IAM função para ativar a marcação de conversas. 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

Suporte a perfis vinculados a serviços: sim

Uma função vinculada ao serviço é um tipo de função de serviço vinculada a um. Serviço da AWS O serviço pode presumir a função de 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 IAM administrador pode visualizar, mas não editar, as permissões das funções vinculadas ao 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.