Configurando o Amazon Textract para operações assíncronas

Para configurar o Amazon Textract

1. Configure uma AWS conta para acessar o Amazon Textract. Para obter mais informações, consulte Etapa 1: Configurar uma conta da AWS e criar um usuário.

   Certifique-se de que o usuário tenha pelo menos as seguintes permissões:

   • AmazonTextractFullAccess

   • AmazonS3ReadOnlyAccess

   • AmazonSNSFullAccess

   • AmazonSQSFullAccess

   Além disso, garanta que o usuário tenha permissão para passar funções do IAM para o Amazon Textract. Isso é feito por meio de uma PassRole política do IAM. Um exemplo simples dessa política está abaixo:

   JSON

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

2. Instale e configure o AWS SDK necessário. Para obter mais informações, consulte Etapa 2: configurar o AWS CLI and AWS SDKs.

3. Crie um tópico padrão do Amazon SNS. Prefixe o nome do tópico com. AmazonTextract Anote o nome do recurso da Amazon (ARN) do tópico. Certifique-se de que o tópico esteja na mesma região do AWS endpoint que você está usando com sua conta da AWS.

4. Crie uma fila padrão do Amazon SQS usando o console do Amazon SQS. Anotar o ARN da fila.

5. Inscreva a fila no tópico criado na etapa 3.

6. Dê permissão ao tópico do Amazon SNS para enviar mensagens para a fila do Amazon SQS.

7. Crie uma função de serviço do IAM para dar ao Amazon Textract acesso aos seus tópicos do Amazon SNS. Observe o nome de recurso da Amazon (ARN) da função de serviço. Para obter mais informações, consulte Concedendo ao Amazon Textract acesso ao seu tópico do Amazon SNS.

8. Adicione a seguinte política em linha ao usuário do IAM que você criou na etapa 1.

   Dê um nome à política em linha.

9. Agora você pode executar os exemplos emDetectando ou analisando texto em um documento de várias páginas.

1. Faça login no console do IAM (https://console.aws.amazon.com/iam).

2. No painel de navegação, escolha Perfis.

3. Escolha Criar Perfil.

4. Em Select type of trusted entity (Selecionar tipo de entidade confiável), escolha AWS service (Serviço da AWS).

5. Em Escolher o serviço que usará essa função, escolha Textract.

6. Escolha Próximo: Permissões.

7. Verifique se a AmazonTextractServiceRolepolítica foi incluída na lista de políticas anexadas. Para exibir a política na lista, insira parte do nome da política nas políticas de filtro.

8. Escolha Próximo: tags.

9. Não é necessário adicionar tags, portanto, escolha Next: Review (Próximo: revisão).

10. Na seção Review (Revisar), em Role Name (Nome da função), insira um nome para a função (por exemplo, TextractRole). Em Descrição da função, atualize a descrição da função e escolha Criar função.

11. Escolha a nova função para abrir a página de detalhes da função.

12. Em Summary (Resumo), copie o valor do Role ARN (ARN da função) e salve-o.

13. Escolha Relações de Confiança.

14. Escolha Editar relação de confiança e edite a política de confiança. Certifique-se de que sua política de confiança inclua condições que limitem o escopo das permissões apenas aos recursos necessários, pois isso ajudará a evitar o confuso problema do deputado. Para obter mais detalhes sobre esse possível problema de segurança, consulteCross-service prevenção adjunta confusa. No exemplo abaixo, substitua o red texto pelo ID AWS da sua conta.

    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. Selecione Atualizar política de confiança.

Para permitir a descriptografia de uploads do S3 Bucket

• Você precisará fornecer aos usuários apropriados as permissões corretas do Amazon S3.

  Navegue até a seção Usuários do https://console.aws.amazon.com/iam/e selecione o usuário que você criou na Etapa 1 da seção Para configurar o Amazon Textract acima. Escolha “Adicionar política em linha” ao seu usuário e anexe uma política JSON que inclua as s3:GetObject operaçõess3:PutObject, es3:ListMultipartUploadParts,s3:ListBucketMultipartUploads, e. s3:AbortMultipartUpload Seu JSON pode ter a seguinte aparência:

  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 fornecer AWS KMS Permissões principais

• Você deve adicionar permissões à sua AWS Key Management Service chave para permitir que sua função de serviço decifre seus uploads. A função de serviço precisará de permissão kms:GenerateDataKey e kms:Decrypt ações. Certifique-se de que a função de serviço que você criou na Etapa 7 na seção Para configurar o Amazon Textract tenha uma política de permissões semelhante ao exemplo a seguir.

  No exemplo a seguir, ARN from Step 7 substitua pelo ARN da sua função de serviço:

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