Cómo funciona Amazon Kendra con IAM - Amazon Kendra

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

Antes de utilizar IAM para administrar el acceso a Amazon Kendra, debe conocer qué características de IAM se encuentran disponibles con Amazon Kendra. Para obtener una perspectiva general de cómo Amazon Kendra y otrosAWSLos servicios funcionan con IAM, consulteAWSServicios que funcionan con IAMen laIAM User Guide.

Políticas de Amazon Kendra basadas en identidades

Con las políticas basadas en identidad de IAM, puede especificar las acciones y 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 en la Guía del usuario de IAM.

Acciones

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

El elemento Action de una política JSON describe las acciones que puede utilizar para permitir o denegar el acceso en una política. Las acciones de la política generalmente tienen el mismo nombre que la operación de API de AWS asociada. Hay algunas excepciones, como acciones de solo permiso que no tienen una operación de API coincidente. También hay algunas operaciones que requieren varias acciones en una política. Estas acciones adicionales se denominan acciones dependientes.

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, conceder a alguien permiso para publicar los índices de Amazon Kendra con laListIndicesOperación de la API, incluye elkendra:ListIndicesacció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, consulteAcciones definidas por Amazon Kendraen laIAM User Guide.

Recursos

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

El elemento Resource de la política JSON especifica el objeto u objetos a los que se aplica la acción. Las instrucciones deben contener un elemento Resource o NotResource. Como práctica recomendada, especifique un recurso utilizando el Nombre de recurso de Amazon (ARN). Puede hacerlo para acciones que admitan un tipo de recurso específico, conocido como permisos de nivel de recurso.

Para las acciones que no admiten permisos de nivel de recurso, como las operaciones de descripción, 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 acerca del formato de los ARN, consulte Nombres de recursos de Amazon (ARN) y espacios de nombres de servicios de AWS.

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

"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 sus ARN, consulteRecursos definidos por Amazon Kendraen laIAM User Guide. Para obtener información acerca de con qué acciones puede especificar los ARN de cada recurso, consulteAcciones definidas por Amazon Kendra.

Claves de condición

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

El elemento Condition (o bloque de Condition) permite especificar condiciones en las que entra en vigor una instrucción. El elemento Condition es opcional. Puede crear expresiones condicionales que utilicen operadores de condición, tales como igual o menor que, para que la condición de la política coincida con los valores de la solicitud.

Si especifica varios elementos de Condition en una instrucción o varias claves en un único elemento de Condition, AWS las evalúa mediante una operación AND lógica. Si especifica varios valores para una única clave de condición, AWS evalúa la condición con una operación lógica OR. Se deben cumplir todas las condiciones antes de que se concedan los permisos de la instrucción.

También puede utilizar variables de marcador de posición al especificar condiciones. Por ejemplo, puede conceder un permiso de usuario de IAM para acceder a un recurso solo si está etiquetado con su nombre de usuario de IAM. Para obtener más información, consulte Elementos de la política de IAM: variables y etiquetas en la Guía del usuario de IAM.

AWS admite claves de condición globales y claves de condición específicas del servicio. Para ver todas las claves de condición globales de AWS, consulte Claves de contexto de condición globales de AWS 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 globales de AWS, consulte Claves de contexto de condición globales de AWS en la Guía del usuario de IAM.

Ejemplos

Para ver ejemplos de políticas de Amazon Kendra basadas en identidades, consulteEjemplos de políticas basadas en identidades de Amazon Kendra.

Políticas de basadas en recursos de Amazon Kendra

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

Listas de control de acceso (ACL)

Amazon Kendra no admite las listas de control de acceso (ACL) para acceder aAWSservicios y recursos de.

Autorización basada en etiquetas de Amazon Kendra

Puede asociar etiquetas con determinados tipos de recursos de Amazon Kendra para autorizar el acceso a esos recursos. Para controlar el acceso según las etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política utilizando laaws:RequestTag/key-name, o bienaws:TagKeysClaves de condición.

En la tabla siguiente se enumeran las acciones, los tipos de recursos correspondientes y las claves de condiciones 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.

Acción Tipo de recurso Claves de condición
CreateDataSource   aws:RequestTag, aws:TagKeys
CreateFaq   aws:RequestTag, aws:TagKeys
CreateIndex   aws:RequestTag, aws:TagKeys
ListTagsForResource fuente de datos, preguntas frecuentes, índice  
TagResource fuente de datos, preguntas frecuentes, índice aws:RequestTag, aws:TagKeys
UntagResource fuente de datos, preguntas frecuentes, índice aws:TagKeys

Para obtener más información acerca del etiquetado de recursos de Amazon Kendra, consulteEtiquetas. Para obtener un ejemplo de política basada en identidad que limita el acceso a un recurso basado en etiquetas de recurso, consulteEjemplos de políticas basadas en etiquetas. Para obtener más información sobre el uso de etiquetas para limitar el acceso a los recursos, consulteControl del acceso mediante etiquetas deen laIAM User Guide.

Roles de IAM de Amazon Kendra

Un rol de IAM es una entidad de la cuenta de AWS que dispone de permisos específicos.

Uso de credenciales temporales con Amazon Kendra

Puede utilizar credenciales temporales para iniciar sesión con federación, asumir un rol de IAM o asumir un rol de acceso entre cuentas. Las credenciales de seguridad temporales se obtienen mediante una llamada a operaciones de la API de AWS STS, como AssumeRole o GetFederationToken.

Amazon Kendra admite el uso de credenciales temporales.

Roles de servicio

Esta característica permite que un servicio asuma un rol de servicio 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

Cuando cree un índice, llame alBatchPutDocument, crear un origen de datos o crear preguntas frecuentes, debe proporcionar un rol de acceso Nombre de recurso de Amazon (ARN) que Amazon Kendra utiliza para acceder a los recursos necesarios en su nombre. Si ya ha creado un rol, la consola de Amazon Kendra le proporciona una lista de roles para elegir. Es importante elegir un rol que permita acceder a los recursos de que necesita. Para obtener más información, consulte IAMroles de acceso paraAmazon Kendra.