Démarrage rapide : Configurer les notifications Push dans un hub de notification

2025-05-03

Azure Notification Hubs fournit un moteur push qui est facile à utiliser et qui effectue un scale-out. Utilisez Notification Hubs pour envoyer des notifications à n’importe quelle plateforme (iOS, Android, Windows) et à partir de n’importe quel serveur principal (cloud ou local). Pour plus d’informations, consultez Présentation d’Azure Notification Hubs.

Dans ce guide de démarrage rapide, vous utilisez les paramètres du système de notification de plateforme (PNS) dans Notification Hubs pour configurer des notifications Push sur plusieurs plateformes. Le guide de démarrage rapide vous montre les étapes à suivre lorsque vous utilisez le portail Azure. Google Firebase Cloud Messaging contient des instructions sur l’utilisation d’Azure CLI.

Remarque

Pour plus d’informations sur les étapes de dépréciation et de migration de Firebase Cloud Messaging, consultez Migration de Google Firebase Cloud Messaging.

Si vous n’avez pas encore créé de hub de notification, créez-en un maintenant. Pour plus d’informations, consultez Créer un hub de notification Azure dans le portail Azure ou Créer un hub de notification Azure avec Azure CLI.

Service de notifications push d’Apple

Pour configurer Apple Push Notification Service (APNS) :

Dans le portail Azure, dans la page Hub de notification, sélectionnez Apple (APNS) dans le menu de gauche.
Pour Mode d’authentification, sélectionnez Certificat ou Jeton.
1. Si vous sélectionnez Certificat :
  - Sélectionnez l’icône de fichier, puis sélectionnez le fichier .p12 que vous voulez charger.
  - Entrez un mot de passe.
  - Sélectionnez le mode Bac à sable. Ou bien, pour envoyer des notifications Push aux utilisateurs qui ont acheté votre application sur le Store, sélectionnez le mode Production.
2. Si vous sélectionnez Jeton :
  - Entrez les valeurs pour ID de clé, ID d’offre groupée, ID de l’équipe et Jeton.
  - Sélectionnez le mode Bac à sable. Ou bien, pour envoyer des notifications Push aux utilisateurs qui ont acheté votre application sur le Store, sélectionnez le mode Production.

Pour plus d’informations, consultez Envoyer des notifications Push à des applications iOS avec Azure Notification Hubs.

Google Firebase Cloud Messaging V1 (FCMv1)

Pour configurer les notifications Push pour Google FCMv1 :

Dans la page Hub de notification du portail Azure, sélectionnez Google (FCMv1) dans le menu de gauche.
Mettez à jour les valeurs de Clé privée, ID de projet et E-mail client du fichier JSON du compte de service provenant de la console Firebase.
Cliquez sur Enregistrer.

Capture d’écran montrant comment configurer Notification Hubs pour Google FCMv1.

Une fois ces étapes terminées, une alerte indique que le hub de notification a été correctement mis à jour. Le bouton Enregistrer est désactivé.

Google Firebase Cloud Messaging (FCM)

Remarque

Firebase Cloud Messaging (FCM) est déconseillé et n'est plus pris en charge.

Portail
Azure CLI

Pour configurer les notifications Push pour Google FCM :

Dans la page Hub de notification du portail Azure, sélectionnez Google (GCM/FCM) dans le menu de gauche.
Collez la Clé API pour le projet Google FCM que vous avez enregistré précédemment.
Cliquez sur Enregistrer.

Une fois ces étapes terminées, une alerte indique que le hub de notification a été correctement mis à jour. Le bouton Enregistrer est désactivé.

Vous avez besoin de la clé API pour votre projet Google Firebase Cloud Messaging (FCM).

Préparation de votre environnement pour Azure CLI

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Cet article nécessite la version 2.0.67 ou ultérieure de l’interface Azure CLI. Si vous utilisez Azure Cloud Shell, la dernière version est déjà installée.

Configurer les notifications Push pour Google FCM

Utilisez la commande az notification-hub credential gcm update pour ajouter votre clé d’API Google à votre hub de notification.

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

L’application Android a besoin d’une chaîne de connexion pour se connecter au hub de notification. Utilisez la commande az notification-hub authorization-rule list pour lister les stratégies d’accès disponibles. Utilisez la commande az notification-hub authorization-rule list-keys pour obtenir les chaînes de connexion de la stratégie d’accès. Spécifiez primaryConnectionString ou secondaryConnectionString dans le paramètre --query pour obtenir directement la chaîne de connexion principale.

#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

Utilisez la commande az notification-hub test-send pour tester l’envoi de messages à l’application Android.

#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\"}}"

Vous pouvez obtenir des références Azure CLI pour d’autres plateformes avec la commande az notification-hub credential .

Pour plus d’informations sur l’envoi de notifications à une application Android, consultez Envoyer des notifications Push aux appareils Android à l’aide de Firebase.

Services de notifications Push Windows

Pour configurer les services de notifications Push Windows (WNS) :

Dans la page Hub de notification du portail Azure, sélectionnez Windows (WNS) dans le menu de gauche.
Entrez des valeurs pour SID de package et Clé de sécurité.
Cliquez sur Enregistrer.

Pour plus d’informations, consultez Envoyer des notifications vers des applications UWP avec Azure Notification Hubs.

Lorsque vous effectuez ces étapes, une alerte indique que le hub de notification a été correctement mis à jour. Le bouton Enregistrer est désactivé.

Pour plus d’informations, consultez Prendre en main Notification Hubs à l’aide de Baidu.

Étapes suivantes

Dans ce démarrage rapide, vous avez appris à configurer les paramètres PNS (Platform Notification System) pour un hub de notification sur le portail Azure.

Pour en savoir plus sur l’envoi de notifications Push vers différentes plateformes, consultez ces tutoriels :