As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Antes de usar o IAM para gerenciar o acesso ao Amazon Kendra, você deve entender quais recursos do IAM estão disponíveis para uso com o Amazon Kendra. Para ter uma visão de alto nível de como o Amazon Kendra AWS e outros serviços funcionam com o IAM [AWS , consulte Serviços que funcionam](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) com o IAM *no* Guia do usuário do IAM.

**Topics**
+ [Políticas baseadas em identidade do Amazon Kendra](#security_iam_service-with-iam-id-based-policies)
+ [Políticas do Amazon Kendra Resource-based](#security_iam_service-with-iam-resource-based-policies)
+ [Listas de controle de acesso (ACLs)](#security_iam_service-with-iam-acls)
+ [Autorização baseada em tags do Amazon Kendra](#security_iam_service-with-iam-tags)
+ [Funções do IAM no Amazon Kendra](#security_iam_service-with-iam-roles)

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

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. O Amazon Kendra oferece suporte a ações, chaves de condição e recursos específicos. Para conhecer todos os elementos usados em uma política JSON, consulte [Referência de elementos 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*.

### Ações
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual **entidade principal** pode executar **ações** em quais **recursos** e em que **condições**.

O elemento `Action` de uma política JSON descreve as ações que podem ser usadas para permitir ou negar acesso em uma política. Incluem ações em uma política para conceder permissões para executar a operação associada.

As ações de política no Amazon Kendra usam o seguinte prefixo antes da ação: `kendra:`. Por exemplo, para conceder permissão a alguém para listar índices do Amazon Kendra com a operação [ListIndices](https://docs.aws.amazon.com/kendra/latest/dg/API_ListIndices.html)da API, você inclui a ação `kendra:ListIndices` na política dessa pessoa. As instruções de política devem incluir um elemento `Action` ou `NotAction`. O Amazon Kendra define seu próprio conjunto de ações que descrevem as tarefas que você pode executar com esse serviço.

Para especificar várias ações em uma única instrução, separe-as com vírgulas, como segue:

```
"Action": [
      "kendra:action1",
      "kendra:action2"
```

Você também pode especificar várias ações usando caracteres curinga (\*). Por exemplo, para especificar todas as ações que começam com a palavra `Describe`, inclua a seguinte ação:

```
"Action": "kendra:Describe*"
```

Para ver uma lista das ações do Amazon EMR, consulte [Ações definidas pelo Amazon Kendra](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions) no *Guia do usuário do IAM*.

### Recursos
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual **entidade principal** pode executar **ações** em quais **recursos** e em que **condições**.

O elemento de política JSON `Resource` especifica o objeto ou os objetos aos quais a ação se aplica. Como prática recomendada, especifique um recurso usando seu [nome do recurso da Amazon (ARN)](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 (\*) para indicar que a instrução se aplica a todos os recursos.

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





O recurso do índice do Amazon Kendra tem o seguinte ARN:

```
arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}
```

Para obter mais informações sobre o formato dos ARNs, consulte [Amazon Resource Names (ARNs) e AWS Service](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) Namespaces.

Por exemplo, para especificar o índice em sua instrução, use o GUID do índice no seguinte ARN:

```
"Resource": "arn:aws:kendra:${Region}:${Account}:index/${GUID}"
```

Para especificar todas os índices que pertencem a uma conta específica, use o caractere curinga (\*):

```
"Resource": "arn:aws:${Region}:${Account}:index/*"
```

Algumas ações do Amazon Kendra, como as de criação de recursos, não podem ser executadas em um recurso específico. Nesses casos, é necessário utilizar o caractere curinga (\*).

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

Para ver uma lista dos tipos de recursos do Amazon Kendra e seus ARNs, consulte [Recursos definidos pelo Amazon Kendra](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-resources-for-iam-policies) no *Manual do usuário do IAM*. Para saber com quais ações você pode especificar o ARN de cada recurso, consulte [Ações definidas pelo Amazon Kendra](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions).

### Chaves de condição
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual **entidade principal** pode executar **ações** em quais **recursos** e em que **condições**.

O elemento `Condition` especifica quando as instruções são executadas com base em critérios definidos. É possível criar expressões condicionais que usem [agentes de condição](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 ver todas as chaves de condição AWS globais, consulte as [chaves de contexto de condição AWS global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) no *Guia do usuário do IAM*.

O Amazon Kendra não fornece nenhuma chave de condição específica ao serviço, mas oferece suporte ao uso de algumas chaves de condição globais. Para ver todas as chaves de condição AWS globais, consulte [Chaves de contexto de condição AWS global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) no *Guia do usuário do IAM*.

### Exemplos
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>



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

## Políticas do Amazon Kendra Resource-based
<a name="security_iam_service-with-iam-resource-based-policies"></a>

O Amazon Kendra não oferece suporte a políticas baseadas em recursos.

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

O Amazon Kendra não oferece suporte às listas de controle de acesso (ACLs) para acesso aos serviços e recursos da AWS .

## Autorização baseada em tags do Amazon Kendra
<a name="security_iam_service-with-iam-tags"></a>

Você pode associar tags a determinados tipos de recursos do Amazon Kendra para autorizar o acesso a esses recursos. Para controlar o acesso baseado em tags, forneça informações sobre as tags no elemento de condição de uma política usando as chaves de condição `aws:RequestTag/{{key-name}}` ou `aws:TagKeys`.

A tabela a seguir lista as ações e os tipos de recursos correspondentes para o controle de acesso baseado em tags. Cada ação é autorizada com base nas tags associadas ao tipo de recurso correspondente.


| Ação | Tipo de recurso | Chaves de condição | 
| --- | --- | --- | 
|  [CreateDataSource](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)  |   | aws:RequestTag, aws:TagKeys | 
| [CreateFaq](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateFaq.html) |   | aws:RequestTag, aws:TagKeys | 
|  [CreateIndex](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateIndex.html)  |   | aws:RequestTag, aws:TagKeys | 
|  [API\_ ListTagsForResource](https://docs.aws.amazon.com/kendra/latest/dg/API_ListTagsForResource.html)  | fonte de dados, perguntas frequentes, índice |   | 
| [TagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_TagResource.html)  | fonte de dados, perguntas frequentes, índice | aws:RequestTag, aws:TagKeys | 
| [UntagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_UntagResource.html)  | fonte de dados, perguntas frequentes, índice | aws:TagKeys | 

Para ter mais informações sobre recursos de marcação do Amazon Kendra, consulte [Tags](tagging.md). Para obter um exemplo de política baseada em identidade que limita o acesso a um recurso com base em tags de recurso, consulte [Tag-based exemplos de políticas](security_iam_id-based-policy-examples.md#examples-tagging). Para obter informações sobre como usar tags para limitar o acesso aos seus recursos, consulte [Controlar o acesso usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *Guia do usuário do IAM*. 

## Funções do IAM no Amazon Kendra
<a name="security_iam_service-with-iam-roles"></a>

Uma [função do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) é uma entidade dentro da sua AWS conta que tem permissões específicas.

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

É possível usar credenciais temporárias para fazer login com federação, assumir um perfil do IAM ou assumir um perfil entre contas. Você obtém credenciais de segurança temporárias chamando operações de AWS STS API, como [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)ou [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html). 

O Amazon Kendra oferece suporte ao uso de credenciais temporárias. 

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

Esse atributo permite que um serviço assuma um [perfil de serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) em seu nome. O perfil permite que o serviço acesse recursos em outros serviços para concluir uma ação em seu nome. Os perfis de serviço aparecem em sua conta do IAM e são de propriedade da conta. Isso significa que um administrador do IAM pode alterar as permissões para esse perfil. Porém, fazer isso pode alterar a funcionalidade do serviço.

O Amazon Kendra oferece suporte às funções de serviço. 

### Escolher uma perfil do IAM no Amazon Kendra
<a name="security_iam_service-with-iam-roles-choose"></a>

Ao criar um índice, chamar a operação da `BatchPutDocument`, criar uma fonte de dados ou uma pergunta frequente, forneça uma função de acesso do nome do recurso da Amazon (ARN) que o Amazon Kendra usa para acessar os recursos necessários em seu nome. Se você já tiver criado uma função, o Amazon Kendra fornecerá uma lista de funções da qual escolher. É importante escolher uma função que permita o acesso aos recursos necessários. Para obter mais informações, consulte [IAM Funções de acesso do para o Amazon Kendra](iam-roles.md).