Partager via

Démarrage rapide : Créer un hub de notification Azure à l’aide d’Azure CLI

Azure Notification Hubs fournit un moteur push facile à utiliser et mis à l’é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 Qu’est-ce qu’Azure Notification Hubs ?.

Dans ce guide de démarrage rapide, vous créez un hub de notification à l’aide d’Azure CLI. La première section vous donne les étapes de création d’un espace de noms Notification Hubs. La deuxième section vous donne des étapes 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.

Prerequisites

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 associées. Consultez Présentation d’Azure Resource Manager pour en savoir plus sur les groupes de ressources.

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, et le nom doit être unique dans tous les abonnements Azure et 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 la 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"
}

    Notez la deuxième ligne dans la réponse Azure CLI. "isAvailable": true Cette ligne lit false si le nom souhaité que vous avez spécifié pour l’espace de noms n’est pas disponible. Une fois que vous avez confirmé la disponibilité du nom, exécutez la commande az notification-hub namespace create pour créer votre espace de noms.

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

    Si le --name que vous avez fourni à la commande az notification-hub namespace create n'est pas disponible ou ne respecte pas les règles et restrictions d'affectation de noms pour les ressources Azure, Azure CLI répond avec la sortie de la 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 prénom que vous avez essayé n’a pas réussi, sélectionnez un autre nom pour votre nouvel espace de noms et réexécutez la az notification-hub namespace create commande.

    Note

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

  2. Obtenir la liste des espaces de noms.

    Pour afficher les détails de 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.

    Un ou plusieurs hubs de notification peuvent maintenant être créés dans votre 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.

    Plusieurs hubs de notification peuvent être créés dans un espace de noms unique. Pour créer un deuxième hub de notification dans le même espace de noms, réexécutez la commande à l’aide az notification-hub create d’un autre nom de hub.

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

  3. Obtenir la liste des hubs de notification.

    Azure CLI retourne un message de réussite ou d’erreur avec chaque commande exécutée ; Toutefois, la possibilité d’interroger une liste de hubs de notification est 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é des signatures d’accès partagé par le biais de l’utilisation de stratégies d’accès. Deux stratégies sont créées automatiquement lorsque 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 et de leurs groupes de ressources respectifs.

    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. Cette stratégie est destinée à être utilisée uniquement dans votre back-end. Utilisez uniquement les Listen stratégies d'accès dans votre application cliente.

  2. Si vous souhaitez créer des règles d’autorisation supplémentaires avec des noms significatifs, vous pouvez créer et personnaliser votre propre stratégie d’accès à l’aide de la commande az notification-hub authorization-rule create . Le --rights paramètre est une liste délimitée d’espace des autorisations que vous souhaitez affecter.

    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 ensembles de clés et de chaînes de connexion pour chaque stratégie d’accès. Vous en aurez besoin ultérieurement pour configurer un hub de notification. Pour répertorier 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

    Note

    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 référence Azure CLI correcte lors de l’interrogation des clés et des chaînes de connexion.

Nettoyer les ressources

Quand vous n’en avez plus besoin, utilisez la commande az group delete pour supprimer le groupe de ressources et toutes les ressources associées :

az group delete --name spnhubrg

Étapes suivantes

  • Last updated on