Ajouter des jetons ou enregistrer un appareil IDs

Lorsque vous enregistrez pour la première fois une application et un appareil mobile auprès d'un service de notification, tel que le service de notification Apple Push (APNs) et Firebase Cloud Messaging (FCM), les jetons ou l'enregistrement de l'appareil IDs sont renvoyés par le service de notification. Lorsque vous ajoutez les jetons de l'appareil ou que vous IDs vous enregistrez sur AmazonSNS, ils sont utilisés avec le PlatformApplicationArn API pour créer un point de terminaison pour l'application et l'appareil. Lorsqu'Amazon SNS crée le point de terminaison, un EndpointArn est renvoyé. EndpointArnC'est ainsi SNS qu'Amazon sait à quelle application et à quel appareil mobile envoyer le message de notification.

Vous pouvez ajouter des jetons d'appareil et les IDs enregistrer sur Amazon SNS en utilisant les méthodes suivantes :

• Ajoutez manuellement un seul jeton à AWS l'aide du AWS Management Console

• Téléchargez plusieurs jetons à l'aide du CreatePlatformEndpoint API

• Enregistrement de jetons à partir des appareils qui installeront vos applications ultérieurement

Pour ajouter manuellement un jeton d'appareil ou un ID d'enregistrement

1. Connectez-vous à la SNSconsole Amazon.

2. Dans le volet de navigation, choisissez Notifications push.

3. 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, faites-le dès à présent. Pour obtenir des instructions sur la façon de procéder, veuillez consulter Création d'une application de plateforme.

4. Choisissez Ajouter des points de terminaison.

5. Dans la zone Jeton de point de terminaison, saisissez l'ID de jeton ou d'enregistrement, en fonction du service de notification choisi. Par exemple, avec ADM et FCM vous entrez le numéro d'enregistrement.

6. (Facultatif) Dans la zone User Data (Données d'utilisateur), entrez des informations arbitraires à associer au point de terminaison. Amazon SNS n'utilise pas ces données. Les données doivent être au format UTF -8 et être inférieures à 2 Ko.

7. Choisissez Ajouter des points de terminaison.

   Avec le point de terminaison créé, vous pouvez soit envoyer des messages directement à un appareil mobile, soit envoyer des messages à des appareils mobiles abonnés à un sujet.

Pour télécharger plusieurs jetons à l'aide du CreatePlatformEndpoint API

Les étapes suivantes montrent comment utiliser l'exemple d'application Java (bulkuploadpackage) fourni par AWS pour télécharger plusieurs jetons (jetons d'appareil ou enregistrementIDs) sur AmazonSNS. Vous pouvez utiliser cet exemple d'application pour vous familiariser avec le chargement des jetons existants.

Note

Les étapes suivantes utilisent le Java EclipseIDE. Les étapes supposent que vous avez installé le AWS SDK for 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 for Java. Pour plus d'informations sur les informations d'identification, consultez la section Comment puis-je obtenir les informations d'identification de sécurité ? du document Références générales AWS.

1. Téléchargez et décompressez le fichier snsmobilepush.zip.

2. Créez un projet Java dans Eclipse.

3. Importez le dossier SNSSamples dans le répertoire de niveau supérieur du projet Java nouvellement créé. Dans Eclipse, choisissez avec le bouton droit de la souris le nom du projet Java, puis Importer. Développez Général, choisissez Système de fichiers, puis Suivant, naviguez jusqu'au dossier SNSSamples, choisissez OK, puis Terminer.

4. Téléchargez une copie de la CSVbibliothèque Open et ajoutez-la au chemin de construction du bulkupload package.

5. Ouvrez le fichier BulkUpload.properties contenant le package bulkupload.

6. Ajoutez ce qui suit à BulkUpload.properties :

   • L'ApplicationArn auquel vous souhaitez ajouter des points de terminaison.

   • Le chemin absolu pour l'emplacement de votre CSV fichier contenant les jetons.

   • Les noms des CSV fichiers (tels que goodTokens.csv etbadTokens.csv) à créer pour enregistrer les jetons qu'Amazon SNS analyse correctement et ceux qui échouent.

   • (Facultatif) Les caractères permettant de spécifier le délimiteur et le guillemet dans le CSV fichier contenant les jetons.

   • (Facultatif) Nombre de threads à utiliser pour créer simultanément des points de terminaison. La valeur par défaut est 1 thread.

   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

7. Exécutez l'application BatchCreatePlatformEndpointSample .java pour télécharger les jetons sur AmazonSNS.

   Dans cet exemple, les points de terminaison créés pour les jetons chargés avec succès sur Amazon SNS seraient connectésgoodTokens.csv, tandis que les jetons mal formés seraient connectés. badTokens.csv En outre, vous devriez voir STD OUT des journaux écrits sur la console d'Eclipse, contenant un contenu similaire au suivant :

   <1>[SUCCESS] The endpoint was created with Arn arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp/165j2214-051z-3176-b586-138o3d420071
   <2>[ERROR: MALFORMED CSV FILE] Null token found in /mytokendirectory/mytokens.csv            

Pour enregistrer des jetons à partir des appareils qui installeront vos applications ultérieurement

Vous pouvez utiliser l'une des deux options suivantes :

• Utilisez le service Amazon Cognito : votre application mobile aura besoin d'informations d'identification pour créer des points de terminaison associés à votre application de plateforme AmazonSNS. Nous vous conseillons d'utiliser des informations d'identification temporaires qui expirent après une période donnée. Pour la plupart des scénarios, nous recommandons d'utiliser Amazon Cognito pour créer des informations d'identification de sécurité temporaires. Pour plus d'informations, consultez le Guide du développeur Amazon Cognito. Si vous souhaitez être averti lorsqu'une application s'enregistre auprès d'AmazonSNS, vous pouvez vous inscrire pour recevoir un SNS événement Amazon qui fournira le nouveau point de terminaisonARN. Vous pouvez également utiliser le ListEndpointByPlatformApplication API pour obtenir la liste complète des points de terminaison enregistrés auprès d'AmazonSNS.

• Utilisez un serveur proxy : si votre infrastructure d’application est déjà configurée pour que vos applications mobiles soient appelées et enregistrées à chaque installation, vous pouvez continuer à utiliser cette configuration. Votre serveur agira en tant que proxy et transmettra le jeton de l'appareil aux notifications push d'Amazon SNS mobile, ainsi que toutes les données utilisateur que vous souhaitez stocker. À cette fin, le serveur proxy se connectera à Amazon à SNS l'aide de vos AWS informations d'identification et utilisera l'CreatePlatformEndpointAPIappel pour télécharger les informations du jeton. Le nouveau point de terminaison Amazon Resource Name (ARN) sera renvoyé, que votre serveur pourra stocker pour effectuer des appels de publication ultérieurs à AmazonSNS.