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

Políticas de Amazon Textract Identity-Based

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, recursos y claves de condición 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 usar las políticas de AWS JSON 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 Action de una política JSON describe las acciones que puede utilizar para conceder o denegar el acceso en una política. Incluya acciones en una política para conceder permisos y así llevar a cabo la operación asociada.

Las acciones asincrónicas en Amazon Textract requieren la concesión de dos permisos de acción, uno para iniciar acciones y otro para obtener acciones. Además, si utiliza un bucket de Amazon S3 para transferir documentos, tendrá que conceder a su cuenta el acceso de lectura.

En Amazon Textract, todas las acciones políticas comienzan con:textract:. Por ejemplo, para conceder permiso a alguien para ejecutar una operación de Amazon Textract con la operación de Amazon TextractAnalyzeDocument, debe incluir la textract:AnalyzeDocument acción en su política. Las instrucciones de la política deben incluir un elemento Action o un elemento NotAction. Amazon Textract define su propio conjunto de acciones que describen las tareas que puede realizar con este servicio.

Para especificar varias acciones de  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 las acciones de Amazon Textract, consulte Acciones definidas por Amazon Textract en la guía del usuario de IAM.

Recursos

Los administradores pueden usar las políticas de AWS JSON 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 de la política JSON especifica el objeto u objetos a los que se aplica la acción. Como práctica recomendada, especifique un recurso utilizando el Nombre de recurso de Amazon (ARN). En el caso de las acciones que no admiten permisos por recurso, utilice un carácter comodín (*) para indicar que la instrucción se aplica a todos los recursos.

"Resource": "*"

En el caso de las acciones que admiten permisos a nivel de recursos, como las GetAdapter operaciones AnalyzeDocument y, usa el ARN para indicar los recursos:

"Resource": [
  # Adapter ARN
  "arn:aws:textract:<region>:<account-id>:/adapters/<adapter-id>",
  # Adapter version ARN
  "arn:aws:textract:<region>:<account-id>:/adapters/<adapter-id>/versions/<version>",
  # Use wildcard to indicate all versions under an adapter
  "arn:aws:textract:<region>:<account-id>:/adapters/<adapter-id>/versions/*"
]    

Claves de condición

Los administradores pueden usar las políticas de AWS JSON 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 Condition especifica cuándo se ejecutan las instrucciones en función de criterios definidos. Puede 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. Para ver todas las claves de condiciones AWS globales, consulte las claves de contexto de condiciones AWS globales en la guía del usuario de IAM.

Amazon Textract no proporciona ninguna clave de condición específica de un servicio, pero sí admite el uso de algunas claves de condición globales. Para obtener una lista de todas las claves de condición AWS globales, consulte las claves de contexto de condiciones AWS globales en la guía del usuario de IAM.

Ejemplos

Para ver ejemplos de políticas basadas en la identidad de Amazon Textract, consulte. Ejemplos de Identity-Based políticas de Amazon Textract

Políticas de Amazon Textract Resource-Based

Amazon Textract no admite políticas basadas en recursos.

Autorización basada en las etiquetas de Amazon Textract

Los recursos de Amazon Textract permiten etiquetar los recursos y controlar el acceso en función de las etiquetas. Puede usar las ListTagsForResource operaciones TagResource UntagResource, y para administrar las etiquetas de recursos.

Para ver el control de acceso basado en etiquetas, puede consultar AccessTags.

Funciones de IAM de Amazon Textract

Un rol de IAM es una entidad de su AWS cuenta que tiene 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 llamando a operaciones de AWS STS API como AssumeRole o GetFederationToken.

Amazon Textract admite el uso de credenciales temporales.

Service-Linked Funciones

Service-linked los roles permiten a los AWS servicios acceder a los recursos de otros servicios para completar una acción en tu nombre. Service-linked los roles aparecen en tu 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 funciones vinculadas 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 Textract admite funciones de servicio.

Si utiliza un rol de servicio, debe asegurarse de que su cuenta es segura limitando el alcance del acceso a Amazon Textract únicamente a los recursos que esté utilizando. Para ello, adjunte una política de confianza a su función de servicio de IAM. Para obtener más información, consulte Prevención de la Cross-service confusión entre agentes.