Créer un hub de notification Azure avec Azure CLI

  • Article

Azure Notification Hubs fournit un moteur d’envoi de notifications Push facile à utiliser et à grande échelle qui vous permet d’envoyer des notifications à n’importe quelle plateforme (iOS, Android, Windows, Kindle, Baidu, etc.) à partir de n’importe quel serveur principal (cloud ou local). Pour plus d’informations sur le service, consultez Présentation d’Azure Notification Hubs.

Dans ce guide de démarrage rapide, vous créez un hub de notification avec Azure CLI. La première section présente les étapes à suivre pour créer un espace de noms Notification Hubs. La deuxième section vous présente les étapes à suivre pour créer un hub de notification dans un espace de noms existant. Vous allez également apprendre à créer une stratégie d’accès personnalisée.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Prérequis

Important

Notification Hubs nécessite la version 2.0.67 ou ultérieure d’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.

Créer un groupe de ressources

Azure Notification Hubs, comme toutes les ressources Azure, doit être déployé dans un groupe de ressources. Les groupes de ressources vous permettent d’organiser et de gérer les ressources Azure connexes. Pour en savoir plus sur les groupes de ressources, consultez Qu’est-ce qu’Azure Resource Manager ?

Pour ce guide de démarrage rapide, créez un groupe de ressources nommé spnhubrg dans la zone eastus à l’aide de la commande az group create suivante.

az group create --name spnhubrg --location eastus

Créer un espace de noms Notification Hubs

  1. Créez un espace de noms pour vos hubs de notification.

    Un espace de noms contient un ou plusieurs hubs. Le nom doit être unique dans tous les abonnements Azure et doit comporter au moins six caractères. Pour vérifier la disponibilité d’un nom, utilisez la commande az notification-hub namespace check-availability.

    az notification-hub namespace check-availability --name spnhubns

    Azure CLI répond à votre demande de disponibilité en affichant la sortie de console suivante :

    {
"id": "/subscriptions/yourSubscriptionID/providers/Microsoft.NotificationHubs/checkNamespaceAvailability",
"isAvailable": true,
"location": null,
"name": "spnhubns",
"properties": false,
"sku": null,
"tags": null,
"type": "Microsoft.NotificationHubs/namespaces/checkNamespaceAvailability"
}

    Observez la deuxième ligne de la réponse d’Azure CLI "isAvailable": true. Cette ligne indique false si le nom que vous avez spécifié pour l’espace de noms n’est pas disponible. Après avoir vérifié la disponibilité du nom, exécutez la commande az notification-hub namespace create pour créer l’espace de noms.

    az notification-hub namespace create --resource-group spnhubrg --name spnhubns  --location eastus --sku Free

    Si le --name que vous avez indiqué dans la commande az notification-hub namespace create n’est pas disponible ou ne respecte pas les les règles et les restrictions de nommage pour les ressources Azure, Azure CLI répond avec la sortie de console suivante :

    #the name is not available
The specified name is not available. For more information visit https://aka.ms/eventhubsarmexceptions.

#the name is invalid
The specified service namespace is invalid.

    Si le premier nom que vous avez essayé n’est pas correct, sélectionnez un autre nom pour votre nouvel espace de noms et réexécutez la commande az notification-hub namespace create.

    Notes

    À partir de cette étape, vous devez remplacer la valeur du paramètre --namespace dans chaque commande Azure CLI que vous copiez à partir de ce guide de démarrage rapide.

  2. Récupérez la liste des espaces de noms.

    Pour voir les informations relatives à votre nouvel espace de noms, utilisez la commande az notification-hub namespace list. Le paramètre facultatif --resource-group vous permet de voir tous les espaces de noms d’un abonnement.

    az notification-hub namespace list --resource-group spnhubrg

Créer des hubs de notification

  1. Créez votre premier hub de notification.

    Vous pouvez désormais créer un ou plusieurs hubs de notification dans le nouvel espace de noms. Exécutez la commande az notification-hub create pour créer un hub de notification.

    az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name spfcmtutorial1nhub --location eastus

  2. Créez un deuxième hub de notification.

    Vous pouvez créer plusieurs hubs de notification dans un seul espace de noms. Pour créer un deuxième hub de notification dans le même espace de noms, réexécutez la commande az notification-hub create avec un autre nom de hub.

    az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name mysecondnhub --location eastus

  3. Récupérez la liste des hubs de notification.

    Azure CLI retourne un message de réussite ou d’erreur avec chaque commande exécutée. La possibilité de demander une liste des hubs de notification est cependant rassurante. La commande az notification-hub list a été conçue à cet effet.

    az notification-hub list --resource-group spnhubrg --namespace-name spnhubns --output table

Utiliser des stratégies d’accès

  1. Azure Notification Hubs utilise la sécurité de signature d’accès partagé par le biais de stratégies d’accès. Deux stratégies sont créées automatiquement quand vous créez un hub de notification. Les chaînes de connexion de ces stratégies sont nécessaires pour configurer les notifications Push. La commande az notification-hub authorization-rule list fournit une liste de noms de stratégie avec les groupes de ressources correspondants.

    az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table

    Important

    N’utilisez pas la stratégie DefaultFullSharedAccessSignature dans votre application. Elle est destinée à être utilisée seulement dans votre back-end. Utilisez uniquement les stratégies d’accès Listen dans votre application cliente.

  2. Si vous voulez créer des règles d’autorisation supplémentaires avec des noms explicites, vous pouvez créer et personnaliser votre propre stratégie d’accès en utilisant la commande az notification-hub authorization-rule create. Le paramètre --rights est une liste des autorisations à attribuer délimitées par des espaces.

    az notification-hub authorization-rule create --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --rights Listen Manage Send

  3. Il existe deux jeux de clés et de chaînes de connexion pour chaque stratégie d’accès. Vous en aurez besoin pour configurer un hub de notification. Pour lister les clés et les chaînes de connexion d’une stratégie d’accès Notification Hubs, utilisez la commande az notification-hub authorization-rule list-keys.

    # query the keys and connection strings for DefaultListenSharedAccessSignature
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name DefaultListenSharedAccessSignature --output table

    # query the keys and connection strings for a custom policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --output table

    Notes

    Un espace de noms Notification Hubs et un hub de notification ont des stratégies d’accès distinctes. Vérifiez que vous utilisez la commande de référence Azure CLI appropriée quand vous recherchez des clés et des chaînes de connexion.

Nettoyer les ressources

Quand vous n’avez plus besoin du groupe de ressources, utilisez la commande az group delete pour supprimer ce groupe ainsi que toutes les ressources associées :

az group delete --name spnhubrg

Étapes suivantes