

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.

# Intégration de jetons d'appareils à Amazon SNS pour les notifications mobiles
<a name="mobile-push-send-devicetoken"></a>

Lorsque vous enregistrez pour la première fois une application et un appareil mobile auprès d'un service de notification, tel que Apple Push Notification Service (APNs) et Firebase Cloud Messaging (FCM), les jetons d'appareil ou l'enregistrement IDs sont renvoyés par le service. Ils tokens/IDs sont ajoutés à Amazon SNS afin de créer un point de terminaison pour l'application et l'appareil, à l'aide de l'[https://docs.aws.amazon.com/sns/latest/api/API_PlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_PlatformApplication.html)API. Une fois le point de terminaison créé, un [https://docs.aws.amazon.com/sns/latest/api/API_Endpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_Endpoint.html)est renvoyé, qu'Amazon SNS utilise pour diriger les notifications vers l'application/l'appareil approprié.

Vous pouvez ajouter des jetons d'appareil ou un enregistrement IDs sur Amazon SNS de la manière suivante :
+ Ajoutez manuellement un seul jeton via AWS Management Console
+ Chargement de plusieurs jetons à l'aide de l'API [https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)
+ Enregistrez des jetons pour les futurs appareils

****Pour ajouter manuellement un jeton d'appareil ou un identifiant d'enregistrement****

1. Connectez-vous à la [console Amazon SNS](https://console.aws.amazon.com/sns/home).

1. Dans le volet de navigation, sélectionnez **Notifications push**.

1. Dans la section **Applications de plate-forme**, sélectionnez votre application, puis choisissez **Modifier**. Si vous n'avez pas encore créé d'application de plateforme, suivez le [Création d'une application de plateforme Amazon SNS](mobile-push-send-register.md) guide pour le faire dès maintenant.

1. Choisissez **Créer un point de terminaison**.

1. Dans le champ **Endpoint Token**, entrez le **jeton** ou l'**ID d'enregistrement**, selon le service de notification que vous utilisez (par exemple, l'ID d'enregistrement FCM).

1. (Facultatif) Entrez des données supplémentaires dans le champ **Données utilisateur**. Ces données doivent être codées en UTF-8 et être inférieures à 2 Ko.

1. Choisissez **Créer un point de terminaison**.

Une fois le point de terminaison créé, vous pouvez envoyer des messages directement à l'appareil mobile ou aux appareils mobiles abonnés à une rubrique Amazon SNS.

****Pour télécharger plusieurs jetons à l'aide de l'`CreatePlatformEndpoint`API****

Les étapes suivantes montrent comment utiliser l'exemple d'application Java (`bulkupload`package) fourni par AWS pour télécharger plusieurs jetons (jetons d'appareil ou enregistrement IDs) sur Amazon SNS. Vous pouvez utiliser cet exemple d'application pour vous familiariser avec le chargement des jetons existants. 
**Note**  
Les étapes suivantes utilisent l'IDE Eclipse Java. Les étapes supposent que vous avez installé le AWS SDK pour Java et que vous disposez des informations d'identification AWS de sécurité pour votre Compte AWS. Pour de plus amples informations, veuillez consulter [AWS SDK pour Java](https://aws.amazon.com/sdkforjava/). Pour plus d'informations sur les informations d'identification, consultez les [informations d'identification AWS de sécurité](https://docs.aws.amazon.com/general/latest/gr/getting-aws-sec-creds.html) dans le *guide de l'utilisateur IAM*. 

1. Téléchargez et décompressez le fichier [snsmobilepush.zip](samples/snsmobilepush.zip). 

1. Créez un nouveau **projet Java** dans Eclipse et importez le `SNSSamples` dossier dans le projet. 

1. Téléchargez la bibliothèque [OpenCSV](http://sourceforge.net/projects/opencsv/) et ajoutez-la au chemin de compilation.

1. Dans le `BulkUpload.properties` fichier, spécifiez les éléments suivants : 
   + Votre `ApplicationArn` (ARN de l'application de plateforme).
   + Le chemin absolu vers votre fichier CSV contenant les jetons.
   + Enregistrement des noms de fichiers pour les jetons réussis et échoués. Par exemple : `goodTokens.csv` et `badTokens.csv`.
   + (Facultatif) Configuration du délimiteur, du guillemet et du nombre de fils à utiliser.

   Votre `BulkUpload.properties` terminé devrait ressembler à ce qui suit :

   ```
   applicationarn: arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp
   csvfilename: C:\\mytokendirectory\\mytokens.csv
   goodfilename: C:\\mylogfiles\\goodtokens.csv
   badfilename: C:\\mylogfiles\\badtokens.csv
   delimiterchar: ','
   quotechar: '"'
   numofthreads: 5
   ```

1.  Exécutez l'application **BatchCreatePlatformEndpointSample.java** pour télécharger les jetons sur Amazon SNS. Les jetons téléchargés avec succès seront connectés`goodTokens.csv`, tandis que les jetons mal formés seront connectés. `badTokens.csv`

**Pour enregistrer des jetons provenant d'appareils pour de futures installations d'applications**

Deux options s'offrent à vous pour ce processus :

**Utiliser le service Amazon Cognito**  
Votre application mobile peut utiliser des informations d'identification de sécurité temporaires pour créer des points de terminaison. Il est recommandé d'utiliser Amazon Cognito pour générer des informations d'identification temporaires. Pour plus d'informations, consultez le guide du *[développeur Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/)*   
Pour suivre [les inscriptions](application-event-notifications.md) aux applications, utilisez les événements Amazon SNS pour recevoir des notifications lors de la création d'un nouveau point de terminaison ARNs .  
Vous pouvez également utiliser l'[https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)API pour récupérer la liste des points de terminaison enregistrés.

**Utilisation d'un serveur proxy**  
Si l'infrastructure de votre application prend déjà en charge l'enregistrement des appareils lors de l'installation, vous pouvez utiliser votre serveur comme proxy. Il transmettra les jetons de l'appareil à Amazon SNS via l'[https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)API.  
L'ARN du point de terminaison créé par Amazon SNS sera renvoyé et pourra être stocké par votre serveur pour la publication de futurs messages.