Schnellstart: Einrichten von Pushbenachrichtigungen in einem Notification Hub

Azure Notification Hubs bietet ein Pushmodul, das einfach zu verwenden ist und das skaliert wird. Verwenden Sie Benachrichtigungshubs, um Benachrichtigungen an eine beliebige Plattform (iOS, Android, Windows) und von jedem Back-End (Cloud oder lokal) zu senden. Weitere Informationen finden Sie unter Was ist Azure Notification Hubs?.

In dieser Schnellstartanleitung verwenden Sie die PNS-Einstellungen (Platform Notification System) in Notification Hubs, um Pushbenachrichtigungen auf mehreren Plattformen einzurichten. In der Schnellstartanleitung werden die Schritte gezeigt, die Sie ausführen müssen, wenn Sie das Azure-Portal verwenden. Google Firebase Cloud Messaging enthält eine Anleitung zur Verwendung der Azure CLI.

Hinweis

Informationen zur Einstellung und Migrationsschritte für Firebase Cloud Messaging finden Sie unter Google Firebase Cloud Messaging-Migration.

Wenn Sie noch keinen Benachrichtigungshub erstellt haben, erstellen Sie jetzt einen. Weitere Informationen finden Sie unter Erstellen einer Azure Notification Hub-Instanz über das Azure-Portal oder Erstellen einer Azure Notification Hub-Instanz mithilfe der Azure-Befehlszeilenschnittstelle.

Apple-Pushbenachrichtigungsdienst

So richten Sie einen Apple Push Notification Service (APNS) ein:

1. Wählen Sie im Azure-Portal auf der Seite Notification Hub im Menü auf der linken Seite die Option Apple (APNS) aus.

2. Wählen Sie für Authentifizierungsmodus entweder Zertifikat oder Token aus.

   1. Wenn Sie Zertifikat auswählen:

      • Wählen Sie das Dateisymbol und anschließend die hochzuladende P12-Datei aus.
      • Geben Sie ein Kennwort ein.
      • Wählen Sie den Modus Sandbox aus. Alternativ können Sie den Modus Produktion auswählen, um Pushbenachrichtigungen an Benutzer zu senden, die Ihre App im Store erworben haben.

      

   2. Wenn Sie Token auswählen:

      • Geben Sie die Werte für Schlüssel-ID, Paket-ID, Team-ID und Token ein.
      • Wählen Sie den Modus Sandbox aus. Alternativ können Sie den Modus Produktion auswählen, um Pushbenachrichtigungen an Benutzer zu senden, die Ihre App im Store erworben haben.

      

Weitere Informationen finden Sie unter Senden von Pushbenachrichtigungen an iOS-Apps mit Azure Notification Hubs.

Google Firebase Cloud Messaging V1 (FCMv1)

Richten Sie Pushbenachrichtigungen für Google FCMv1 wie folgt ein:

1. Wählen Sie im Azure-Portal auf der Seite Notification Hub im Menü auf der linken Seite die Option Google (FCMv1) aus.
2. Aktualisieren Sie die Werte für Privater Schlüssel, Projekt-ID und Client-E-Mail aus der JSON-Datei des Dienstkontos, die in der Firebase-Konsole abgerufen wurde.
3. Wählen Sie Speichern.

Wenn Sie diese Schritte abgeschlossen haben, wird angezeigt, dass der Notification Hub erfolgreich aktualisiert wurde. Die Schaltfläche Save (Speichern) ist deaktiviert.

Google Firebase Cloud Messaging (FCM)

Hinweis

Firebase Cloud Messaging (FCM) wurde als veraltet markiert und wird nicht mehr unterstützt.

Portal

Richten Sie Pushbenachrichtigungen für Google FCM wie folgt ein:

1. Wählen Sie im Azure-Portal auf der Seite Notification Hub im Menü auf der linken Seite die Option Google (GCM/FCM) aus.

2. Fügen Sie den API-Schlüssel für das Google FCM-Projekt ein, das Sie zuvor gespeichert haben.

3. Wählen Sie Speichern.

   

