Configuración de Amazon Textract para operaciones asíncronas

Para configurar Amazon Textract

1. Configure una AWS cuenta para acceder a Amazon Textract. Para obtener más información, consulte Paso 1: Configurar una cuenta de AWS y crear un usuario.

   Asegúrese de que el usuario tenga al menos los siguientes permisos:

   • AmazonTextractFullAccess

   • AmazonS3ReadOnlyAccess

   • AmazonSNSFullAccess

   • AmazonSQSFullAccess

   Además, asegúrese de que el usuario tenga permiso para transferir funciones de IAM a Amazon Textract. Esto se hace mediante una política de IAM. PassRole A continuación se muestra un ejemplo sencillo de una política de este tipo:

   JSON

   
   {
       "Version":"2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": "*",
               "Condition": {
                   "StringEquals": {"iam:PassedToService": "textract.amazonaws.com"}
               }
           }
       ]
   }
                   
   

2. Instale y configure el AWS SDK necesario. Para obtener más información, consulte Paso 2: configurar el AWS CLI and AWS SDK.

3. Cree un tema estándar de Amazon SNS. Añada al nombre del tema un prefijo. AmazonTextract Anote el nombre de recurso de Amazon (ARN) del tema. Asegúrese de que el tema esté en la misma región que el AWS punto de conexión que utiliza con su cuenta de AWS.

4. Cree una cola estándar de Amazon SQS mediante la consola de Amazon SQS. Anote el ARN de la cola.

5. Suscriba la cola al tema que creó en el paso 3.

6. Conceda permiso al tema de Amazon SNS y enviar mensajes a la cola de Amazon SQS.

7. Cree un rol de servicio de IAM para dar a Amazon Textract acceso a sus temas de Amazon SNS. Anote el nombre de recurso de Amazon (ARN) del rol de servicio. Para obtener más información, consulte Cómo dar acceso a Amazon Textract a su tema de Amazon SNS.

8. Añada la siguiente política en línea al usuario de IAM que creó en el paso 1.

   Asigne un nombre a la política en línea.

9. Ahora puede ejecutar los ejemplos enDetectar o analizar texto en un documento de varias páginas.

1. Inicie sesión en la consola de IAM (). https://console.aws.amazon.com/iam

2. Seleccione Roles en el panel de navegación.

3. Elija Create role (Crear rol).

4. En Select type of trusted entity (Seleccionar tipo de entidad de confianza), elija AWS service (Servicio de AWS).

5. En Elige el servicio que usará este rol, selecciona Textract.

6. Elija Siguiente: permisos.

7. Compruebe que la AmazonTextractServiceRolepolítica se haya incluido en la lista de políticas adjuntas. Para mostrar la política en la lista, introduzca parte del nombre de la política en las políticas de filtrado.

8. Elija Siguiente: etiquetas.

9. No es necesario añadir etiquetas, así que elija Next: Review (Siguiente: Revisar).

10. En la sección Review (Revisar), en Role Name (Nombre de rol), escriba un nombre para el rol (por ejemplo, TextractRole). En Descripción del rol, actualice la descripción del rol y, a continuación, elija Crear rol.

11. Elija el rol nuevo para abrir la página de detalles del rol.

12. En Summary (Resumen), copie el valor de Role ARN (ARN del rol) y guárdelo.

13. Seleccione Trust Relationships.

14. Seleccione Editar relación de confianza y edite la política de confianza. Asegúrese de que su política de confianza incluya condiciones que limiten el alcance de los permisos a solo los recursos necesarios, ya que esto ayudará a evitar el confuso problema de los diputados. Para obtener más información sobre este posible problema de seguridad, consulteCross-service confusa prevención adjunta. En el ejemplo siguiente, sustituye el red texto por el ID de tu AWS cuenta.

    JSON

    {
      "Version":"2012-10-17",
      "Statement": {
        "Sid": "ConfusedDeputyPreventionExamplePolicy",
        "Effect": "Allow",
        "Principal": {
          "Service": "textract.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
          "ArnLike": {
            "aws:SourceArn":"arn:aws:textract:*:123456789012:*"
          },
          "StringEquals": {
            "aws:SourceAccount": "123456789012"
          }
        }
      }
    }
    

15. Elija Actualizar política de confianza.

Para permitir el descifrado de las cargas de buckets de S3

• Deberá proporcionar a los usuarios correspondientes los permisos correctos de Amazon S3.

  Vaya a la sección Usuarios https://console.aws.amazon.com/iam/y seleccione el usuario que creó en el paso 1 de la sección Para configurar Amazon Textract anterior. Elija «Añadir una política en línea» a su usuario y adjunte una política de JSON que incluya las operaciones s3:GetObjects3:PutObject, y s3:ListMultipartUploadPartss3:ListBucketMultipartUploads, ys3:AbortMultipartUpload. Tu JSON puede tener el siguiente aspecto:

  JSON

  {
      "Version":"2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "s3:Get*",
                  "s3:List*",
                  "s3:PutObject",
                  "s3:GetObject",
                  "s3-object-lambda:Get*",
                  "s3-object-lambda:List*",
                  "s3:ListMultipartUploadParts",
                  "s3:ListBucketMultipartUploads",
                  "s3:AbortMultipartUpload"
              ],
              "Resource": "*"
          }
      ]
  }
  

Para proporcionar AWS KMS Permisos clave

• Debes añadir permisos a tu AWS Key Management Service clave para que tu función de servicio pueda descifrar las subidas. El rol de servicio necesitará permisos kms:GenerateDataKey y kms:Decrypt acciones. Asegúrese de que el rol de servicio que creó en el paso 7 de la sección Para configurar Amazon Textract tenga una política de permisos similar a la del ejemplo siguiente.

  En el siguiente ejemplo, ARN from Step 7 sustitúyalo por el ARN de tu rol de servicio:

  {
      "Sid": "Decrypt only",
      "Effect": "Allow",
      "Principal": {
          "AWS": "ARN from Step 7"
      },
      "Action": [
          "kms:Decrypt",
          "kms:ReEncrypt",
          "kms:GenerateDataKey",
          "kms:DescribeKey"
      ],
      "Resource": "*"
  }