Hinzufügen von Geräte-Token oder Registrierung IDs

Wenn Sie eine App und ein Mobilgerät zum ersten Mal bei einem Benachrichtigungsdienst wie Apple Push Notification Service (APNs) und Firebase Cloud Messaging (FCM) registrieren, IDs werden Geräte-Token oder Registrierungen vom Benachrichtigungsdienst zurückgegeben. Wenn Sie die Geräte-Token oder die Registrierung IDs zu Amazon hinzufügenSNS, werden sie zusammen mit dem verwendet, PlatformApplicationArn API um einen Endpunkt für die App und das Gerät zu erstellen. Wenn Amazon den Endpunkt SNS erstellt, EndpointArn wird ein zurückgegeben. EndpointArnSo SNS weiß Amazon, an welche App und welches Mobilgerät die Benachrichtigung gesendet werden soll.

Sie können Geräte-Token und die Registrierung IDs bei Amazon SNS mit den folgenden Methoden hinzufügen:

• Manuelles Hinzufügen eines einzelnen Tokens zur AWS Verwendung von AWS Management Console

• Laden Sie mehrere Token hoch mit dem CreatePlatformEndpoint API

• Registrieren Sie Token aus Geräten, die künftig Ihre Apps installieren werden

So fügen Sie manuell ein Geräte-Token oder eine Registrierungs-ID hinzu

1. Melden Sie sich bei der SNSAmazon-Konsole an.

2. Wählen Sie im Navigationsbereich Push-Benachrichtigungen aus.

3. Wählen Sie im Abschnitt Plattformanwendungen Ihre Anwendung aus und klicken Sie dann auf Bearbeiten. Wenn Sie noch keine Plattformanwendung erstellt haben, erstellen Sie jetzt eine. Anweisungen dazu finden Sie unter Erstellen einer Plattformanwendung.

4. Wählen Sie Endpunkt hinzufügen aus.

5. Geben Sie in das Feld Endpoint Token (Endpunkt-Token) entweder die Token-ID oder die Registrierungs-ID ein, je nachdem mit welchem Benachrichtigungsservice Sie arbeiten. Zum Beispiel mit ADM und geben FCM Sie die Registrierungs-ID ein.

6. (Optional) Geben Sie in das Feld User Data beliebige Informationen ein, die dem Endpunkt zugeordnet werden können. Amazon verwendet diese Daten SNS nicht. Die Daten müssen im Format UTF -8 und kleiner als 2 KB sein.

7. Wählen Sie Endpunkt hinzufügen aus.

   Mit dem erstellten Endpunkt können Sie entweder Nachrichten direkt an ein Mobilgerät oder Nachrichten an Mobilgeräte senden, die ein Thema abonniert haben.

Um mehrere Tokens hochzuladen, verwenden Sie CreatePlatformEndpoint API

Die folgenden Schritte zeigen, wie Sie die von bereitgestellte Beispiel-Java-App (bulkuploadPaket) verwenden AWS , um mehrere Token (Geräte-Token oder RegistrierungIDs) auf Amazon hochzuladenSNS. Sie können diese Beispielanwendung verwenden, um die ersten Schritte zum Hochladen der vorhandenen Token zu unternehmen.

Anmerkung

In den folgenden Schritten wird Eclipse Java verwendetIDE. Bei den Schritten wird davon ausgegangen, dass Sie das installiert haben AWS SDK for Java und über die AWS Sicherheitsanmeldeinformationen für Ihr verfügen AWS-Konto. Weitere Informationen finden Sie unter AWS SDK for Java. Weitere Informationen zu den Anmeldedaten finden Sie unter Wie erhalte ich Sicherheitsanmeldeinformationen? in der Allgemeine AWS-Referenz.

1. Laden Sie die Datei snsmobilepush.zip herunter und entpacken Sie sie.

2. Erstellen Sie ein neues -Java-Projekt in Eclipse.

