Cómo funciona Amazon Textract con IAM - Amazon Textract

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

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

Políticas basadas en identidades de Amazon Textract

Con las políticas basadas en identidades de IAM, puede especificar las acciones permitidas o denegadas, así como los recursos y las condiciones en las que se permiten o deniegan las acciones. Amazon Textract 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 asíncronas de Amazon Textract requieren dos permisos de acción que se otorguen, uno para acciones de inicio y otro para acciones Get. Además, si utilizas un depósito de Amazon S3 para pasar documentos, tendrás que conceder acceso de lectura a tu cuenta.

En Amazon Textract, todas las acciones de política empiezan por: textract:. Por ejemplo, para conceder a alguien permiso para ejecutar una operación de Amazon Textract Texact con Amazon TextractAnalyzeDocument, incluye eltextract:AnalyzeDocumentacción en su política. Las instrucciones de la política deben incluir un elemento Action o un elemento NotAction. Amazon Textract Texact 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": [ "textract:action1", "textract: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": "textract:Describe*"

Para obtener una lista de acciones de Amazon Textract, consulteAcciones definidas por Amazon Textracten 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": "*"

Amazon Textract no admite especificar los ARN de los recursos en una política.

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 Textract Texact 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 una lista de todas lasAWSClaves de condición globales, consulteAWSClaves de contexto de condición globales deen laIAM User Guide.

Ejemplos

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

Políticas basadas en recursos de Amazon Textract

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

Autorización basada en etiquetas de Amazon Textract

Amazon Textract no admite el etiquetado de recursos ni el control de acceso basado en etiquetas.

Roles de IAM de Amazon Textract

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

Uso de credenciales temporales con Amazon Textract

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 Textract 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 Textract no admite roles vinculados a servicios.

nota

Como Amazon Textract Texact no admite roles vinculados a servicios, no admite los principios de servicio de AWS. Para obtener más información acerca de los directores de servicio, consulteEntidades de servicios de AWSen laIAM User Guide

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