Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Configuration d'Amazon Textract pour les opérations asynchrones
<a name="api-async-roles"></a>

Les procédures suivantes vous montrent comment configurer Amazon Textract pour qu'il soit utilisé avec une rubrique Amazon Simple Notification Service (Amazon SNS) et une file d'attente Amazon Simple Queue Service (Amazon SQS).

**Note**  
Si vous utilisez ces instructions pour configurer l'[Détection ou analyse de texte dans un document multipage](async-analyzing-with-sqs.md)Par exemple, vous n'avez pas besoin de suivre les étapes 3 à 6. L'exemple inclut le code permettant de créer et de configurer la rubrique Amazon SNS et la file d'attente Amazon SQS.

**Pour configurer Amazon Textract**

1. Configurez uneAWSpour accéder à Amazon Textract. Pour plus d'informations, consultez [Étape 1 : Configuration d'un compte AWS et création d'un utilisateur IAM](setting-up.md).

   Assurez-vous que l'utilisateur possède au moins les autorisations suivantes :
   + AmazonTextractFullAccess
   + AmazonS3ReadOnlyAccess
   + AmazonSNSFullAccess
   + AmazonSQSFullAccess

1. Installez et configurez le kit SDK AWS requis. Pour plus d'informations, consultez [Étape 2 : Configuration de l'AWS CLIetAWSKits SDK](setup-awscli-sdk.md). 

1. [Créer une rubrique Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html). Préfixez le nom de rubrique avec*Extrait Amazon*. Notez l'Amazon Resource Name (ARN) de la rubrique. Assurez-vous que la rubrique se trouve dans la même région que la rubriqueAWSpoint de terminaison que vous utilisez avec votre compte AWS.

1. [Créez une file d'attente standard Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-create-queue.html)en utilisant le[Console Amazon SQS](https://console.aws.amazon.com/sqs/). Notez l'ARN de la file d'attente.

1. [Abonnez la file d'attente à la rubrique](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-subscribe-queue-sns-topic.html) que vous avez créée à l'étape 3.

1. [Autoriser la rubrique Amazon SNS à envoyer des messages à la file d'attente Amazon SQS](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html).

1. Créez un rôle de service IAM pour accorder à Amazon Textract l'autorisation d'accès à vos rubriques Amazon SNS. Notez l'Amazon Resource Name (ARN) du rôle de service. Pour plus d'informations, consultez [Donner à Amazon Textract l'autorisation d'accès à votre rubrique Amazon SNS](#api-async-roles-all-topics).

1. [Ajoutez la stratégie en ligne ci-dessous](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#embed-inline-policy-console)à l'utilisateur IAM que vous avez créé à l'étape 1. 

   ```
   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "{{MySid}}",
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": "{{Service role ARN from step 7}}"
           }
       ]
   }
   ```

   Attribuez un nom à la stratégie en ligne.

1. Vous pouvez désormais exécuter les exemples dans[Détection ou analyse de texte dans un document multipage](async-analyzing-with-sqs.md).

## Donner à Amazon Textract l'autorisation d'accès à votre rubrique Amazon SNS
<a name="api-async-roles-all-topics"></a>

Amazon Textract doit être autorisé à envoyer un message à votre rubrique Amazon SNS lorsqu'une opération asynchrone est terminée. Vous utilisez un rôle de service IAM pour accorder à Amazon Textract l'autorisation d'accès à la rubrique Amazon SNS. 

 Lorsque vous créez la rubrique Amazon SNS, vous devez ajouter le nom de la rubrique avec**AmazonTextract**—par exemple,**AmazonTextractMyTopicName**. 

1. Connectez-vous à la console IAM ([https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam)).

1. Dans le panneau de navigation,** choisissez Rôles**.

1. Sélectionnez **Créer un rôle**.

1. Pour **Select type of trusted entity (Sélectionner le type d'entité de confiance)**, choisissez **Service AWS**. 

1. Pour**Choisissez le service qui utilisera ce rôle**, choisissez**Textract**.

1. Choisissez **Next (Suivant) Permissions (Autorisations)**.

1. Vérifiez que le**AmazonTextractServiceRole**a été incluse dans la liste des stratégies attachées. Pour afficher la stratégie dans la liste, tapez une partie du nom de la stratégie dans la liste**Stratégies de filtre**.

1. Choisissez **Next (Suivant) Tags (Balises)**.

1. Vous n'avez pas besoin d'ajouter de tags, choisissez donc**Suivant: Review (Examiner)**.

1. Dans la section **Vérification**, pour **role name (Nom du rôle)**, entrez un nom pour le rôle (par exemple, `TextractRole`). Dans**Description du rôle**, mettez à jour la description du rôle, puis choisissez**Création d'un rôle**.

1. Choisissez le nouveau rôle pour ouvrir la page des détails du rôle.

1. Dans le **Summary (Récapitulatif)**, copiez la valeur de l'**ARN de rôle** et enregistrez-la.

1. Choisissez **Trust Relationships**.

1. Choisissez**Modifier la relation d'approbation**, et veiller à ce que la politique de confiance se présente comme suit.

   ```
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "textract.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

1. Choisissez **Update Trust Policy (Mettre à jour la politique d'approbation)**.