Wenn Sie diese Schritte abgeschlossen haben, wird angezeigt, dass der Notification Hub erfolgreich aktualisiert wurde. Die Schaltfläche Save (Speichern) ist deaktiviert.

Azure-Befehlszeilenschnittstelle

Sie benötigen den API-Schlüssel für Ihr Google Firebase Cloud Messaging (FCM)-Projekt.

Vorbereiten der Umgebung für die Azure CLI

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter "Erste Schritte mit Azure Cloud Shell".

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

  • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Weitere Anmeldeoptionen finden Sie unter Authentifizieren bei Azure mithilfe der Azure CLI.

  • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden und Verwalten von Erweiterungen mit der Azure CLI.

  • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

• Für diesen Artikel ist mindestens Version 2.0.67 der Azure CLI erforderlich. Wenn Sie Azure Cloud Shell verwenden, ist die neueste Version bereits installiert.

Einrichten von Pushbenachrichtigungen für Google FCM

1. Verwenden Sie den Befehl az notification-hub credential gcm update, um Ihren Google-API-Schlüssel dem Notification Hub hinzuzufügen.

   az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
   

2. Die Android-App benötigt für die Verbindung mit dem Notification Hub eine Verbindungszeichenfolge. Verwenden Sie den Befehl az notification-hub authorization-rule list, um die verfügbaren Zugriffsrichtlinien aufzulisten. Verwenden Sie den Befehl az notification-hub authorization-rule list-keys, um die Verbindungszeichenfolgen für Zugriffsrichtlinien abzurufen. Geben Sie primaryConnectionString oder secondaryConnectionString über den Parameter --query an, um die primäre Verbindungszeichenfolge direkt zu erhalten.

   #list access policies for a notification hub
   az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
   
   #list keys and connection strings for a notification hub access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json
   
   #get the primaryConnectionString for an access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
   

3. Verwenden Sie den Befehl az notification-hub test-send, um das Senden von Nachrichten an die Android-App zu testen.

   #test with message body
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"
   
   #test with JSON string
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"
   

Sie können Azure CLI-Referenzen für verschiedene Plattformen mit dem Befehl az notification-hub credential abrufen.

Weitere Informationen zum Senden von Benachrichtigungen an eine Android-Anwendung finden Sie unter Senden von Pushbenachrichtigungen an Android-Geräte mit Firebase.

Windows-Pushbenachrichtigungsdienst (Windows Push Notification Service, WNS)

So richten Sie den Windows-Pushbenachrichtigungsdienst (WNS) ein:

1. Wählen Sie im Azure-Portal auf der Seite Notification Hub im Menü auf der linken Seite die Option Windows (WNS) aus.

2. Geben Sie Werte für Paket-SID und Sicherheitsschlüssel ein.

3. Wählen Sie Speichern.

   

Weitere Informationen finden Sie unter Tutorial: Senden von Benachrichtigungen an Apps für die universelle Windows-Plattform mit Azure Notification Hubs.

Wenn Sie diese Schritte ausführen, gibt eine Warnung an, dass der Benachrichtigungshub erfolgreich aktualisiert wurde. Die Schaltfläche Save (Speichern) ist deaktiviert.

Weitere Informationen finden Sie unter Erste Schritte mit Notification Hubs mit Baidu.

Nächste Schritte

In dieser Schnellstartanleitung haben Sie gelernt, wie Sie im Azure-Portal Benachrichtigungssystemeinstellungen für einen Notification Hub konfigurieren.

Weitere Informationen zum Senden von Pushbenachrichtigungen an verschiedene Plattformen finden Sie in diesen Tutorials:

• Senden von Pushbenachrichtigungen an iOS-Apps mit Azure Notification Hubs
• Senden von Benachrichtigungen an Android-Geräte mit Azure Notification Hubs und Google Firebase Cloud Messaging
• Senden von Benachrichtigungen an Apps für die universelle Windows-Plattform auf einem Windows-Gerät
• Senden von Benachrichtigungen mit Azure Notification Hubs und Baidu Cloud Push