Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Cómo funciona Amazon Kendra con IAM
<a name="security_iam_service-with-iam"></a>

Antes de utilizar IAM para administrar el acceso a Amazon Kendra, debe conocer qué características de IAM están disponibles con Amazon Kendra. *Para obtener una visión general de cómo Amazon Kendra y otros AWS servicios funcionan con IAM, consulte [AWS Servicios que funcionan con IAM en la Guía del usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).*

**Topics**
+ [Políticas de Amazon Kendra basadas en identidades](#security_iam_service-with-iam-id-based-policies)
+ [Políticas de Amazon Kendra Resource-based](#security_iam_service-with-iam-resource-based-policies)
+ [Listas de control de acceso (ACL)](#security_iam_service-with-iam-acls)
+ [Autorización basada en etiquetas de Amazon Kendra](#security_iam_service-with-iam-tags)
+ [Roles de IAM en Amazon Kendra](#security_iam_service-with-iam-roles)

## Políticas de Amazon Kendra basadas en identidades
<a name="security_iam_service-with-iam-id-based-policies"></a>

Con las políticas basadas en identidades de IAM, puede especificar las acciones y los recursos permitidos o denegados, así como las condiciones en las que se permiten o deniegan las acciones. Amazon Kendra admite acciones, claves de condiciones y recursos específicos. Para obtener información sobre todos los elementos que utiliza en una política JSON, consulte [Referencia de los elementos de las políticas JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) en la *Guía del usuario de IAM*.

### Acciones
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.

El elemento `Action` de una política JSON describe las acciones que puede utilizar para conceder o denegar el acceso en una política. Incluya acciones en una política para conceder permisos y así llevar a cabo la operación asociada.

Las acciones de políticas de Amazon Kendra utilizan el siguiente prefijo antes de la acción: `kendra:`. Por ejemplo, para conceder permiso a alguien para que publique índices de Amazon Kendra con la operación de [ListIndices](https://docs.aws.amazon.com/kendra/latest/dg/API_ListIndices.html)API, debe incluir la `kendra:ListIndices` acción en su política. Las instrucciones de la política deben incluir un elemento `Action` o un elemento `NotAction`. Amazon Kendra define su propio conjunto de acciones que describen las tareas que se pueden realizar con este servicio.

Para especificar varias acciones en una única instrucción, sepárelas con comas del siguiente modo:

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

Puede utilizar caracteres comodín para especificar varias acciones (\*). Por ejemplo, para especificar todas las acciones que comiencen con la palabra `Describe`, incluya la siguiente acción:

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

Para ver una lista de las acciones de Amazon Kendra, consulte [Acciones definidas por Amazon Kendra](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions) en la *Guía del usuario de IAM*.

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

Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.

El elemento `Resource` de la política JSON especifica el objeto u objetos a los que se aplica la acción. Como práctica recomendada, especifique un recurso utilizando el [Nombre de recurso de Amazon (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). En el caso de las acciones que no admiten permisos por recurso, utilice un carácter comodín (\*) para indicar que la instrucción se aplica a todos los recursos.

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





El recurso de índice de Amazon Kendra tiene el siguiente ARN:

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

Para obtener más información sobre el formato de los ARN, consulte Nombres de [recursos de Amazon (ARN) y espacios de nombres de AWS servicio](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).

Por ejemplo, para especificar un índice en su instrucción, utilice el GUID del índice en el ARN siguiente:

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

Para especificar todos los índices que pertenecen a una cuenta específica, utilice el carácter comodín (\*):

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

Algunas acciones de Amazon Kendra, como las que se utilizan para crear recursos, no se pueden llevar a cabo en un recurso específico. En dichos casos, debe utilizar el carácter comodín (\*).

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

Para ver una lista de los tipos de recursos de Amazon Kendra y los ARN, consulte [Recursos definidos por Amazon Kendra](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-resources-for-iam-policies) en la *Guía del usuario de IAM*. Para obtener información acerca de las acciones con las que puede especificar el ARN de cada recurso, consulte [Acciones definidas por Amazon Kendra](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_kendra.html#kendra-actions-as-permissions).

### Claves de condición
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

Los administradores pueden usar las políticas de AWS JSON para especificar quién tiene acceso a qué. Es decir, qué **entidad principal** puede realizar **acciones** en qué **recursos** y en qué **condiciones**.

El elemento `Condition` especifica cuándo se ejecutan las instrucciones en función de criterios definidos. Puede crear expresiones condicionales que utilizan [operadores de condición](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), tales como igual o menor que, para que la condición de la política coincida con los valores de la solicitud. Para ver todas las claves de condición AWS globales, consulte las claves de [contexto de condición AWS globales](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) en la *Guía del usuario de IAM*.

Amazon Kendra no proporciona ninguna clave de condición específica del servicio, pero sí admite el uso de algunas claves de condición globales. Para ver todas las claves de condición AWS globales, consulte las claves de [contexto de condición AWS globales](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) en la Guía del *usuario de IAM*.

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



Para ver ejemplos de políticas basadas en identidad de Amazon Kendra, consulte [Ejemplos de políticas de Amazon Kendra Identity-based](security_iam_id-based-policy-examples.md).

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

Amazon Kendra no admite las políticas basadas en recursos.

## Listas de control de acceso (ACL)
<a name="security_iam_service-with-iam-acls"></a>

Amazon Kendra no admite listas de control de acceso (ACL) para acceder a servicios y recursos de AWS .

## Autorización basada en etiquetas de Amazon Kendra
<a name="security_iam_service-with-iam-tags"></a>

Puede asociar etiquetas a determinados tipos de recursos de Amazon Kendra para autorizar el acceso a dichos recursos. Para controlar el acceso utilizando etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política utilizando las claves de condición `aws:RequestTag/{{key-name}}` o `aws:TagKeys`.

En la tabla siguiente se enumeran las acciones, los tipos de recursos correspondientes y las claves de condición para el control de acceso basado en etiquetas. Cada acción se autoriza en función de las etiquetas asociadas al tipo de recurso correspondiente.


| Action | Tipo de recurso | Claves de condición | 
| --- | --- | --- | 
|  [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)  | origen de datos, preguntas frecuentes, índice |   | 
| [TagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_TagResource.html)  | origen de datos, preguntas frecuentes, índice | aws:RequestTag, aws:TagKeys | 
| [UntagResource](https://docs.aws.amazon.com/kendra/latest/dg/API_UntagResource.html)  | origen de datos, preguntas frecuentes, índice | aws:TagKeys | 

Para obtener información acerca del etiquetado de recursos de Amazon Kendra, consulte [Tags](tagging.md). Para obtener un ejemplo de política basada en identidad que limita el acceso a un recurso basado en etiquetas de recurso, consulte [Tag-based ejemplos de políticas](security_iam_id-based-policy-examples.md#examples-tagging). Para obtener más información sobre el uso de etiquetas para limitar el acceso a los recursos, consulte [Control del acceso mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la *Guía del usuario de IAM*. 

## Roles de IAM en Amazon Kendra
<a name="security_iam_service-with-iam-roles"></a>

Un [rol de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) es una entidad de tu AWS cuenta que tiene permisos específicos.

### Uso de credenciales temporales con Amazon Kendra
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

Puede utilizar credenciales temporales para iniciar sesión con federación, asumir un rol de IAM o asumir un rol de acceso entre cuentas. Para obtener credenciales de seguridad temporales, puede llamar a operaciones de AWS STS API como [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)o [GetFederationToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html). 

Amazon Kendra admite el uso de credenciales temporales. 

### Roles de servicio
<a name="security_iam_service-with-iam-roles-service"></a>

Esta característica permite que un servicio asuma un [rol de servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) en su nombre. Este rol permite que el servicio obtenga acceso a los recursos de otros servicios para completar una acción en su nombre. Los roles de servicio aparecen en su cuenta de IAM y son propiedad de la cuenta. Esto significa que un administrador de IAM puede cambiar los permisos de este rol. Sin embargo, hacerlo podría deteriorar la funcionalidad del servicio.

Amazon Kendra admite roles de servicio. 

### Elegir un rol de IAM en Amazon Kendra
<a name="security_iam_service-with-iam-roles-choose"></a>

Al crear un índice, llamar a la operación `BatchPutDocument`, crear un origen de datos o crear una sección de preguntas frecuentes, debe proporcionar un rol de acceso Nombre de recurso de Amazon (ARN) que Amazon Kendra utilice para acceder a los recursos necesarios en su nombre. Si ya ha creado un rol, la consola de Amazon Kendra proporciona una lista de roles para elegir. Es importante elegir un rol que permita el acceso a los recursos que necesita. Para obtener más información, consulte [IAM Roles de acceso de para Amazon Kendra](iam-roles.md).