Cómo funciona Amazon Rekognition con IAM - Amazon Rekognition

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 Rekognition con IAM

Antes de utilizar IAM para administrar el acceso a Amazon Rekognition, debe saber qué características de IAM están disponibles para su uso con Amazon Rekognition. Para obtener una perspectiva general de cómo Amazon Rekognition y otrosAWSServicios de IAM, consulteAWSServicios de IAMen laIAM User Guide.

Políticas de Amazon Rekognition basadas en identidades

Con las políticas basadas en identidades 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 Rekognition 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.

Actions

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 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 para realizar la operación asociada.

Las acciones de políticas de Amazon Rekognition utilizan el siguiente prefijo antes de la acción: rekognition:. Por ejemplo, para conceder permiso a alguien para detectar objetos, escenas o conceptos en una imagen con Amazon RekognitionDeleteLabels, se incluye la operación APIrekognition:DetectLabelsacción en su política. Las instrucciones de la política deben incluir un elemento Action o un elemento NotAction. Amazon Rekognition 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": [ "rekognition:action1", "rekognition: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": "rekognition:Describe*"

Para ver una lista de las acciones de Amazon Rekognition, consulteAcciones definidas por Amazon Rekognitionen laIAM User Guide.

Resources

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": "*"

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 la colección MyCollection en la instrucción, utilice el siguiente ARN:

"Resource": "arn:aws:rekognition:us-east-1:123456789012:collection/MyCollection"

Para especificar todas las instancias que pertenecen a una cuenta específica, utilice el carácter comodín (*):

"Resource": "arn:aws:rekognition:us-east-1:123456789012:collection/*"

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

Claves de condición

Amazon Rekognition 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.

Examples

Para ver ejemplos de políticas basadas en identidad de Amazon Rekognition, consulteEjemplos de políticas basadas en identidad de Amazon Rekognition.

Políticas de Amazon Rekognition basadas en recursos

Amazon Rekognition no admite políticas basadas en recursos.

Otros servicios, como Amazon S3, también admiten políticas de permisos basadas en recursos. Por ejemplo, puede asociar una política a un bucket de S3 para administrar los permisos de acceso a dicho bucket.

Para tener acceso a las imágenes almacenadas en un bucket de Amazon S3, debe tener permiso de acceso al objeto en el bucket de S3. Con este permiso, Amazon Rekognition puede descargar imágenes del bucket de S3. La siguiente política de ejemplo permite al usuario realizar la acción s3:GetObject en el bucket de S3 denominado Tests3bucket.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "s3:GetObject", "Resource": [ "arn:aws:s3:::Tests3bucket/*" ] } ] }

Para usar un bucket de S3 con el control de versiones habilitado, añada la acción s3:GetObjectVersion, como se muestra en el siguiente ejemplo.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectVersion" ], "Resource": [ "arn:aws:s3:::Tests3bucket/*" ] } ]

Roles de Amazon Rekognition

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

Uso de credenciales temporales con Amazon Rekognition

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 Rekognition admite el uso de credenciales temporales.

Roles vinculados a servicios

Los roles vinculados a servicios permiten a los servicios de AWS obtener acceso a los recursos de otros servicios para completar una acción en su nombre. Los roles vinculados a servicios aparecen en la cuenta de IAM y son propiedad del servicio. Un administrador de IAM puede ver, pero no editar, los permisos de los roles vinculados a servicios.

Amazon Rekognition no admite roles vinculados a servicios.

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 Rekognition admite roles de servicio.

Elegir un rol de IAM en Amazon Rekognition

Al configurar Amazon Rekognition para analizar vídeos almacenados, debe elegir un rol para permitir que Amazon Rekognition acceda a Amazon SNS en su nombre. Si ha creado previamente un rol de servicio o un rol vinculado a servicios, Amazon Rekognition le proporciona una lista de roles para elegir. Para obtener más información, consulte Configuración de Amazon Rekognition Video.