Quickstart: Pushmeldingen instellen in een Notification Hub

Azure Notification Hubs biedt een push-engine die eenvoudig te gebruiken is en die wordt uitgeschaald. Gebruik Notification Hubs om meldingen te verzenden naar elk platform (iOS, Android, Windows, Baidu) en vanaf elke back-end (cloud of on-premises). Zie Wat is Azure Notification Hubs? voor meer informatie.

In deze quickstart gebruikt u de PNS-instellingen (Platform Notification System) in Notification Hubs om pushmeldingen in te stellen op meerdere platforms. In de quickstart ziet u de stappen die in de Azure Portal worden gezet. Google Firebase Cloud Messaging bevat instructies voor het gebruik van de Azure CLI.

Notitie

Zie De migratie van Google Firebase Cloud Messaging voor informatie over de afschaffing en migratiestappen van Firebase Cloud Messaging.

Maak nu een notification hub als u dat nog niet hebt gedaan. Zie Een Azure notification hub maken met behulp van Azure Portal of Een Azure notification hub maken met behulp van de Azure-CLI voor meer informatie.

Apple Push Notification Service

Apple Push Notification Service (APNS) instellen:

1. Selecteer in de Azure Portal op de pagina Notification Hub Apple (APNS) in het menu aan de linkerkant.

2. Selecteer Certificaat of Token als Verificatiemodus.

   a. Als u Certificaat selecteert:

   • Selecteer het pictogram van het bestand en selecteer het .p12-bestand dat u wilt uploaden.

   • Voer een wachtwoord in.

   • Selecteer de modus Sandbox. Of selecteer de modus Productie als u pushmeldingen wilt verzenden naar gebruikers die uw app in de Store hebben gekocht.

     

     b. Als u Token selecteert:

   • Voer de waarden in voor sleutel-id, bundel-id, team-id en token.

   • Selecteer de modus Sandbox. Of selecteer de modus Productie als u pushmeldingen wilt verzenden naar gebruikers die uw app in de Store hebben gekocht.

     

Zie Pushmeldingen verzenden naar iOS-apps met Azure Notification Hubs voor meer informatie.

Google Firebase Cloud Messaging V1 (FCMv1)

Pushmeldingen instellen voor Google FCMv1:

1. Selecteer Google (FCMv1) in azure Portal op de pagina Notification Hub in het linkermenu.
2. Werk de waarden voor persoonlijke sleutel, project-id en client-e-mail bij uit het JSON-bestand van het serviceaccount dat is verkregen via de Firebase-console.
3. Selecteer Opslaan.

Als u deze stappen hebt voltooid, ziet u een waarschuwing die aangeeft dat de notification hub is bijgewerkt. De knop Opslaan kan niet worden gekozen.

Google Firebase Cloud Messaging (FCM)

Notitie

Firebase Cloud Messaging (FCM) is afgeschaft en wordt niet meer ondersteund.

Portal

Ga als volgt te werk om pushmeldingen in te stellen voor Google FCM:

1. Selecteer in de Azure Portal op de pagina Notification Hub Google (GCM/FCM) in het menu aan de linkerkant.

2. Plak de API-sleutel voor het Google FCM-project dat u eerder hebt opgeslagen.

3. Selecteer Opslaan.

   

Als u deze stappen hebt voltooid, ziet u een waarschuwing die aangeeft dat de notification hub is bijgewerkt. De knop Opslaan kan niet worden gekozen.

Azure-CLI

U hebt de API-sleutel voor uw Google Firebase Cloud Messaging-project (FCM) nodig.

De omgeving voorbereiden op de Azure CLI

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Voor dit artikel is versie 2.0.67 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

Pushmeldingen instellen voor Google FCM

1. Gebruik de opdrachtaz notification-hub credential gcm update om uw Google API-sleutel toe te voegen aan uw notification hub.

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

2. De Android-app heeft een verbindingsreeks nodig om verbinding te maken met de notification hub. Gebruik de opdracht az notification-hub authorization-rule list om het beschikbare toegangsbeleid weer te geven. Gebruik de opdracht az notification-hub authorization-rule list-keys om de verbindingsreeksen voor het toegangsbeleid te verkrijgen. Geef de primaryConnectionString of secondaryConnectionString in de --query-parameter op om de primaire verbindingsreeks rechtstreeks te verkrijgen.

   #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. Gebruik de opdracht az notification-hub test-send om het verzenden van berichten naar de Android-app te 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\"}}"
   

Verkrijg Azure CLI-verwijzingen voor andere platforms met de opdracht az notification-hub credential.

Zie Pushmeldingen naar Android-apparaten verzenden met Firebase voor meer informatie over het verzenden van meldingen naar een Android-app.

Windows Push Notification Services

Windows Push Notification Services (WNS) instellen:

1. Selecteer in de Azure Portal op de pagina Notification Hub Windows (WNS) in het menu aan de linkerkant.

2. Voer waarden in voor Pakket-SID en Beveiligingssleutel.

3. Selecteer Opslaan.

   

Zie Meldingen verzenden naar UWP-apps met Azure Notification Hubs voor meer informatie.

Baidu (Android China)

Ga als volgt te werk om pushmeldingen in te stellen voor Baidu:

1. Selecteer in de Azure Portal op de pagina Notification Hub Baidu (Android China) in het menu aan de linkerkant.

2. Voer de API-sleutel in die u via de Baidu-console hebt gekregen in het Baidu Cloud Push-project.

3. Voer de geheime sleutel in die u hebt gekregen via de Baidu-console, in het Baidu Cloud Push-project.

4. Selecteer Opslaan.

   

Als u deze stappen hebt voltooid, ziet u een waarschuwing die aangeeft dat de notification hub is bijgewerkt. De knop Opslaan kan niet worden gekozen.

Zie Aan de slag met Notification Hubs met behulp van Baidu voor meer informatie.

Volgende stappen

In deze quickstart hebt u geleerd hoe u instellingen voor platformmeldingensystemen kunt configureren voor een notification hub in de Azure Portal.

Zie deze zelfstudies voor meer informatie over het pushen van meldingen naar verschillende platforms:

• Pushmeldingen verzenden naar iOS-apps met Azure Notification Hubs
• Meldingen verzenden naar Android-apparaten met Notification Hubs en Google FCM
• Meldingen verzenden naar een UWP-app die wordt uitgevoerd op een Windows-apparaat
• Meldingen verzenden met behulp van Notification Hubs en Baidu Cloud Push