

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á.

# Gerenciamento de identidade e acesso para o Amazon Lex V2
<a name="security-iam"></a>





O AWS Identity and Access Management (IAM) ajuda AWS service (Serviço da AWS) o administrador a controlar com segurança o acesso aos recursos da AWS. Os administradores do IAM controlam quem pode ser *autenticado* (conectado) e *autorizado* (ter permissões) para utilizar os recursos do Amazon Lex V2. O IAM é um AWS service (Serviço da AWS) que você pode usar sem custo adicional.

**Topics**
+ [Público](#security_iam_audience)
+ [Autenticação com identidades](#security_iam_authentication)
+ [Gerenciar o acesso usando políticas](#security_iam_access-manage)
+ [Como o Amazon Lex V2 funciona com o IAM](security_iam_service-with-iam.md)
+ [Exemplos de políticas baseadas em identidade para o Amazon Lex V2](security_iam_id-based-policy-examples.md)
+ [Exemplos de políticas baseadas em recursos para o Amazon Lex V2](security_iam_resource-based-policy-examples.md)
+ [Políticas gerenciadas pela AWS para o Amazon Lex V2](security-iam-awsmanpol.md)
+ [Usar perfis vinculados ao serviço para o Amazon Lex V2](using-service-linked-roles.md)
+ [Solução de problemas de identidade e acesso da Amazon Lex V2](security_iam_troubleshoot.md)

## Público
<a name="security_iam_audience"></a>

A forma como você usa o AWS Identity and Access Management (IAM) difere com base na sua função:
+ **Usuário do serviço**: solicite permissões ao seu administrador se você não conseguir acessar os atributos (consulte [Solução de problemas de identidade e acesso da Amazon Lex V2](security_iam_troubleshoot.md)).
+ **Administrador do serviço**: determine o acesso do usuário e envie solicitações de permissão (consulte [Como o Amazon Lex V2 funciona com o IAM](security_iam_service-with-iam.md))
+ **Administrador do IAM**: escreva políticas para gerenciar o acesso (consulte [Exemplos de políticas baseadas em identidade para o Amazon Lex V2](security_iam_id-based-policy-examples.md))

## Autenticação com identidades
<a name="security_iam_authentication"></a>

A autenticação é a forma como você faz login na AWS usando suas credenciais de identidade. Você deve estar autenticado como usuário do IAM ou assumindo uma função do IAM. Usuário raiz da conta da AWS

Você pode fazer login como uma identidade federada usando credenciais de uma fonte de identidade como Centro de Identidade do AWS IAM (IAM Identity Center), autenticação de login único ou credenciais. Google/Facebook Para ter mais informações sobre como fazer login, consulte [Como fazer login em sua Conta da AWS](https://docs.aws.amazon.com/signin/latest/userguide/how-to-sign-in.html) no *Guia do usuário do Início de Sessão da AWS *.

Para acesso programático, a AWS fornece um SDK e uma CLI para assinar solicitações criptograficamente. Para obter mais informações, consulte [AWS Signature versão 4 para solicitações de API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) no *Guia do usuário do IAM*.

### Conta da AWS usuário root
<a name="security_iam_authentication-rootuser"></a>

 Ao criar um Conta da AWS, você começa com uma identidade de login chamada *usuário Conta da AWS raiz* que tem acesso completo a todos Serviços da AWS os recursos. É altamente recomendável não usar o usuário-raiz em tarefas diárias. Consulte as tarefas que exigem credenciais de usuário-raiz em [Tarefas que exigem credenciais de usuário-raiz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks) no *Guia do usuário do IAM*. 

### Identidade federada
<a name="security_iam_authentication-federated"></a>

Como prática recomendada, exija que os usuários humanos usem a federação com um provedor de identidade para acessar Serviços da AWS usando credenciais temporárias.

Uma *identidade federada* é um usuário do seu diretório corporativo, provedor de identidade da web ou Directory Service que acessa Serviços da AWS usando credenciais de uma fonte de identidade. As identidades federadas assumem funções que oferecem credenciais temporárias.

Para o gerenciamento de acesso centralizado, recomendamos Centro de Identidade do AWS IAM. Para saber mais, consulte [O que é o IAM Identity Center?](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) no *Guia do usuário do Centro de Identidade do AWS IAM *.

### Usuários e grupos do IAM
<a name="security_iam_authentication-iamuser"></a>

Um *[usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html)* é uma identidade com permissões específicas para uma única pessoa ou aplicação. É recomendável usar credenciais temporárias, em vez de usuários do IAM com credenciais de longo prazo. Para obter mais informações, consulte [Exigir que usuários humanos usem a federação com um provedor de identidade para acessar a AWS usando credenciais temporárias](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) no *Guia do usuário do IAM*.

Um [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html) especifica um conjunto de usuários do IAM e facilita o gerenciamento de permissões para grandes conjuntos de usuários. Para ter mais informações, consulte [Casos de uso de usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/gs-identities-iam-users.html) no *Guia do usuário do IAM*.

### Perfis do IAM
<a name="security_iam_authentication-iamrole"></a>

Uma *[perfil do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)* é uma identidade com permissões específicas que oferece credenciais temporárias. Você pode assumir uma função [mudando de um usuário para uma função do IAM (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) ou chamando uma operação da AWS CLI ou da API da AWS. Para saber mais, consulte [Métodos para assumir um perfil](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html) no *Manual do usuário do IAM*.

Os perfis do IAM são úteis para acesso de usuário federado, permissões de usuário do IAM temporárias, acesso entre contas, acesso entre serviços e aplicações em execução no Amazon EC2. Consulte mais informações em [Acesso a recursos entre contas no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) no *Guia do usuário do IAM*.

## Gerenciar o acesso usando políticas
<a name="security_iam_access-manage"></a>

Você controla o acesso na AWS criando políticas e anexando-as às identidades ou recursos da AWS. Uma política define permissões quando associada a uma identidade ou recurso. A AWS avalia essas políticas quando um diretor faz uma solicitação. A maioria das políticas são armazenadas na AWS como documentos JSON. Para ter mais informações sobre documentos de política JSON, consulte [Visão geral das políticas JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json) no *Guia do usuário do IAM*.

Por meio de políticas, os administradores especificam quem tem acesso a que, definindo qual **entidade principal** pode realizar **ações** em quais **recursos** e sob quais **condições**.

Por padrão, usuários e perfis não têm permissões. Um administrador do IAM cria políticas do IAM e as adiciona aos perfis, os quais os usuários podem então assumir. As políticas do IAM definem permissões, independentemente do método usado para realizar a operação.

### Políticas baseadas em identidade
<a name="security_iam_access-manage-id-based-policies"></a>

As políticas baseadas em identidade são documentos de políticas de permissão JSON que você anexa a uma identidade (usuário, grupo ou perfil). Essas políticas controlam quais ações as identidades podem realizar, em quais recursos e sob quais 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) no *Guia do Usuário do IAM*.

As políticas baseadas em identidade podem ser políticas *em linha* (incorporadas diretamente em uma única identidade) ou *políticas gerenciadas* (políticas autônomas anexadas a várias identidades). Para saber como escolher entre uma política gerenciada e políticas em linha, consulte [Escolher entre políticas gerenciadas e políticas em linha](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html) no *Guia do usuário do IAM*.

### Políticas baseadas em recursos
<a name="security_iam_access-manage-resource-based-policies"></a>

Políticas baseadas em recursos são documentos de políticas JSON que você anexa a um recurso. Entre os exemplos estão *políticas de confiança de perfil* do IAM e *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. É necessário [especificar uma entidade principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) em uma política baseada em recursos.

Políticas baseadas em recursos são políticas em linha localizadas nesse serviço. Você não pode usar as políticas gerenciadas da AWS do IAM em uma política baseada em recursos.

### Outros tipos de política
<a name="security_iam_access-manage-other-policies"></a>

A AWS oferece suporte a tipos de políticas adicionais que podem definir as permissões máximas concedidas por tipos de políticas mais comuns:
+ **Limites de permissões**: definem o número máximo de permissões que uma política baseada em identidade pode conceder a uma entidade do IAM. Para saber mais sobre limites de permissões, consulte [Limites de permissões para identidades do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) no *Guia do usuário do IAM*.
+ **Políticas de controle de serviço (SCPs)** — Especifique as permissões máximas para uma organização ou unidade organizacional em AWS Organizations. Para saber mais, consulte [Políticas de controle de serviço](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) no *Guia do usuário do AWS Organizations *.
+ **Políticas de controle de recursos (RCPs)** — Defina o máximo de permissões disponíveis para recursos em suas contas. Para obter mais informações, consulte [Políticas de controle de recursos (RCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_rcps.html) no *Guia AWS Organizations do usuário*.
+ **Políticas de sessão**: políticas avançadas transmitidas como um parâmetro durante a criação de uma sessão temporária para um perfil ou um usuário federado. Para saber mais, consulte [Políticas de sessão](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session) no *Guia do usuário do IAM*.

### Vários tipos de política
<a name="security_iam_access-manage-multiple-policies"></a>

Quando vários tipos de política são aplicáveis a uma solicitação, é mais complicado compreender as permissões resultantes. Para saber como a AWS determina se deve permitir uma solicitação quando vários tipos de política estão envolvidos, consulte [Lógica de avaliação de políticas](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) no *Guia do usuário do IAM*.

# Como o Amazon Lex V2 funciona com o IAM
<a name="security_iam_service-with-iam"></a>

Antes de usar o IAM para gerenciar o acesso ao Amazon Lex V2, entenda que atributos do IAM estão disponíveis para uso com o Amazon Lex V2.






**Atributos do IAM que você pode usar com o Amazon Lex V2**  

| Atributo do IAM | Suporte ao Amazon Lex V2 | 
| --- | --- | 
|  [Políticas baseadas em identidade](#security_iam_service-with-iam-id-based-policies)  |  *Sim*  | 
|  [Políticas baseadas em atributos](#security_iam_service-with-iam-resource-based-policies)  |  *Sim*  | 
|  [Ações de políticas](#security_iam_service-with-iam-id-based-policies-actions)  |  *Sim*  | 
|  [Recursos de políticas](#security_iam_service-with-iam-id-based-policies-resources)  |  *Sim*  | 
|  [Chaves de condição de políticas](#security_iam_service-with-iam-id-based-policies-conditionkeys)  |  *Não*  | 
|  [ACLs](#security_iam_service-with-iam-acls)  |  *Não*  | 
|  [ABAC (tags em políticas)](#security_iam_service-with-iam-tags)  |  *Sim*  | 
|  [Credenciais temporárias](#security_iam_service-with-iam-roles-tempcreds)  |  *Não*  | 
|  [Permissões de entidade principal](#security_iam_service-with-iam-principal-permissions)  |  *Sim*  | 
|  [Perfis de serviço](#security_iam_service-with-iam-roles-service)  |  *Sim*  | 
|  [Perfis vinculados a serviço](#security_iam_service-with-iam-roles-service-linked)  |  *Parcial*  | 

Para ter uma visão de alto nível de como o Amazon Lex V2 e outros serviços da AWS funcionam com a maioria dos recursos do IAM, consulte [os serviços da AWS que funcionam com o IAM no Guia do](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) *usuário do IAM*.

## Políticas baseadas em identidade do Amazon Lex V2
<a name="security_iam_service-with-iam-id-based-policies"></a>

**Oferece suporte a políticas baseadas em identidade***: Sim*

As políticas baseadas em identidade são documentos de políticas de permissões JSON que podem ser anexados 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) no *Guia do usuário do IAM*.

### Exemplos de políticas baseadas em identidade para o Amazon Lex V2
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



Para visualizar exemplos de políticas baseadas em identidade do Amazon Lex V2, consulte [Exemplos de políticas baseadas em identidade para o Amazon Lex V2](security_iam_id-based-policy-examples.md).

## Políticas baseadas em recursos no Amazon Lex V2
<a name="security_iam_service-with-iam-resource-based-policies"></a>

**Oferece suporte a políticas baseadas em recursos***: Sim*

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. É necessário [especificar uma entidade principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) em uma política baseada em recursos. As entidades principais podem incluir contas, usuários, perfis, usuários federados ou serviços da AWS.

Você não pode usar políticas entre contas ou regiões com o Amazon Lex V2. Se você criar uma política para um recurso com um ARN entre contas ou regiões, o Amazon Lex V2 retornará um erro.

O serviço Amazon Lex V2 oferece suporte a políticas baseadas em recursos chamadas de política de *bot e política* de *alias de bot*, que são anexadas a um bot ou a um alias de bot. Essas políticas definem quais entidades principais podem realizar ações no bot ou no alias do bot. 

As ações só podem ser usadas em recursos específicos. Por exemplo, a ação `UpdateBot` só pode ser usada em recursos de bots, a ação `UpdateBotAlias` só pode ser usada em recursos de alias de bots. Se você especificar uma ação em uma política que não pode ser usada no recurso especificado na política, o Amazon Lex V2 retornará um erro. Para obter a lista de ações e os recursos com os quais elas podem ser usadas, consulte a seguinte tabela.


| Ação | Oferece suporte a políticas baseadas em recursos | Recurso | 
| --- | --- | --- | 
| BuildBotLocale | Compatível | BotId | 
| CreateBot | Não |   | 
| CreateBotAlias | Não |   | 
| CreateBotChannel [somente permissão] | Compatível | BotId | 
| CreateBotLocale | Compatível | BotId | 
| CreateBotVersion | Compatível | BotId | 
| CreateExport | Compatível | BotId | 
| CreateIntent | Compatível | BotId | 
| CreateResourcePolicy | Compatível | BotId, BotAliasId | 
| CreateSlot | Compatível | BotId | 
| CreateSlotType | Compatível | BotId | 
| CreateUploadUrl | Não |   | 
| DeleteBot | Compatível | BotId, BotAliasId | 
| DeleteBotAlias | Compatível | BotAliasId | 
| DeleteBotChannel [somente permissão] | Compatível | BotId | 
| DeleteBotLocale | Compatível | BotId | 
| DeleteBotVersion | Compatível | BotId | 
| DeleteExport | Compatível | BotId | 
| DeleteImport | Compatível | BotId | 
| DeleteIntent | Compatível | BotId | 
| DeleteResourcePolicy | Compatível | BotId, BotAliasId | 
| DeleteSession | Compatível | BotAliasId | 
| DeleteSlot | Compatível | BotId | 
| DeleteSlotType | Compatível | BotId | 
| DescribeBot | Compatível | BotId | 
| DescribeBotAlias | Compatível | BotAliasId | 
| DescribeBotChannel [somente permissão] | Compatível | BotId | 
| DescribeBotLocale | Compatível | BotId | 
| DescribeBotVersion | Compatível | BotId | 
| DescribeExport | Compatível | BotId | 
| DescribeImport | Compatível | BotId | 
| DescribeIntent | Compatível | BotId | 
| DescribeResourcePolicy | Compatível | BotId, BotAliasId | 
| DescribeSlot | Compatível | BotId | 
| DescribeSlotType | Compatível | BotId | 
| GetSession | Compatível | BotAliasId | 
| ListBotAliases | Compatível | BotId | 
| ListBotChannels [somente permissão] | Compatível | BotId | 
| ListBotLocales | Compatível | BotId | 
| ListBots | Não |   | 
| ListBotVersions | Compatível | BotId | 
| ListBuiltInIntents | Não |   | 
| ListBuiltIntSlotTypes | Não |   | 
| ListExports | Não |   | 
| ListImports | Não |   | 
| ListIntents | Compatível | BotId | 
| ListSlots | Compatível | BotId | 
| ListSlotTypes | Compatível | BotId | 
| PutSession | Compatível | BotAliasId | 
| RecognizeText | Compatível | BotAliasId | 
| RecognizeUtterance | Compatível | BotAliasId | 
| StartConversation | Compatível | BotAliasId | 
| StartImport | Compatível | BotId, BotAliasId | 
| TagResource | Não |   | 
| UpdateBot | Compatível | BotId | 
| UpdateBotAlias | Compatível | BotAliasId | 
| UpdateBotLocale | Compatível | BotId | 
| UpdateBotVersion | Compatível | BotId | 
| UpdateExport | Compatível | BotId | 
| UpdateIntent | Compatível | BotId | 
| UpdateResourcePolicy | Compatível | BotId, BotAliasId | 
| UpdateSlot | Compatível | BotId | 
| UpdateSlotType | Compatível | BotId | 
| UntagResource | Não |   | 

Para saber como anexar uma política baseada em recurso a um bot ou alias de bot, consulte [Exemplos de políticas baseadas em recursos para o Amazon Lex V2](security_iam_resource-based-policy-examples.md).

### Exemplos de políticas baseadas em recursos no Amazon Lex V2
<a name="security_iam_service-with-iam-resource-based-policies-examples"></a>



Para ver exemplos de políticas baseadas em recursos do Amazon Lex V2, consulte [Exemplos de políticas baseadas em recursos para o Amazon Lex V2](security_iam_resource-based-policy-examples.md).

## Ações de políticas para o Amazon Lex V2
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

**Apoia ações políticas:** *Sim*

Os administradores podem usar as políticas JSON da AWS para especificar quem tem acesso a 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 V2, consulte [Ações definidas pelo Amazon Lex V2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-actions-as-permissions) na *Referência de autorização do serviço*.

As ações de política no Amazon Lex V2 usam o seguinte prefixo antes da ação:

```
lex
```

Para especificar várias ações em uma única declaração, separe-as com vírgulas.

```
"Action": [
      "lex:action1",
      "lex:action2"
         ]
```





Para visualizar exemplos de políticas baseadas em identidade do Amazon Lex V2, consulte [Exemplos de políticas baseadas em identidade para o Amazon Lex V2](security_iam_id-based-policy-examples.md).

## Recursos de políticas para o Amazon Lex V2
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

**Oferece suporte a recursos de políticas:** *Sim*

Os administradores podem usar as políticas JSON da AWS para especificar quem tem acesso a 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)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). Para ações que não oferecem compatibilidade com permissões em nível de recurso, use um curinga (\$1) para indicar que a instrução se aplica a todos os recursos.

```
"Resource": "*"
```

Para ver uma lista dos tipos de recursos do Amazon Lex V2 e seus ARNs, consulte [Recursos definidos pelo Amazon Lex V2 na Referência](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-resources-for-iam-policies) 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 V2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-actions-as-permissions).





Para visualizar exemplos de políticas baseadas em identidade do Amazon Lex V2, consulte [Exemplos de políticas baseadas em identidade para o Amazon Lex V2](security_iam_id-based-policy-examples.md).

## Chaves de condição de política para o Amazon Lex V2
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

**Suporta chaves de condição de política específicas do serviço***: Não*

Os administradores podem usar as políticas JSON da AWS para especificar quem tem acesso a 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), como “igual a” ou “menor que”, para fazer a condição da política corresponder aos valores na solicitação. Para consultar todas as chaves de condição global da AWS, consulte [Chaves de contexto de condição global da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) no *Guia do usuário do IAM*.

Para ver uma lista de chaves de condição do Amazon Lex V2, consulte [Chaves de condição do Amazon Lex V2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-policy-keys) na *Referência de autorização do serviço*. Para saber com quais ações e atributos é possível usar a chave de condição, consulte [Ações definidas pelo Amazon Lex V2](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html#amazonlexv2-actions-as-permissions).

Para visualizar exemplos de políticas baseadas em identidade do Amazon Lex V2, consulte [Exemplos de políticas baseadas em identidade para o Amazon Lex V2](security_iam_id-based-policy-examples.md).

## Listas de controle de acesso (ACLs) no Amazon Lex V2
<a name="security_iam_service-with-iam-acls"></a>

**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.

## Controle de acesso baseado em atributos (ABAC) com o Amazon Lex V2.
<a name="security_iam_service-with-iam-tags"></a>

***Suporta ABAC (tags nas políticas): Sim***

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 às entidades do IAM e aos recursos da AWS 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) 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 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 saber mais sobre o ABAC, consulte [Definir permissões com autorização do ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) no *Guia do usuário do IAM*. Para visualizar um tutorial com etapas para configurar o ABAC, consulte [Usar controle de acesso por atributo (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html) no *Guia do usuário do IAM*.

## Usar credenciais temporárias com o Amazon Lex V2
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

***Suporta credenciais temporárias: Não***

As credenciais temporárias fornecem acesso de curto prazo aos recursos da AWS e são criadas automaticamente quando você usa a federação ou troca de funções. A AWS recomenda que você gere dinamicamente credenciais temporárias em vez de usar chaves de acesso de longo prazo. Para obter mais informações, consulte [Credenciais de segurança temporárias no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) e [Serviços da AWS que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) no *Guia do usuário do IAM*.

## Permissões de entidades principais entre serviços para o Amazon Lex V2
<a name="security_iam_service-with-iam-principal-permissions"></a>

**Suporta sessões de acesso direto (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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html). 

## Perfis de serviço para o Amazon Lex V2
<a name="security_iam_service-with-iam-roles-service"></a>

**Suporta funções de serviço:** *Sim*

 O perfil de serviço é um [perfil do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 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 saber mais, consulte [Criar um perfil para delegar permissões a um AWS service (Serviço da AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) 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 V2. Edite perfis de serviço somente quando o Amazon Lex V2 fornecer orientação para isso.

## Perfis vinculados ao serviço para o Amazon Lex V2
<a name="security_iam_service-with-iam-roles-service-linked"></a>

**Oferece suporte a funções vinculadas a serviços***: Parcial*

 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 assumir o perfil 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 administrador do IAM pode visualizar, mas não editar as permissões para perfis vinculados ao serviço. 

Para obter detalhes sobre como criar ou gerenciar funções vinculadas a serviços, consulte os [serviços da AWS que funcionam com](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) o IAM. Encontre um serviço na tabela que inclua um `Yes` na coluna **Perfil vinculado ao serviço**. Escolha o link **Sim** para visualizar a documentação do perfil vinculado a serviço desse serviço.

# Exemplos de políticas baseadas em identidade para o Amazon Lex V2
<a name="security_iam_id-based-policy-examples"></a>

Por padrão, usuários e perfis não têm permissão para criar ou modificar recursos do Amazon Lex V2. Para conceder permissão aos usuários para executar ações nos recursos que eles precisam, um administrador do IAM pode criar políticas do IAM.

Para aprender a criar uma política baseada em identidade do IAM ao usar esses documentos de política em JSON de exemplo, consulte [Criar políticas do IAM (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html) no *Guia do usuário do IAM*.

Para obter detalhes sobre ações e tipos de recursos definidos pelo Amazon Lex V2, incluindo o formato de cada um dos tipos de recursos, consulte [Ações, recursos e chaves de condição para o Amazon Lex V2 na Referência](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonlexv2.html) de *autorização de serviço*. ARNs 

**Topics**
+ [Práticas recomendadas de política](#security_iam_service-with-iam-policy-best-practices)
+ [Usar o console do Amazon Lex V2](#security_iam_id-based-policy-examples-console)
+ [Permitir que os usuários adicionem funções a um bot](#security_iam-bot-role)
+ [Permitir que os usuários adicionem canais a um bot](#security_iam-channel-role)
+ [Permitir que os usuários criem e atualizem bots](#security_iam-bot-create-update)
+ [Permitir que os usuários usem o Automated Chatbot Designer](#security_iam-bot-designer)
+ [Permita que os usuários usem uma AWS KMS chave para criptografar e descriptografar arquivos](#security_iam-bot-key)
+ [Permitir que os usuários excluam bots](#security_iam-bot-delete)
+ [Permitir que os usuários conversem com um bot](#security_iam-bot-conversation)
+ [Permitir que um usuário específico gerencie políticas baseadas em recursos](#security_iam_id-based-policy-examples-allow-resource)
+ [Permitir que um usuário exporte bots e localidades de bots](#security_iam_id-based-policy-examples-export)
+ [Permitir que um usuário exporte um vocabulário personalizado](#security_iam_id-based-policy-examples-import-vocab)
+ [Permitir que um usuário importe bots e localidades de bots](#security_iam_id-based-policy-examples-import)
+ [Permitir que um usuário importe um vocabulário personalizado](#secruity_iam_id-based-policy-examples-import-vocab)
+ [Permitir que um usuário migre um bot do Amazon Lex para o Amazon Lex V2](#security_iam_id-based-policy-examples-migrate)
+ [Permitir que os usuários visualizem suas próprias permissões](#security_iam_id-based-policy-examples-view-own-permissions)
+ [Permitir que um usuário desenhe o fluxo de conversa com o criador visual de conversas no Amazon Lex V2](#security_iam_allow-draw-conversation-flow)
+ [Permitir que os usuários criem e visualizem réplicas de bots, mas não as excluam](#security_iam_id-based-policy-examples-gr-permissions)

## Práticas recomendadas de política
<a name="security_iam_service-with-iam-policy-best-practices"></a>

As políticas baseadas em identidade determinam se alguém pode criar, acessar ou excluir recursos do Amazon Lex V2 em sua conta. Essas ações podem incorrer em custos para sua Conta da AWS. Ao criar ou editar políticas baseadas em identidade, siga estas diretrizes e recomendações:
+ **Comece a usar as políticas gerenciadas da AWS e avance para as permissões de privilégios mínimos — Para começar a conceder permissões** para seus usuários e cargas de trabalho, use as políticas *gerenciadas da AWS* que concedem permissões para muitos casos de uso comuns. Eles estão disponíveis no seu Conta da AWS. Recomendamos que você reduza ainda mais as permissões definindo políticas gerenciadas pelo cliente da AWS que sejam específicas para seus casos de uso. Para obter mais informações, consulte [as políticas gerenciadas pela AWS ou as](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) [políticas gerenciadas pela AWS para funções de trabalho](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html) no *Guia do usuário do IAM*.
+ **Aplique permissões de privilégio mínimo**: ao definir permissões com as políticas do IAM, conceda apenas as permissões necessárias para executar uma tarefa. Você faz isso definindo as ações que podem ser executadas em recursos específicos sob condições específicas, também conhecidas como *permissões de privilégio mínimo*. Para saber mais sobre como usar o IAM para aplicar permissões, consulte [Políticas e permissões no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) no *Guia do usuário do IAM*.
+ **Use condições nas políticas do IAM para restringir ainda mais o acesso**: é possível adicionar uma condição às políticas para limitar o acesso a ações e recursos. Por exemplo, é possível escrever uma condição de política para especificar que todas as solicitações devem ser enviadas usando SSL. Você também pode usar condições para conceder acesso às ações de serviço se elas forem usadas por meio de uma ação específica AWS service (Serviço da AWS), como CloudFormation. Para saber mais, consulte [Elementos da política JSON do IAM: condição](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) no *Guia do usuário do IAM*.
+ **Use o IAM Access Analyzer para validar suas políticas do IAM a fim de garantir permissões seguras e funcionais**: o IAM Access Analyzer valida as políticas novas e existentes para que elas sigam a linguagem de política do IAM (JSON) e as práticas recomendadas do IAM. O IAM Access Analyzer oferece mais de cem verificações de política e recomendações práticas para ajudar a criar políticas seguras e funcionais. Para saber mais, consulte [Validação de políticas do IAM Access Analyzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html) no *Guia do Usuário do IAM*.
+ **Exigir autenticação multifator (MFA**) — Se você tiver um cenário que exija usuários do IAM ou um usuário root, ative Conta da AWS a MFA para obter segurança adicional. Para exigir MFA quando as operações de API forem chamadas, adicione condições de MFA às suas políticas. Para saber mais, consulte [Configuração de acesso à API protegido por MFA](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html) no *Guia do Usuário do IAM*.

Para saber mais sobre as práticas recomendadas do IAM, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*.

## Usar o console do Amazon Lex V2
<a name="security_iam_id-based-policy-examples-console"></a>

Para acessar o console da Amazon Lex V2, você deve ter um conjunto mínimo de permissões. Essas permissões devem permitir que você liste e visualize detalhes sobre os recursos do Amazon Lex V2 em seu Conta da AWS. Caso crie uma política baseada em identidade mais restritiva que as permissões mínimas necessárias, o console não funcionará como pretendido para entidades (usuários ou perfis) com essa política.

Não é necessário conceder permissões mínimas do console para usuários que fazem chamadas somente à AWS CLI ou à API da AWS. Em vez disso, permita o acesso somente a ações que correspondam à operação de API que estiverem tentando executar.

Para garantir que usuários e perfis ainda possam usar o console do Amazon Lex V2, os usuários precisam ter acesso ao Console. Para obter mais informações sobre a criação de um usuário com acesso ao console, consulte [Como criar um usuário do IAM em sua conta da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) no *Guia do usuário do IAM*.

## Permitir que os usuários adicionem funções a um bot
<a name="security_iam-bot-role"></a>

Este exemplo mostra uma política que permite aos usuários do IAM adicionar permissões de consulta do Amazon Comprehend, da análise de sentimentos e do Amazon Kendra a um bot do Amazon Lex V2.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "Id1",
            "Effect": "Allow",
            "Action": "iam:PutRolePolicy",
            "Resource": "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
        },
        {
            "Sid": "Id2",
            "Effect": "Allow",
            "Action": "iam:GetRolePolicy",
            "Resource": "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
        }
    ]
}
```

------

## Permitir que os usuários adicionem canais a um bot
<a name="security_iam-channel-role"></a>

Esse exemplo é uma política que permite que os usuários do IAM adicionem um canal de mensagens a um bot. O usuário deve ter essa política em vigor antes de poder implantar um bot em uma plataforma de mensagens.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "Id1",
            "Effect": "Allow",
            "Action": "iam:PutRolePolicy",
            "Resource": "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
        },
        {
            "Sid": "Id2",
            "Effect": "Allow",
            "Action": "iam:GetRolePolicy",
            "Resource": "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
        }
    ]
}
```

------

## Permitir que os usuários criem e atualizem bots
<a name="security_iam-bot-create-update"></a>

Este exemplo mostra um exemplo de política que permite que os usuários do IAM criem e atualizem qualquer bot. A política inclui permissões para concluir essa ação no console ou usando a AWS CLI ou a API da AWS.

## Permitir que os usuários usem o Automated Chatbot Designer
<a name="security_iam-bot-designer"></a>

Este exemplo mostra um exemplo de política que permite que os usuários do IAM executem o Automated Chatbot Designer.

## Permita que os usuários usem uma AWS KMS chave para criptografar e descriptografar arquivos
<a name="security_iam-bot-key"></a>

Este exemplo mostra um exemplo de política que permite que os usuários do IAM usem uma chave gerenciada pelo AWS KMS cliente para criptografar e descriptografar dados.

## Permitir que os usuários excluam bots
<a name="security_iam-bot-delete"></a>

Este exemplo mostra uma política que permite que os usuários do IAM excluam qualquer bot. A política inclui permissões para concluir essa ação no console ou usando a AWS CLI ou a API da AWS.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "lex:DeleteBot",
                "lex:DeleteBotLocale",
                "lex:DeleteBotAlias",
                "lex:DeleteIntent",
                "lex:DeleteSlot",
                "lex:DeleteSlottype"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:lex:us-east-1:123412341234:bot/*",
                "arn:aws:lex:us-east-1:123412341234:bot-alias/*"
            ]
        }
    ]
}
```

------

## Permitir que os usuários conversem com um bot
<a name="security_iam-bot-conversation"></a>

Este exemplo mostra uma política que permite que os usuários do IAM tenham uma conversa com qualquer bot. A política inclui permissões para concluir essa ação no console ou usando a AWS CLI ou a API da AWS.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "lex:StartConversation",
                "lex:RecognizeText",
                "lex:RecognizeUtterance",
                "lex:GetSession",
                "lex:PutSession",
                "lex:DeleteSession"
            ],
            "Effect": "Allow",
            "Resource": "arn:aws:lex:us-east-1:123412341234:bot-alias/*"
        }
    ]
}
```

------

## Permitir que um usuário específico gerencie políticas baseadas em recursos
<a name="security_iam_id-based-policy-examples-allow-resource"></a>

O exemplo a seguir concede permissão para um usuário específico gerenciar as políticas baseadas em recursos. Ele permite o acesso do console e da API às políticas associadas a bots e aliases de bots.

## Permitir que um usuário exporte bots e localidades de bots
<a name="security_iam_id-based-policy-examples-export"></a>

A política de permissão do IAM a seguir permite que um usuário crie, atualize e obtenha uma exportação para um bot ou uma localidade de bot.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "lex:CreateExport",
                "lex:UpdateExport",
                "lex:DescribeExport",
                "lex:DescribeBot",
                "lex:DescribeBotLocale",
                "lex:ListBotLocales",
                "lex:DescribeIntent",
                "lex:ListIntents",
                "lex:DescribeSlotType",
                "lex:ListSlotTypes",
                "lex:DescribeSlot",
                "lex:ListSlots",
                "lex:DescribeCustomVocabulary"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:lex:us-east-1:123456789012:bot/*"
            ]
        }
    ]
}
```

------

## Permitir que um usuário exporte um vocabulário personalizado
<a name="security_iam_id-based-policy-examples-import-vocab"></a>

A política de permissão do IAM a seguir permite que um usuário exporte um vocabulário personalizado de uma localidade de bot.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "lex:CreateExport",
                "lex:UpdateExport",
                "lex:DescribeExport",
                "lex:DescribeCustomVocabulary"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:lex:us-east-1:123456789012:bot/*"
            ]
        }
    ]
}
```

------

## Permitir que um usuário importe bots e localidades de bots
<a name="security_iam_id-based-policy-examples-import"></a>

A política de permissão do IAM a seguir permite que um usuário importe um bot ou a localidade do bot e verifique o status de uma importação.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "lex:CreateUploadUrl",
                "lex:StartImport",
                "lex:DescribeImport",
                "lex:CreateBot",
                "lex:UpdateBot",
                "lex:DeleteBot",
                "lex:CreateBotLocale",
                "lex:UpdateBotLocale",
                "lex:DeleteBotLocale",
                "lex:CreateIntent",
                "lex:UpdateIntent",
                "lex:DeleteIntent",
                "lex:CreateSlotType",
                "lex:UpdateSlotType",
                "lex:DeleteSlotType",
                "lex:CreateSlot",
                "lex:UpdateSlot",
                "lex:DeleteSlot",
                "lex:CreateCustomVocabulary",
                "lex:UpdateCustomVocabulary",
                "lex:DeleteCustomVocabulary",
                "iam:PassRole"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:lex:us-east-1:123456789012:bot/*",
                "arn:aws:lex:us-east-1:123456789012:bot-alias/*"
            ]
        }
    ]
}
```

------

## Permitir que um usuário importe um vocabulário personalizado
<a name="secruity_iam_id-based-policy-examples-import-vocab"></a>

A política de permissão do IAM a seguir permite que um usuário importe um vocabulário personalizado para uma localidade de bot.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "lex:CreateUploadUrl",
                "lex:StartImport",
                "lex:DescribeImport",
                "lex:CreateCustomVocabulary",
                "lex:UpdateCustomVocabulary",
                "lex:DeleteCustomVocabulary"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:lex:us-east-1:123456789012:bot/*"
            ]
        }
    ]
}
```

------

## Permitir que um usuário migre um bot do Amazon Lex para o Amazon Lex V2
<a name="security_iam_id-based-policy-examples-migrate"></a>

A política de permissão do IAM a seguir permite que um usuário comece a migrar um bot do Amazon Lex para o Amazon Lex V2.

## Permitir que os usuários visualizem suas próprias permissões
<a name="security_iam_id-based-policy-examples-view-own-permissions"></a>

Este exemplo mostra como criar uma política que permita que os usuários do IAM visualizem as políticas gerenciadas e em linha anexadas a sua identidade de usuário. Essa política inclui permissões para concluir essa ação no console ou de forma programática usando a AWS CLI ou a API da AWS.

```
{
    "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": "*"
        }
    ]
}
```

## Permitir que um usuário desenhe o fluxo de conversa com o criador visual de conversas no Amazon Lex V2
<a name="security_iam_allow-draw-conversation-flow"></a>

A política de permissão do IAM a seguir permite que um usuário desenhe o fluxo de conversa com o criador visual de conversas no Amazon Lex V2.

## Permitir que os usuários criem e visualizem réplicas de bots, mas não as excluam
<a name="security_iam_id-based-policy-examples-gr-permissions"></a>

Você pode anexar as permissões a seguir a um perfil do IAM, para permitir que ele crie e visualize somente réplicas de bots. Ao omitir `lex:DeleteBotReplica`, você evita que o perfil exclua réplicas de bots. Para obter mais informações, consulte [Permissões para replicar bots e gerenciar réplicas de bots no Lex V2](gr-permissions.md).







# Exemplos de políticas baseadas em recursos para o Amazon Lex V2
<a name="security_iam_resource-based-policy-examples"></a>

Uma *política baseada em recursos* é anexada a um recurso, como um bot ou um alias de bot. Com uma política baseada em recursos, você pode especificar quem tem acesso ao recurso e as ações que essas pessoas podem realizar nele. Por exemplo, você pode adicionar políticas baseadas em recursos que permitem que um usuário modifique um bot específico ou permita que um usuário use operações de runtime em um alias de bot específico.

Ao usar uma política baseada em recursos, você pode permitir que outros serviços da AWS acessem recursos em sua conta. Por exemplo, você pode permitir que o Amazon Connect acesse um bot do Amazon Lex V2.

Para saber como criar um bot ou alias de bot, consulte [Como trabalhar com bots do Amazon Lex V2](building-bots.md).

**Topics**
+ [Use o console para especificar uma política baseada em recurso.](#security_iam_resource-based-policy-examples-console)
+ [Usar a API para especificar uma política baseada em recurso.](#security_iam_resource-based-policy-examples-api)
+ [Permitir que um perfil do IAM atualize um bot e liste aliases de bots](#security_iam_resource-based-policy-examples-allow-lex-models)
+ [Permitir que um usuário converse com um bot](#security_iam_resource-based-policy-examples-allow-lex-runtime)
+ [Permitir que um serviço da AWS use um bot específico do Amazon Lex V2](#security_iam_resource-based-policy-examples-allow-lex-connect)

## Use o console para especificar uma política baseada em recurso.
<a name="security_iam_resource-based-policy-examples-console"></a>

Você pode usar o console Amazon Lex V2 para gerenciar as políticas baseadas em recursos para seus bots e aliases de bots. Você insere a estrutura JSON de uma política e o console a associa ao recurso. Se já houver uma política associada a um recurso, você poderá usar o console para visualizar e modificar a política.

Quando você salva uma política com o editor de políticas, o console verifica a sintaxe da política. Se a política contiver erros, como um usuário inexistente ou uma ação que não seja permitida pelo recurso, ela retornará um erro e não salvará a política. 

Veja a seguir o editor de políticas baseado em recursos para um bot no console. O editor de políticas para um alias de bot é semelhante.

![\[\]](http://docs.aws.amazon.com/pt_br/lexv2/latest/dg/images/resource-policy-editor.png)


**Para abrir o editor de políticas para um bot**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Na lista de **Bots**, escolha o bot cuja política deseja editar.

1. Na seção **Política baseada em recursos**, escolha **Editar**.

**Para abrir o editor de políticas para um alias de bot**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Na lista de **bots**, escolha o bot que contém o alias que você deseja editar.

1. No menu à esquerda, selecione **Aliases** e, em seguida, escolha o alias que será editado.

1. Na seção **Política baseada em recursos**, escolha **Editar**.

## Usar a API para especificar uma política baseada em recurso.
<a name="security_iam_resource-based-policy-examples-api"></a>

Você pode usar as operações de API para gerenciar as políticas baseadas em recursos para seus bots e aliases de bot. Existem operações para criar, atualizar e excluir políticas.

[CreateResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateResourcePolicy.html)  
Adiciona uma nova política de recursos com os enunciados de política definidas a um bot ou alias de bot.

[CreateResourcePolicyStatement](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateResourcePolicyStatement.html)  
Adiciona um novo enunciado de política de recursos de a um bot ou alias de bot.

[DeleteResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteResourcePolicy.html)  
Remove uma política de recursos de um bot ou alias de bot.

[DeleteResourcePolicyStatement](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteResourcePolicyStatement.html)  
Remove um enunciado de política de recursos de um bot ou alias de bot.

[DescribeResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeResourcePolicy.html)  
Obtém uma política de recursos e a revisão da política.

[UpdateResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateResourcePolicy.html)  
Substitui a política de recursos existente para um bot ou alias de bot por uma nova.

### Exemplos
<a name="collapsible-api-example"></a>

------
#### [ Java ]

O exemplo a seguir mostra como usar as operações de política baseada em recursos para gerenciar uma política baseada em recursos.

```
        /*
         * Create a new policy for the specified bot alias 
         * that allows a role to invoke lex:UpdateBotAlias on it.
         * The created policy will have revision id 1.
         */
        
        CreateResourcePolicyRequest createPolicyRequest =
                CreateResourcePolicyRequest.builder()
                        .resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
                        .policy("{\"Version\": \"2012-10-17\",\"Statement\": [{\"Sid\": \"BotAliasEditor\",\"Effect\": \"Allow\",\"Principal\": {\"AWS\": \"arn:aws:iam::123456789012:role/BotAliasEditor\"},\"Action\": [\"lex:UpdateBotAlias\"],\"Resource\":[\"arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID\"]]}")

        lexmodelsv2Client.createResourcePolicy(createPolicyRequest);
        
        /*
         * Overwrite the policy for the specified bot alias with a new policy.
         * Since no expectedRevisionId is provided, this request overwrites the current revision.
         * After this update, the revision id for the policy is 2.
         */
        UpdateResourcePolicyRequest updatePolicyRequest =
        UpdateResourcePolicyRequest.builder()
                        .resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
                        .policy("{\"Version\": \"2012-10-17\",\"Statement\": [{\"Sid\": \"BotAliasEditor\",\"Effect\": \"Deny\",\"Principal\": {\"AWS\": \"arn:aws:iam::123456789012:role/BotAliasEditor\"},\"Action\": [\"lex:UpdateBotAlias\"],\"Resource\":[\"arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID\"]]}")

        lexmodelsv2Client.updateResourcePolicy(updatePolicyRequest);
        
        /*
         * Creates a statement in an existing policy for the specified bot alias 
         * that allows a role to invoke lex:RecognizeText on it.
         * This request expects to update revision 2 of the policy. The request will fail
         * if the current revision of the policy is no longer revision 2.
         * After this request, the revision id for this policy will be 3.
         */
        
        CreateResourcePolicyStatementRequest createStatementRequest =
                CreateResourcePolicyStatementRequest.builder()
                        .resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
                        .effect("Allow")
                        .principal(Principal.builder().arn("arn:aws:iam::123456789012:role/BotRunner").build())
                        .action("lex:RecognizeText")
                        .statementId("BotRunnerStatement")
                        .expectedRevisionId(2)
                        .build();

        lexmodelsv2Client.createResourcePolicyStatement(createStatementRequest);

        /*
         * Deletes a statement from an existing policy for the specified bot alias by statementId.
         * Since no expectedRevisionId is supplied, the request will remove the statement from
         * the current revision of the policy for the bot alias. 
         * After this request, the revision id for this policy will be 4.
         */
        DeleteResourcePolicyRequest deleteStatementRequest =
                DeleteResourcePolicyRequest.builder()
                        .resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
                        .statementId("BotRunnerStatement")                        
                        .build();

        lexmodelsv2Client.deleteResourcePolicy(deleteStatementRequest);
        
        /*
         * Describe the current policy for the specified bot alias
         * It always returns the current revision.
         */
        DescribeResourcePolicyRequest describePolicyRequest =
                DescribeResourcePolicyRequest.builder()
                        .resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
                        .build();

        lexmodelsv2Client.describeResourcePolicy(describePolicyRequest);
        
        
        /*
         * Delete the current policy for the specified bot alias
         * This request expects to delete revision 3 of the policy. Since the revision id for 
         * this policy is already at 4, this request will fail.
         */
        DeleteResourcePolicyRequest deletePolicyRequest =
                DeleteResourcePolicyRequest.builder()
                        .resourceArn("arn:aws:lex:Region:123456789012:bot-alias/MYBOTALIAS/TSTALIASID")
                        .expectedRevisionId(3);
                        .build();

        lexmodelsv2Client.deleteResourcePolicy(deletePolicyRequest);
```

------

## Permitir que um perfil do IAM atualize um bot e liste aliases de bots
<a name="security_iam_resource-based-policy-examples-allow-lex-models"></a>

O exemplo a seguir concede permissões para um perfil específico do IAM chamar operações de API de construção de modelos do Amazon Lex V2 para modificar um bot existente. O usuário pode listar aliases para um bot e atualizar o bot, mas não pode excluir o bot ou os aliases do bot. 

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "botBuilders",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/BotBuilder"
            },
            "Action": [
                "lex:ListBotAliases",
                "lex:UpdateBot"
            ],
            "Resource": [
                "arn:aws:lex:us-east-1:123456789012:bot/MYBOT"
            ]
        }
    ]
}
```

------

## Permitir que um usuário converse com um bot
<a name="security_iam_resource-based-policy-examples-allow-lex-runtime"></a>

O exemplo a seguir concede permissão para que um usuário específico chame operações de API de runtime do Amazon Lex V2 em um único alias de um bot.

O usuário tem sua permissão especificamente negada para atualizar ou excluir o alias do bot.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "botRunners",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:user/botRunner"
            },
            "Action": [
                "lex:RecognizeText",
                "lex:RecognizeUtterance",
                "lex:StartConversation",
                "lex:DeleteSession",
                "lex:GetSession",
                "lex:PutSession"
            ],
            "Resource": [
                "arn:aws:lex:us-east-1:123456789012:bot-alias/MYBOT/MYBOTALIAS"
            ]
        },
        {
            "Sid": "botRunners",
            "Effect": "Deny",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:user/botRunner"
            },
            "Action": [
                "lex:UpdateBotAlias",
                "lex:DeleteBotAlias"
            ],
            "Resource": [
                "arn:aws:lex:us-east-1:123456789012:bot-alias/MYBOT/MYBOTALIAS"
            ]
        }
    ]
}
```

------

## Permitir que um serviço da AWS use um bot específico do Amazon Lex V2
<a name="security_iam_resource-based-policy-examples-allow-lex-connect"></a>

O exemplo a seguir concede permissão para AWS Lambda que o Amazon Connect chame operações de API de tempo de execução do Amazon Lex V2.

O bloco de condições é necessário para entidades principais de serviço e deve usar as chaves de contexto globais `AWS:SourceAccount` e `AWS:SourceArn`. 

O `AWS:SourceAccount` é o ID da conta que está chamando o bot do Amazon Lex V2.

O `AWS:SourceArn` é o ARN do recurso da instância de serviço do Amazon Connect ou da função do Lambda da qual a chamada para o alias de bot do Amazon Lex V2 se origina.

# Políticas gerenciadas pela AWS para o Amazon Lex V2
<a name="security-iam-awsmanpol"></a>







Uma política gerenciada pela AWS é uma política independente que é criada e administrada por ela. As políticas gerenciadas pela AWS são projetadas para fornecer permissões para muitos casos de uso comuns, para que você possa começar a atribuir permissões a usuários, grupos e funções.

Lembre-se de que as políticas gerenciadas pela AWS podem não conceder permissões de privilégio mínimo para seus casos de uso específicos porque estão disponíveis para uso de todos os clientes da AWS. Recomendamos que você reduza ainda mais as permissões definindo as [ políticas gerenciadas pelo cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies) que são específicas para seus casos de uso.

Você não pode alterar as permissões definidas nas políticas gerenciadas pela AWS. Se a AWS atualizar as permissões definidas em uma política gerenciada pela AWS, a atualização afetará todas as identidades principais (usuários, grupos e funções) às quais a política está vinculada. É mais provável que a AWS atualize uma política gerenciada pela AWS quando uma nova AWS service (Serviço da AWS) é lançada ou novas operações de API se tornam disponíveis para serviços existentes.

Para obter mais informações, consulte [as políticas gerenciadas pela AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) no *Guia do usuário do IAM*.









## Política gerenciada pela AWS: AmazonLexReadOnly
<a name="security-iam-awsmanpol-AmazonLexReadOnly"></a>

É possível anexar a política `AmazonLexReadOnly` às suas identidades do IAM.

Essa política concede permissões somente de leitura que permitem aos usuários visualizar todas as ações no serviço de criação de modelos do Amazon Lex V2 e Amazon Lex.

**Detalhes de permissões**

Esta política inclui as seguintes permissões:
+ `lex` – Acesso somente para leitura aos recursos do Amazon Lex V2 e do Amazon Lex no serviço de criação de modelos.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AmazonLexReadOnlyStatement1",
            "Effect": "Allow",
            "Action": [
                "lex:GetBot",
                "lex:GetBotAlias",
                "lex:GetBotAliases",
                "lex:GetBots",
                "lex:GetBotChannelAssociation",
                "lex:GetBotChannelAssociations",
                "lex:GetBotVersions",
                "lex:GetBuiltinIntent",
                "lex:GetBuiltinIntents",
                "lex:GetBuiltinSlotTypes",
                "lex:GetIntent",
                "lex:GetIntents",
                "lex:GetIntentVersions",
                "lex:GetSlotType",
                "lex:GetSlotTypes",
                "lex:GetSlotTypeVersions",
                "lex:GetUtterancesView",
                "lex:DescribeBot",
                "lex:DescribeBotAlias",
                "lex:DescribeBotChannel",
                "lex:DescribeBotLocale",
                "lex:DescribeBotRecommendation",
                "lex:DescribeBotReplica",
                "lex:DescribeBotVersion",
                "lex:DescribeExport",
                "lex:DescribeImport",
                "lex:DescribeIntent",
                "lex:DescribeResourcePolicy",
                "lex:DescribeSlot",
                "lex:DescribeSlotType",
                "lex:ListBots",
                "lex:ListBotLocales",
                "lex:ListBotAliases",
                "lex:ListBotAliasReplicas",
                "lex:ListBotChannels",
                "lex:ListBotRecommendations",
                "lex:ListBotReplicas",
                "lex:ListBotVersions",
                "lex:ListBotVersionReplicas",
                "lex:ListBuiltInIntents",
                "lex:ListBuiltInSlotTypes",
                "lex:ListExports",
                "lex:ListImports",
                "lex:ListIntents",
                "lex:ListRecommendedIntents",
                "lex:ListSlots",
                "lex:ListSlotTypes",
                "lex:ListTagsForResource",
                "lex:SearchAssociatedTranscripts",
                "lex:ListCustomVocabularyItems"
            ],
            "Resource": "*"
        }
    ]
}
```

------

## Política gerenciada pela AWS: AmazonLexRunBotsOnly
<a name="security-iam-awsmanpol-AmazonLexRunBotsOnly"></a>

É possível anexar a política `AmazonLexRunBotsOnly` às suas identidades do IAM.

Essa política concede permissões somente de leitura que permitem o acesso para executar bots conversacionais do Amazon Lex V2 e do Amazon Lex. .

**Detalhes de permissões**

Esta política inclui as seguintes permissões:
+ `lex` – Acesso somente para leitura a todas as ações no runtime do Amazon Lex V2 e do Amazon Lex.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "lex:PostContent",
                "lex:PostText",
                "lex:PutSession",
                "lex:GetSession",
                "lex:DeleteSession",
                "lex:RecognizeText",
                "lex:RecognizeUtterance",
                "lex:StartConversation"
            ],
            "Resource": "*"
        }
    ]
}
```

------

## Política gerenciada pela AWS: AmazonLexFullAccess
<a name="security-iam-awsmanpol-AmazonLexFullAccess"></a>

É possível anexar a política `AmazonLexFullAccess` às suas identidades do IAM.

Essa política concede permissões administrativas que permitem ao usuário criar, ler, atualizar e excluir atributos do Amazon Lex V2 e do Amazon Lex e executar bots de conversação do Amazon Lex V2 e do Amazon Lex.

**Detalhes de permissões**

Esta política inclui as seguintes permissões:
+ `lex` – Permite que as entidades principais tenham acesso de leitura e gravação a todas as ações nos serviços de runtime e construção de modelos do Amazon Lex V2 e do Amazon Lex.
+ `cloudwatch`— Permite que os diretores visualizem CloudWatch métricas e alarmes da Amazon.
+ `iam`: permite que os entidades principais criem e excluam funções vinculadas a serviços, passem funções e anexem e desanexem políticas a uma função. As permissões são restritas a “lex.amazonaws.com” para operações do Amazon Lex e a “lexv2.amazonaws.com” para operações do Amazon Lex V2.
+ `kendra`: permite que as entidades principais listem índices do Amazon Kendra.
+ `kms`: permite que as entidades principais descrevam chaves e aliases do AWS KMS .
+ `lambda`: permite que as entidades principais listem funções AWS Lambda e gerenciem as permissões associadas a qualquer função do Lambda.
+ `polly`: permite que as entidades principais descrevam vozes do Amazon Polly e sintetizem a fala.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AmazonLexFullAccessStatement1",
            "Effect": "Allow",
            "Action": [
                "cloudwatch:GetMetricStatistics",
                "cloudwatch:DescribeAlarms",
                "cloudwatch:DescribeAlarmsForMetric",
                "kms:DescribeKey",
                "kms:ListAliases",
                "lambda:GetPolicy",
                "lambda:ListFunctions",
                "lambda:ListAliases",
                "lambda:ListVersionsByFunction",
                "lex:*",
                "polly:DescribeVoices",
                "polly:SynthesizeSpeech",
                "kendra:ListIndices",
                "iam:ListRoles",
                "s3:ListAllMyBuckets",
                "logs:DescribeLogGroups",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Sid": "AmazonLexFullAccessStatement2",
            "Effect": "Allow",
            "Action": [
                "bedrock:ListFoundationModels"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock:InvokeModel"
            ],
            "Resource": "arn:aws:bedrock:*::foundation-model/*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "lambda:AddPermission",
                "lambda:RemovePermission"
            ],
            "Resource": "arn:aws:lambda:*:*:function:AmazonLex*",
            "Condition": {
                "StringEquals": {
                    "lambda:Principal": "lex.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement3",
            "Effect": "Allow",
            "Action": [
                "iam:GetRole",
                "iam:GetRolePolicy"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots",
                "arn:aws:iam::*:role/aws-service-role/channels.lex.amazonaws.com/AWSServiceRoleForLexChannels",
                "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*",
                "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*",
                "arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
            ]
        },
        {
            "Sid": "AmazonLexFullAccessStatement4",
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "lex.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement5",
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/channels.lex.amazonaws.com/AWSServiceRoleForLexChannels"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "channels.lex.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement6",
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "lexv2.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement7",
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "channels.lexv2.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement8",
            "Effect": "Allow",
            "Action": [
                "iam:CreateServiceLinkedRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "replication.lexv2.amazonaws.com"
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement9",
            "Effect": "Allow",
            "Action": [
                "iam:DeleteServiceLinkedRole",
                "iam:GetServiceLinkedRoleDeletionStatus"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots",
                "arn:aws:iam::*:role/aws-service-role/channels.lex.amazonaws.com/AWSServiceRoleForLexChannels",
                "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*",
                "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*",
                "arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
            ]
        },
        {
            "Sid": "AmazonLexFullAccessStatement10",
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/lex.amazonaws.com/AWSServiceRoleForLexBots"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "lex.amazonaws.com"
                    ]
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement11",
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/lexv2.amazonaws.com/AWSServiceRoleForLexV2Bots*"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "lexv2.amazonaws.com"
                    ]
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement12",
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/channels.lexv2.amazonaws.com/AWSServiceRoleForLexV2Channels*"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "channels.lexv2.amazonaws.com"
                    ]
                }
            }
        },
        {
            "Sid": "AmazonLexFullAccessStatement13",
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": [
                "arn:aws:iam::*:role/aws-service-role/replication.lexv2.amazonaws.com/AWSServiceRoleForLexV2Replication*"
            ],
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": [
                        "lexv2.amazonaws.com"
                    ]
                }
            }
        }
    ]
}
```

------

## Política gerenciada pela AWS: AmazonLexReplicationPolicy
<a name="security-iam-awsmanpol-AmazonLexReplicationPolicy"></a>



Não é possível anexar a `AmazonLexReplicationPolicy` às entidades do IAM. Essa política é anexada a um perfil vinculado ao serviço que permite ao Amazon Lex V2 realizar ações em seu nome. Para obter mais informações, consulte [Usar perfis vinculados ao serviço para o Amazon Lex V2](using-service-linked-roles.md).



Essa política concede permissões administrativas que permitem ao Amazon Lex V2 replicar recursos da AWS em todas as regiões em seu nome. Você pode anexar essa política para permitir que um perfil replique facilmente os recursos, incluindo bots, localidades, versões, aliases, intenções, tipos de slots, slots e vocabulários personalizados.



**Detalhes das permissões**

Esta política inclui as seguintes permissões.




+ `lex`: permite que as entidades principais repliquem recursos em outras regiões.
+ `iam`: permite que as entidades principais passem perfis do IAM. Isso é necessário para que o Amazon Lex V2 tenha permissões para replicar recursos em outras regiões.



------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
	{
		"Sid": "ReplicationPolicyStatement1",
		"Effect": "Allow",
		"Action": [
			"lex:BuildBotLocale",
			"lex:ListBotLocales",
			"lex:CreateBotAlias",
			"lex:UpdateBotAlias",
			"lex:DeleteBotAlias",
			"lex:DescribeBotAlias",
			"lex:CreateBotVersion",
			"lex:DeleteBotVersion",
			"lex:DescribeBotVersion",
			"lex:CreateExport",
			"lex:DescribeBot",
			"lex:UpdateExport",
			"lex:DescribeExport",
			"lex:DescribeBotLocale",
			"lex:DescribeIntent",
			"lex:ListIntents",
			"lex:DescribeSlotType",
			"lex:ListSlotTypes",
			"lex:DescribeSlot",
			"lex:ListSlots",
			"lex:DescribeCustomVocabulary",
			"lex:StartImport",
			"lex:DescribeImport",
			"lex:CreateBot",
			"lex:UpdateBot",
			"lex:DeleteBot",
			"lex:CreateBotLocale",
			"lex:UpdateBotLocale",
			"lex:DeleteBotLocale",
			"lex:CreateIntent",
			"lex:UpdateIntent",
			"lex:DeleteIntent",
			"lex:CreateSlotType",
			"lex:UpdateSlotType",
			"lex:DeleteSlotType",
			"lex:CreateSlot",
			"lex:UpdateSlot",
			"lex:DeleteSlot",
			"lex:CreateCustomVocabulary",
			"lex:UpdateCustomVocabulary",
			"lex:DeleteCustomVocabulary",
			"lex:DeleteBotChannel",
			"lex:ListTagsForResource",
			"lex:TagResource",
			"lex:UntagResource",
			"lex:CreateResourcePolicy",
			"lex:DeleteResourcePolicy",
			"lex:DescribeResourcePolicy",
			"lex:UpdateResourcePolicy"
		],
		"Resource": [
			"arn:aws:lex:*:*:bot/*",
			"arn:aws:lex:*:*:bot-alias/*"
		]
	},
	{
		"Sid": "ReplicationPolicyStatement2",
		"Effect": "Allow",
		"Action": [
			"lex:CreateUploadUrl",
			"lex:ListBots"
		],
		"Resource": "*"
	},
	{
		"Sid": "ReplicationPolicyStatement3",
		"Effect": "Allow",
		"Action": [
			"iam:PassRole"
		],
		"Resource": "*",
		"Condition": {
			"StringEquals": {
				"iam:PassedToService": "lexv2.amazonaws.com"
			}
		}
	}
    ]
}
```

------

## Política gerenciada pela AWS: AmazonLex V2 BedrockAgentPolicy
<a name="security-iam-awsmanpol-AmazonLexV2BedrockAgentPolicy"></a>

Política do Amazon Lex V2 para agentes do Amazon Bedrock

Resposta

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Sid": "LexV2TrustPolicy",
      "Principal": {
        "Service": "lexv2.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{accountId}"
        }
      }
    }
  ]
}
```

------

## Política gerenciada pela AWS: AmazonLex V2 BedrockKnowledgeBasePolicy
<a name="security-iam-awsmanpol-AmazonLexV2BedrockKnowledgeBasePolicy"></a>

Política do Amazon Lex V2 para bases de conhecimento do Amazon Bedrock

Resposta

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Sid": "LexV2TrustPolicy",
      "Principal": {
        "Service": "lexv2.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
     "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{accountId}"
        }
      }
    }
  ]
}
```

------

## Política gerenciada pela AWS: AmazonLex V2 BedrockAgentPolicyInternal
<a name="security-iam-awsmanpol-AmazonLexV2BedrockAgentPolicyInternal"></a>

Política interna do Amazon Lex V2 para agentes do Amazon Bedrock

Resposta

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Sid": "LexV2InternalTrustPolicy",
      "Principal": {
        "Service": "lexv2.aws.internal"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{accountId}"
        }
      }
    }
  ]
}
```

------

## Política gerenciada pela AWS: AmazonLex V2 BedrockKnowledgeBasePolicyInternal
<a name="security-iam-awsmanpol-AmazonLexV2BedrockKnowledgeBasePolicyInternal"></a>

Política interna do Amazon Lex V2 para bases de conhecimento do Amazon Bedrock

Resposta

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "LexV2InternalTrustPolicy",
      "Effect": "Allow",
      "Principal": {
        "Service": "lexv2.aws.internal"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{accountId}"
        }
      }
    }
  ]
}
```

------





## Atualizações do Amazon Lex V2 para as políticas gerenciadas da AWS
<a name="security-iam-awsmanpol-updates"></a>



Veja detalhes sobre as atualizações das políticas gerenciadas da AWS para o Amazon Lex V2 desde que esse serviço começou a monitorar essas mudanças. Para obter alertas automáticos sobre alterações feitas nesta página, inscreva-se no feed RSS na página [Histórico da documentação do Amazon Lex V2](doc-history.md) do Amazon Lex V2.




| Alteração | Descrição | Data | 
| --- | --- | --- | 
|  [AmazonLexReplicationPolicy](#security-iam-awsmanpol-AmazonLexReplicationPolicy): política atualizada  |  O Amazon Lex V2 atualizou a política para permitir a replicação de tags e. ResourceBasedPolicy  | 24 de junho de 2025 | 
|  [AmazonLexV2 BedrockKnowledgeBasePolicyInternal](#security-iam-awsmanpol-AmazonLexV2BedrockKnowledgeBasePolicyInternal) — Nova política  |  O Amazon Lex V2 adicionou uma nova política para permitir a replicação dos recursos da base de conhecimento do Amazon Bedrock.  | 30 de agosto de 2024 | 
|  [AmazonLexV2 BedrockAgentPolicyInternal](#security-iam-awsmanpol-AmazonLexV2BedrockAgentPolicyInternal) — Nova política  |  O Amazon Lex V2 adicionou uma nova política para permitir a replicação dos recursos de agente do Amazon Bedrock.  | 30 de agosto de 2024 | 
|  [AmazonLexV2 BedrockKnowledgeBasePolicy](#security-iam-awsmanpol-AmazonLexV2BedrockKnowledgeBasePolicy) — Nova política  |  O Amazon Lex V2 adicionou uma nova política para permitir a replicação dos recursos da base de conhecimento do Amazon Bedrock.  | 30 de agosto de 2024 | 
|  [AmazonLexV2 BedrockAgentPolicy](#security-iam-awsmanpol-AmazonLexV2BedrockAgentPolicy) — Nova política  |  O Amazon Lex V2 adicionou uma nova política para permitir a replicação dos recursos de agente do Amazon Bedrock.  | 30 de agosto de 2024 | 
|  [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir réplicas de acesso somente leitura de recursos do bot.  | 10 de maio de 2024 | 
|  [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir a replicação de recursos do bot em outras regiões.  | 16 de abril de 2024 | 
|  [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir a replicação de recursos do bot em outras regiões.  | 31 de janeiro de 2024 | 
|  [AmazonLexReplicationPolicy](#security-iam-awsmanpol-AmazonLexReplicationPolicy) – Nova política  |  O Amazon Lex V2 adicionou uma nova política para permitir a replicação de recursos do bot em outras regiões.  | 31 de janeiro de 2024 | 
|  [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir acesso somente leitura à lista de itens de vocabulário personalizados.  | 29 de novembro de 2022 | 
|  [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir acesso somente para leitura às operações do serviço de construção de modelos do Amazon Lex V2.  | 18 de agosto de 2021 | 
| [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir acesso somente para leitura às operações de chatbot automatizado do Amazon Lex V2.  | 1º de dezembro de 2021 | 
|  [AmazonLexFullAccess](#security-iam-awsmanpol-AmazonLexFullAccess) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir acesso somente para leitura às operações do serviço de construção de modelos do Amazon Lex V2.  | 18 de agosto de 2021 | 
|  [AmazonLexReadOnly](#security-iam-awsmanpol-AmazonLexReadOnly) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir acesso somente para leitura às operações do serviço de construção de modelos do Amazon Lex V2.  | 18 de agosto de 2021 | 
|  [AmazonLexRunBotsOnly](#security-iam-awsmanpol-AmazonLexRunBotsOnly) – atualização para uma política existente  |  O Amazon Lex V2 adicionou novas permissões para permitir acesso somente para leitura às operações do serviço de runtime do Amazon Lex V2.  | 18 de agosto de 2021 | 
|  O Amazon Lex V2 passou a monitorar alterações  |  O Amazon Lex V2 começou a monitorar as mudanças em suas políticas gerenciadas pela AWS.  | 18 de agosto de 2021 | 

# Usar perfis vinculados ao serviço para o Amazon Lex V2
<a name="using-service-linked-roles"></a>

O Amazon Lex V2 usa funções vinculadas ao [serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) AWS Identity and Access Management (IAM). Um perfil vinculado ao serviço é um tipo especial de perfil do IAM vinculado diretamente ao Amazon Lex V2. As funções vinculadas ao serviço são predefinidas pelo Amazon Lex V2 e incluem todas as permissões que o serviço exige para chamar outros serviços da AWS em seu nome. 

Um perfil vinculado ao serviço facilita a configuração do Amazon Lex V2 porque você não precisa adicionar as permissões necessárias manualmente. O Amazon Lex V2 define as permissões dos perfis vinculados ao serviço e, a não ser que esteja definido de outra forma, somente o Amazon Lex V2 poderá assumir os perfis. As permissões definidas incluem a política de confiança e a política de permissões, que não pode ser anexada a nenhuma outra entidade do IAM.

Para obter informações sobre outros serviços que oferecem suporte aos perfis vinculados ao serviço, consulte [Serviços da AWS que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) e procure os serviços com **Sim **na coluna **Perfil vinculado ao serviço**. Escolha um **Sim** com um link para exibir a documentação da função vinculada a serviço desse serviço.

Você deve configurar permissões para que uma entidade do IAM (por exemplo, um usuário, grupo ou função) crie, edite ou exclua um perfil vinculado a serviço. Para saber mais, consulte [Permissões de Função Vinculadas ao Serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) no *Guia do Usuário do IAM*.

Você pode excluir um perfil vinculado ao serviço somente depois de excluir os recursos relacionados. Isso protege seus recursos do Amazon Lex V2, pois você não pode remover por engano as permissões para acessar os recursos.

**Topics**
+ [Criar um perfil vinculado ao serviço para o Amazon Lex V2](#create-slr)
+ [Editar um perfil vinculado ao serviço do Amazon Lex V2](#edit-slr)
+ [Excluir um perfil vinculado ao serviço do Amazon Lex V2](#delete-slr)
+ [Permissões de perfil vinculado ao serviço para o Amazon Lex V2](#slr-permissions)
+ [Regiões com suporte a perfis vinculados ao serviço do Amazon Lex V2.](#slr-regions)

## Criar um perfil vinculado ao serviço para o Amazon Lex V2
<a name="create-slr"></a>

Você não precisa criar manualmente uma função vinculada ao serviço, porque o Amazon Lex V2 cria a função vinculada ao serviço para você quando você executa a ação relevante (consulte [Permissões de perfil vinculado ao serviço para o Amazon Lex V2](#slr-permissions) para obter mais informações) no Console de Gerenciamento da AWS, na CLI da AWS ou na API da AWS.

Se excluir esse perfil vinculado ao serviço e precisar criá-lo novamente, você poderá usar esse mesmo processo para criar um novo perfil em sua conta.

## Editar um perfil vinculado ao serviço do Amazon Lex V2
<a name="edit-slr"></a>

O Amazon Lex V2 não permite que você edite perfis vinculados ao serviço. Depois que você criar um perfil vinculado ao serviço, não poderá alterar o nome do perfil, pois várias entidades podem fazer referência ao perfil. No entanto, você poderá editar a descrição de um perfil usando o IAM. Para mais informações, consulte [Editar uma função vinculada ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) no *Guia do usuário do IAM*.

## Excluir um perfil vinculado ao serviço do Amazon Lex V2
<a name="delete-slr"></a>

Se você não precisar mais usar um recurso ou serviço que requer um perfil vinculado ao serviço, é recomendável excluí-lo. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar os recursos de seu perfil vinculado ao serviço antes de excluí-lo manualmente.

**nota**  
Se o serviço do Amazon Lex V2 estiver usando o perfil quando você tentar excluir os recursos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.

Para ver as etapas para excluir recursos para perfis vinculados ao serviço específicos no Amazon Lex V2, consulte a seção específica do perfil em [Permissões de perfil vinculado ao serviço para o Amazon Lex V2](#slr-permissions).

**Como excluir manualmente o perfil vinculado ao serviço usando o IAM**

Depois de excluir recursos relacionados a uma função vinculada ao serviço, use o console do IAM, a CLI da AWS ou a API da AWS para excluir a função. Para saber mais, consulte [Excluir um perfil vinculado ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) no *Guia do usuário do IAM*.

## Permissões de perfil vinculado ao serviço para o Amazon Lex V2
<a name="slr-permissions"></a>

O Amazon Lex V2 usa perfis vinculados ao serviço com os prefixos a seguir.

**Topics**
+ [AWSServiceRoleForLexRobôs V2\$1](#slr-bots)
+ [AWSServiceRoleForLexCanais V2\$1](#slr-channels)
+ [AWSServiceRoleForLexReplicação V2](#slr-replication)

### AWSServiceRoleForLexRobôs V2\$1
<a name="slr-bots"></a>

A função AWSService RoleForLex V2Bots\$1 dá permissões para conectar seu bot a outros serviços necessários. Esse perfil inclui uma política de confiança para permitir que o serviço lexv2.amazonaws.com assuma o perfil e permissões para realizar as ações a seguir.
+ Use o Amazon Polly para sintetizar a fala em todos os recursos do Amazon Lex V2 que a ação permite.
+ Se um bot estiver configurado para usar a análise de sentimento do Amazon Comprehend, detecte o sentimento em todos os recursos do Amazon Lex V2 que a ação permite.
+ Se um bot estiver configurado para armazenar logs de áudio em um bucket do S3, coloque os objetos em um bucket especificado.
+ Se um bot estiver configurado para armazenar logs de áudio e texto, crie um fluxo de logs e coloque os logs em um grupo de logs especificado.
+ Se um bot estiver configurado para usar uma AWS KMS chave para criptografar dados, gere uma chave de dados específica.
+ Se um bot estiver configurado para usar a intenção `KendraSearchIntent`, consulte o acesso a um índice específico do Amazon Kendra.

**Para criar o perfil**

[O Amazon Lex V2 cria uma nova função AWSService RoleForLex V2Bots\$1 com um sufixo aleatório na sua conta toda vez que você cria um bot.](create-bot.md) O Amazon Lex V2 modifica o perfil quando você adiciona recursos adicionais a um bot. Por exemplo, se você [adicionar a análise de sentimento do Amazon Comprehend a um bot](sentiment.md), o Amazon Lex V2 adicionará a permissão para a ação `lex:DetectSentiment` ao perfil de serviço.

**Para excluir o perfil**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. No painel de navegação esquerdo, selecione **Bots** e escolha o bot cujo perfil vinculado ao serviço você deseja excluir.

1. Selecione qualquer versão do bot.

1. O **perfil de runtime das permissões do IAM** está nos **Detalhes da versão**.

1. Volte à página **Bots** e selecione o botão de opção ao lado do bot a ser excluído.

1. Selecione **Ação** e escolha **Excluir**.

1. Siga as etapas em [Excluir uma função vinculada ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) para excluir o perfil do IAM.

### AWSServiceRoleForLexCanais V2\$1
<a name="slr-channels"></a>

A função AWSService RoleForLex V2Channels\$1 dá permissão para listar bots em uma conta e chamar uma conversa para um bot. APIs Esse perfil inclui uma política de confiança para permitir que o serviço channels.lexv2.amazonaws.com assuma o perfil. Se um bot estiver configurado para usar um canal para se comunicar com um serviço de mensagens, a política de permissões da função AWSService RoleForLex V2Channels\$1 permite que o Amazon Lex V2 conclua as seguintes ações.
+ Listar as permissões de todos os bots em uma conta.
+ Reconhecer texto, obter sessão e colocar permissões de sessão em um alias de bot especificado.

**Para criar o perfil**

Quando você cria uma integração de canais para implantar um bot em uma plataforma de mensagens, o Amazon Lex V2 cria um novo perfil vinculado ao serviço em sua conta para cada canal com um sufixo aleatório.

**Para excluir o perfil**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. No painel de navegação esquerdo, selecione **Bots**.

1. Escolha um bot.

1. No painel de navegação esquerdo, escolha **Integrações de canais** em **Implantações**.

1. Selecione um canal cujo perfil vinculado ao serviço você deseja excluir.

1. O **perfil de runtime de permissões do IAM** está na **Configuração geral**.

1. Escolha **Excluir** e selecione **Excluir** novamente para excluir o canal.

1. Siga as etapas em [Excluir uma função vinculada ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) para excluir o perfil do IAM.

### AWSServiceRoleForLexReplicação V2
<a name="slr-replication"></a>

A função AWSService RoleForLex V2Replication dá permissão para replicar bots em uma segunda região. Essa função inclui uma política de confiança para permitir que o serviço replication.lexv2.amazonaws.com assuma a função e também inclui a política gerenciada da [AmazonLexReplicationPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonLexReplicationPolicy)AWS, que permite permissões para as seguintes ações.
+ Passe os perfis do IAM do bot para o bot de réplica para duplicar as permissões apropriadas para o bot de réplica.
+ Crie e gerencie bots e recursos de bot (versões, aliases, intenções, slots, vocabulários personalizados etc.) em outras regiões.

**Para criar o perfil**

Quando você ativa a resiliência global para um bot, o Amazon Lex V2 cria a função vinculada ao serviço AWSService RoleForLex V2Replication em sua conta. Verifique se você tem as [permissões](gr-permissions.md) corretas para conceder ao serviço Amazon Lex V2 permissões para criar o perfil vinculado ao serviço.

**Para excluir os recursos do Amazon Lex V2 usados pelo AWSService RoleForLex V2Replication para que você possa excluir a função**

1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Escolha um bot para o qual a resiliência global esteja habilitada.

1. Selecione **Resiliência global** em **Implantação**.

1. Selecione **Desabilitar a resiliência global**.

1. Repita o processo para todos os bots que tiverem a resiliência global habilitada.

1. Siga as etapas em [Excluir uma função vinculada ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) para excluir o perfil do IAM.

## Regiões com suporte a perfis vinculados ao serviço do Amazon Lex V2.
<a name="slr-regions"></a>

O Amazon Lex V2 é compatível com perfis vinculados ao serviço em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html).

# Solução de problemas de identidade e acesso da Amazon Lex V2
<a name="security_iam_troubleshoot"></a>

Use as informações a seguir para ajudar a diagnosticar e corrigir problemas comuns que você pode encontrar ao trabalhar com o Amazon Lex V2 e o IAM.

**Topics**
+ [Não tenho autorização para executar uma ação no Amazon Lex V2](#security_iam_troubleshoot-no-permissions)
+ [Não estou autorizado a realizar iam: PassRole](#security_iam_troubleshoot-passrole)
+ [Sou administrador e quero permitir que outras pessoas tenham acesso ao Amazon Lex V2](#security_iam_troubleshoot-admin-delegate)
+ [Conceder acesso programático a um usuário](#security_iam_programmatic_access)
+ [Quero permitir que pessoas fora da minha conta da AWS acessem meus recursos do Amazon Lex V2](#security_iam_troubleshoot-cross-account-access)

## Não tenho autorização para executar uma ação no Amazon Lex V2
<a name="security_iam_troubleshoot-no-permissions"></a>

Se o AWS Management Console informar que você não está autorizado a executar uma ação, você deverá entrar em contato com o administrador para obter assistência. Caso seu administrador seja a pessoa que forneceu suas credenciais de início de sessão.

O erro do exemplo a seguir ocorre quando o usuário do IAM `mateojackson` tenta usar o console para visualizar detalhes sobre um recurso do `my-example-widget` fictício, mas não tem as permissões fictícias do `lex:GetWidget`.

```
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: lex:GetWidget on resource: my-example-widget
```

Neste caso, Mateo pede ao administrador para atualizar suas políticas para permitir a ele o acesso ao recurso `my-example-widget` usando a ação `lex:GetWidget`.

## Não estou autorizado a realizar iam: PassRole
<a name="security_iam_troubleshoot-passrole"></a>

Caso receba uma mensagem de erro informando que você não tem autorização para executar a ação `iam:PassRole`, as políticas deverão ser atualizadas para permitir a transmissão de um perfil ao Amazon Lex V2.

Alguns Serviços da AWS permitem que você passe uma função existente para esse serviço em vez de criar uma nova função de serviço ou uma função vinculada ao serviço. Para fazer isso, é preciso ter permissões para passar o perfil para o serviço.

O erro exemplificado a seguir ocorre quando uma usuária do IAM chamada `marymajor` tenta usar o console para executar uma ação no Amazon Lex V2. No entanto, a ação exige que o serviço tenha permissões concedidas por um perfil de serviço. Mary não tem permissões para passar o perfil para o serviço.

```
User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole
```

Nesse caso, as políticas de Mary devem ser atualizadas para permitir que ela realize a ação `iam:PassRole`.

Se precisar de ajuda, entre em contato com seu administrador da AWS. Seu administrador é a pessoa que forneceu suas credenciais de login.

## Sou administrador e quero permitir que outras pessoas tenham acesso ao Amazon Lex V2
<a name="security_iam_troubleshoot-admin-delegate"></a>

Para permitir que outras pessoas acessem o Amazon Lex V2, você deve conceder permissão às pessoas ou aplicações que precisam de acesso. Se você estiver usando o Centro de Identidade do AWS IAM para gerenciar pessoas e aplicações, atribua conjuntos de permissões a usuários ou grupos para definir o nível de acesso. Os conjuntos de permissões criam e atribuem automaticamente políticas do IAM aos perfis do IAM associados à pessoa ou aplicação. Para ter mais informações, consulte [Conjuntos de permissões](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) no *Guia do usuário do Centro de Identidade do AWS IAM *.

Se você não estiver usando o Centro de Identidade do IAM, deverá criar entidades do IAM (usuários ou perfis) para as pessoas ou aplicações que precisam de acesso. Você deve anexar uma política à entidade que concede a eles as permissões corretas na Amazon Lex V2. Depois que as permissões forem concedidas, forneça as credenciais ao usuário ou desenvolvedor da aplicação. Eles usarão essas credenciais para acessar a AWS. Para saber mais sobre como criar grupos, políticas, permissões e usuários do IAM, consulte [Identidades do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) e [Políticas e permissões no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) no *Guia do usuário do IAM*.

## Conceder acesso programático a um usuário
<a name="security_iam_programmatic_access"></a>

 Para obter informações sobre como obter sua ID de chave de acesso e chave de acesso secreta, consulte [Entendendo e obtendo suas credenciais da AWS](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) na Referência geral da AWS. 

## Quero permitir que pessoas fora da minha conta da AWS acessem meus recursos do Amazon Lex V2
<a name="security_iam_troubleshoot-cross-account-access"></a>

É possível criar um perfil que os usuários de outras contas ou pessoas fora da organização podem usar para acessar seus recursos. É possível especificar quem é confiável para assumir o perfil. Para serviços que oferecem suporte a políticas baseadas em recursos ou listas de controle de acesso (ACLs), você pode usar essas políticas para conceder às pessoas acesso aos seus recursos.

Para saber mais, consulte:
+ Para saber se o Amazon Lex V2 é compatível com esses atributos, consulte [Como o Amazon Lex V2 funciona com o IAM](security_iam_service-with-iam.md).
+ Para saber como fornecer acesso aos seus recursos em todos os Contas da AWS que você possui, consulte Como [fornecer acesso a um usuário do IAM em outro Conta da AWS que você possui](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html) no *Guia do usuário do IAM*.
+ Para saber como fornecer acesso aos seus recursos a terceiros Contas da AWS, consulte Como [fornecer acesso Contas da AWS a terceiros](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html) no *Guia do usuário do IAM*.
+ Para saber como conceder acesso por meio da federação de identidades, consulte [Conceder acesso a usuários autenticados externamente (federação de identidades)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html) no *Guia do usuário do IAM*.
+ Para saber a diferença entre perfis e políticas baseadas em recurso para acesso entre contas, consulte [Acesso a recursos entre contas no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) no *Guia do usuário do IAM*.