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

Azure Notification Hubs propose un moteur Push facile à utiliser et à mettre à l’échelle horizontalement (« scale-out »). Utilisez Notification Hubs pour envoyer des notifications à n’importe quelle plateforme (iOS, Android, Windows, Baidu) et à partir de n’importe quel back-end (cloud ou local). Pour plus d’informations, consultez Présentation d’Azure Notification Hubs.

Dans ce guide de démarrage rapide, vous allez utiliser les paramètres PNS (Platform Notification System) de Notification Hubs pour configurer des notifications Push sur plusieurs plateformes. Le guide de démarrage rapide vous montre les étapes à suivre sur 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 déjà 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.

Apple Push Notification Service

Pour configurer Apple Push Notification Service (APNS) :

1. Dans le portail Azure, dans la page Hub de notification, sélectionnez Apple (APNS) dans le menu de gauche.

2. Pour Mode d’authentification, sélectionnez Certificat ou Jeton.

   a. 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.

     

     b. 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 :

1. Dans la page Hub de notification du portail Azure, sélectionnez Google (FCMv1) dans le menu de gauche.
2. 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.
3. 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é.

Google Firebase Cloud Messaging (FCM)

Remarque

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

Portail

Pour configurer les notifications Push pour Google FCM :

1. Dans la page Hub de notification du portail Azure, sélectionnez Google (GCM/FCM) dans le menu de gauche.

2. Collez la Clé API pour le projet Google FCM que vous avez enregistré précédemment.

3. 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é.

Azure CLI

Vous aurez 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 plus d’informations, consultez Démarrage rapide pour Bash dans 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 connaître les autres options de connexion, consultez Se connecter avec 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 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 version la plus récente est déjà installée.

Configurer les notifications Push pour Google FCM

1. 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
   

2. 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
   

3. 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\"}}"
   

Obtenez les 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) :

1. Dans la page Hub de notification du portail Azure, sélectionnez Windows (WNS) dans le menu de gauche.

2. Entrez des valeurs pour SID de package et Clé de sécurité.

3. Cliquez sur Enregistrer.

   

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

Baidu (Android China)

Pour configurer des notifications Push pour Baidu :

1. Dans la page Hub de notification du portail Azure, sélectionnez Baidu (Android China) dans le menu de gauche.

2. Entrez la Clé API que vous avez obtenue à partir de la console Baidu du projet Push cloud Baidu.

3. Entrez la Clé secrète que vous avez obtenue à partir de la console Baidu du projet Push cloud Baidu.

4. 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é.

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 :

• Envoyer des notifications Push à des applications iOS avec Azure Notification Hubs
• Envoyer des notifications à des appareils Android avec Notification Hubs et Google FCM
• Envoyer des notifications Push à une application UWP s’exécutant sur un appareil Windows
• Envoyer des notifications Push avec Notification Hubs et le push cloud Baidu