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 administrar el acceso IAM a Amazon Rekognition, debe IAM saber qué funciones están disponibles para su uso con Amazon Rekognition. Para obtener una visión general de cómo funcionan Amazon Rekognition AWS y otros servicios AWS , consulte Servicios con los que IAM IAM funcionan en la Guía del usuario. IAM

Políticas de Amazon Rekognition 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 Rekognition 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 puede 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 Rekognition utilizan el siguiente prefijo antes de la acción: rekognition:. Por ejemplo, para conceder a alguien permiso para detectar objetos, escenas o conceptos en una imagen con la operación Amazon Rekognition DetectLabelsAPI, debes rekognition:DetectLabels incluir la acció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, consulte Acciones definidas por Amazon Rekognition en la Guía del usuario. IAM

Recursos

Los administradores pueden usar AWS JSON políticas 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 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). 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 sobre el formato deARNs, consulte Amazon Resource Names (ARNs) y AWS Service Namespaces.

Por ejemplo, para especificar la MyCollection colección en su declaración, utilice lo 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 ARNs y sus tipos de recursos, consulte Recursos definidos por Amazon Rekognition en la Guía del usuario. IAM Para saber con qué acciones puede especificar cada recurso, consulte Acciones definidas por Amazon Rekognition. ARN

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 AWS globales, consulte las claves de contexto de condición AWS globales en la Guía del IAM usuario.

Políticas basadas en recursos de Amazon Rekognition

Políticas basadas en recursos de Amazon Rekognition para operaciones de copia de modelos de Etiquetas personalizadas. Para obtener más información, vea Amazon Rekognition resource-based policy examples.

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/*"
            ]
        }
    ]

Funciones de Amazon Rekognition IAM

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

Uso de credenciales temporales con Amazon Rekognition

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

Roles vinculados al servicio

Las funciones vinculadas al servicio permiten a AWS los servicios acceder a los recursos de otros servicios para completar una acción en su nombre. Los roles vinculados al servicio aparecen en tu IAM cuenta y son propiedad del servicio. Un IAM administrador puede ver los permisos de los roles vinculados al servicio, pero no editarlos.

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

El uso de un rol de servicio puede crear un problema de seguridad en el que Amazon Rekognition se utilice para llamar a otro servicio y actuar sobre recursos a los que no debería tener acceso. Para mantener la seguridad de su cuenta, debe limitar el alcance del acceso de Amazon Rekognition únicamente a los recursos que esté utilizando. Esto se puede hacer adjuntando una política de confianza a su función IAM de servicio. Para obtener información sobre cómo hacerlo, consulte Prevención del suplente confuso entre servicios.

Elegir un IAM puesto en Amazon Rekognition

Al configurar Amazon Rekognition para analizar los vídeos almacenados, debe elegir un rol para permitir que Amazon Rekognition acceda a Amazon en su nombre. SNS 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.