Cómo funciona Amazon Kendra con IAM

Antes de administrar el IAM acceso a Amazon Kendra, debe saber qué IAM funciones están disponibles para su uso con Amazon Kendra. Para obtener una visión general de cómo funcionan Amazon Kendra y otros AWS serviciosIAM, consulte AWS Servicios con los que funcionan IAM en la Guía del IAMusuario.

Políticas de Amazon Kendra basadas en identidades

Con las políticas IAM basadas en la identidad, 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 más información sobre todos los elementos que se utilizan en una JSON política, consulte la Referencia sobre los elementos IAM JSON de la política en la Guía del IAMusuario.

Acciones

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

El Action elemento de una JSON política describe las acciones que puede utilizar para permitir o denegar el acceso en una política. Las acciones de política suelen tener el mismo nombre que la AWS API operación asociada. Hay algunas excepciones, como las acciones que solo permiten permisos y que no tienen una operación coincidente. API 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, para conceder permiso a alguien para que publique los índices de Amazon Kendra con la ListIndicesAPIoperación, 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 en IAM la Guía del usuario.

Recursos

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

El elemento Resource JSON de política especifica el objeto o los 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 mediante su nombre de recurso de Amazon (ARN). Puedes 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, utiliza 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 lo siguiente: ARN

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

Para obtener más información sobre el formato deARNs, consulte Amazon Resource Names (ARNs) y AWS Service Namespaces.

Por ejemplo, para especificar un índice en su declaración, utilice el índice GUID del siguiente modo: 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 respectivos tiposARNs, consulte Recursos definidos por Amazon Kendra en IAM la Guía del usuario. Para saber con qué acciones puede especificar cada recurso, consulte Acciones definidas por Amazon Kendra. ARN

Claves de condición

Los administradores pueden usar AWS JSON políticas para especificar quién tiene acceso a qué. Es decir, qué entidad principal puedes realizar acciones en qué recursos y en 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. Puedes crear expresiones condicionales que utilizan 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 mediante una OR operación lógica. Se deben cumplir todas las condiciones antes de que se concedan los permisos de la instrucción.

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

AWS admite claves de condición globales y claves de condición específicas del servicio. Para ver todas las claves de condición AWS globales, consulte las claves de contexto de condición AWS globales en la Guía del IAMusuario.

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 en la Guía del IAM usuario.

Ejemplos

Para ver ejemplos de políticas basadas en identidad de Amazon Kendra, consulte Ejemplos de políticas basadas en identidades de Amazon Kendra.

Políticas de Amazon Kendra basadas en recursos

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

Listas de control de acceso (ACLs)

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

Autorización basada en etiquetas de Amazon Kendra

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.

Acción	Tipo de recurso	Claves de condición
CreateDataSource		aws:RequestTag, aws:TagKeys
CreateFaq		aws:RequestTag, aws:TagKeys
CreateIndex		aws:RequestTag, aws:TagKeys
API_ListTagsForRecurso	fuente de datosFAQ, índice
TagResource	fuente de datosFAQ, índice	aws:RequestTag, aws:TagKeys
UntagResource	fuente de datosFAQ, índice	aws:TagKeys

Para obtener información acerca del etiquetado de recursos de Amazon Kendra, consulte Etiquetas. Para obtener un ejemplo de política basada en identidad que limita el acceso a un recurso basado en etiquetas de recurso, consulte Ejemplo de política basada en etiquetas. Para obtener más información sobre el uso de etiquetas para limitar el acceso a los recursos, consulte Controlar el acceso mediante etiquetas en la Guía del IAM usuario.

Funciones de Amazon Kendra IAM

Un IAMrol es una entidad de su AWS cuenta que tiene permisos específicos.

Uso de credenciales temporales con Amazon Kendra

Puedes usar credenciales temporales para iniciar sesión con la federación, asumir un IAM rol o asumir un rol multicuenta. Para obtener credenciales de seguridad temporales, puede llamar a AWS STS API operaciones como AssumeRoleo 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 IAM cuenta y son propiedad de la cuenta. Esto significa que un IAM administrador 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 IAM puesto en Amazon Kendra

Al crear un índice, llamar a la BatchPutDocument operación, crear una fuente de datos o crear unaFAQ, debe proporcionar una función de acceso Amazon Resource Name (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 para Amazon Kendra.