3. Importieren Sie den Ordner SNSSamples in das oberste Verzeichnis des neu erstellten Java-Projekts. Wählen Sie in Eclipse mit der rechten Maustaste den Namen des Java-Projekts und wählen Sie dann Import (Importieren). Erweitern Sie General (Allgemeines) und wählen Sie File System (Dateisystem) und danach Next (Weiter). Navigieren Sie zum Ordner SNSSamples, wählen Sie OK und schließlich Finish (Fertig stellen).

4. Laden Sie eine Kopie der CSVOpen-Bibliothek herunter und fügen Sie sie dem Build-Pfad des bulkupload Pakets hinzu.

5. Öffnen Sie die Datei BulkUpload.properties, die im Paket bulkupload enthalten ist.

6. Fügen Sie Folgendes zu BulkUpload.properties hinzu:

   • Den ApplicationArn, dem Sie Endpunkte hinzufügen möchten.

   • Der absolute Pfad für den Speicherort Ihrer CSV Datei, die die Token enthält.

   • Die Namen für CSV Dateien (wie goodTokens.csv undbadTokens.csv), die für die Protokollierung der Token, die Amazon korrekt SNS analysiert, und der Token, die fehlschlagen, erstellt werden sollen.

   • (Optional) Die Zeichen zur Angabe des Trennzeichens und des Anführungszeichens in der CSV Datei, die die Token enthält.

   • (Optional) Die Anzahl der zu verwendenden Threads, um gleichzeitig Endpunkte zu erstellen. Die Standardeinstellung ist 1 Thread.

   Ihre vollständigen BulkUpload.properties sollten wie folgt aussehen:

   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. Führen Sie die BatchCreatePlatformEndpointSample .java-Anwendung aus, um die Token auf Amazon SNS hochzuladen.

   In diesem Beispiel SNS würden die Endpunkte, die für die erfolgreich auf Amazon hochgeladenen Token erstellt wurden, angemeldetgoodTokens.csv, während die falsch formatierten Token angemeldet würden. badTokens.csv Darüber hinaus sollten Sie STD OUT Logs sehen, die auf die Konsole von Eclipse geschrieben wurden und Inhalte wie die folgenden enthalten:

   <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            

Registrieren von Token aus Geräten, die künftig Ihre Apps installieren werden

Verwenden Sie eine der folgenden beiden Optionen:

• Verwenden Sie den Amazon Cognito-Service: Ihre mobile App benötigt Anmeldeinformationen, um Endgeräte zu erstellen, die mit Ihrer SNS Amazon-Plattformanwendung verknüpft sind. Wir empfehlen die Verwendung temporärer Anmeldeinformationen, die nach einem bestimmten Zeitraum ablaufen. Für die meisten Szenarien empfehlen wir, dass Sie Amazon Cognito zum Erstellen temporärer Sicherheitsanmeldeinformationen verwenden. Weitere Informationen finden Sie im Amazon Cognito Entwicklerhandbuch. Wenn Sie benachrichtigt werden möchten, wenn sich eine App bei Amazon registriertSNS, können Sie sich registrieren, um ein SNS Amazon-Event zu erhalten, das den neuen Endpunkt bereitstelltARN. Sie können den auch verwenden ListEndpointByPlatformApplicationAPI, um die vollständige Liste der bei Amazon SNS registrierten Endgeräte abzurufen.

• Verwenden Sie einen Proxy-Server: Wenn Ihre Anwendungsinfrastruktur bereits so eingerichtet ist, dass Ihre mobilen Apps bei jeder Installation aufgerufen werden und sich registrieren, können Sie diese Einstellungen weiterverwenden. Ihr Server fungiert als Proxy und leitet das Geräte-Token zusammen mit allen Benutzerdaten, die Sie speichern möchten, an SNS mobile Amazon-Push-Benachrichtigungen weiter. Zu diesem Zweck stellt der Proxy-Server SNS mithilfe Ihrer AWS Anmeldeinformationen eine Verbindung zu Amazon her und verwendet den CreatePlatformEndpoint API Aufruf, um die Token-Informationen hochzuladen. Der neu erstellte Endpunkt Amazon Resource Name (ARN) wird zurückgegeben, den Ihr Server für nachfolgende Veröffentlichungsaufrufe an Amazon speichern kannSNS.