Een Azure notification hub maken met behulp van de Azure-CLI

Azure Notification Hubs biedt een eenvoudig te gebruiken en uitgeschaalde push-engine waarmee u vanuit elke back-end (cloud of on-premises) meldingen kunt verzenden naar ieder platform (iOS, Android, Windows, Kindle, Baidu, enzovoort). Zie voor meer informatie over de service Wat is Azure Notification Hubs?.

In deze quickstart maakt u een notification hub met behulp van de Azure-CLI. De eerste sectie bevat de stappen voor het maken van een Notification Hubs-naamruimte. De tweede sectie bevat de stappen voor het maken van een notification hub in een bestaande naamruimte. U leert ook hoe u een aangepast toegangsbeleid kunt maken.

Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.

Vereisten

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

Belangrijk

Voor Notification Hubs is versie 2.0.67 of hoger van de Azure-CLI vereist. 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.

Een resourcegroep maken

Azure Notification Hubs moeten, zoals alle Azure-resources, worden geïmplementeerd in een resourcegroep. Met resourcegroepen kunt u gerelateerde Azure-resources organiseren en beheren. Zie Wat is Azure Resource Manager? voor meer informatie over resourcegroepen.

Maak voor deze quickstart een resourcegroep met de naam spnhubrg op de locatie eastus met behulp van de volgende az group create-opdracht.

az group create --name spnhubrg --location eastus

Een Notification Hubs-naamruimte maken

1. Maak een naamruimte voor uw notification hubs.

   Een naamruimte bevat één of meer hubs, en de naam moet uniek zijn in alle Azure-abonnementen en ten minste zes tekens lang zijn. Gebruik de opdracht az notification-hub namespace check-availability om te controleren of een naam beschikbaar is.

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

   De Azure-CLI beantwoordt uw beschikbaarheidsaanvraag door de volgende console-uitvoer weer te geven:

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

   Let op de tweede regel in het Azure CLI-antwoord: "isAvailable": true. Op deze regel staat false als de gewenste naam die u voor de naamruimte hebt opgegeven, niet beschikbaar is. Zodra u hebt bevestigd dat de naam beschikbaar is, voert u de opdracht az notification-hub namespace create uit om uw naamruimte te maken.

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

   Als de --name die u bij de opdracht az notification-hub namespace create hebt opgegeven, niet beschikbaar is of niet voldoet aan de Naamgevingsregels en -beperkingen voor Azure-resources, antwoordt de Azure-CLI met de volgende console-uitvoer:

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

   Als de eerste naam die u hebt geprobeerd niet lukt, selecteert u een andere naam voor uw nieuwe naamruimte en voert u de opdracht az notification-hub namespace create nogmaals uit.

   Notitie

   Vanaf deze stap moet u de waarde van de parameter --namespace vervangen in elke Azure CLI-opdracht die u kopieert uit deze quickstart.

2. Haal een lijst met naamruimten op.

   Gebruik de opdracht az notification-hub namespace list om de details van uw nieuwe naamruimte te bekijken. De parameter --resource-group is optioneel als u alle naamruimten voor een abonnement wilt zien.

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

Notification hubs maken

1. Maak uw eerste notification hub.

   Er kunnen nu één of meer notification hubs worden gemaakt in uw nieuwe naamruimte. Voer de opdracht az notification-hub create uit om een notification hub te maken.

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

2. Maak een tweede notification hub.

   Er kunnen meerdere notification hubs worden gemaakt in één naamruimte. Als u een tweede notification hub wilt maken in dezelfde naamruimte, voert u de opdracht az notification-hub create nogmaals uit met een andere hubnaam.

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

3. Haal een lijst met notification hubs op.

   Met elke uitgevoerde opdracht retourneert de Azure-CLI een bericht of deze is geslaagd, maar het is geruststellend een lijst met notification hubs te kunnen ophalen. De opdracht az notification-hub list is ontworpen voor dit doeleinde.

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

Werken met toegangsbeleid

1. Azure Notification Hubs maakt gebruik van Shared Access Signature-beveiliging door middel van toegangsbeleid. Er worden automatisch twee soorten beleid gemaakt wanneer u een notification hub maakt. De verbindingsreeksen uit dit beleid zijn nodig om pushmeldingen te configureren. De opdracht az notification-hub authorization-rule list biedt een lijst met beleidsnamen en hun respectieve resourcegroepen.

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

   Belangrijk

   Gebruik niet het beleid DefaultFullSharedAccessSignature in uw toepassing. Dit beleid mag alleen in uw back-end worden gebruikt. Gebruik alleen Listen-toegangsbeleid in uw clienttoepassing.

2. Als u aanvullende autorisatieregels met betekenisvolle namen wilt maken, kunt u uw eigen toegangsbeleid maken en aanpassen door de opdracht az notification-hub authorization-rule create te gebruiken. De parameter --rights is een door spaties gescheiden lijst met de machtigingen die u wilt toewijzen.

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

3. Er zijn twee sets sleutels en verbindingsreeksen voor elk toegangsbeleid. U hebt ze later nodig om een notification hub mee te configureren. Als u de sleutels en verbindingsreeksen wilt weergeven voor een toegangsbeleid voor Notification Hubs, gebruikt u de opdracht 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
   

   Notitie

   Een Notification Hubs-naamruimte en een notification hub hebben elk een ander toegangsbeleid. Zorg ervoor dat u het juiste referentiemateriaal over de Azure-CLI gebruikt wanneer u query’s uitvoert voor sleutels en verbindingsreeksen.

Resources opschonen

Gebruik de opdracht az group delete om de resourcegroep en alle bijbehorende resources te verwijderen wanneer u ze niet meer nodig hebt:

az group delete --name spnhubrg

Volgende stappen

• In deze quickstart hebt u een notification hub gemaakt. Zie Pushmeldingen instellen in een notification hub voor meer informatie over het configureren van de hub met PNS-instellingen (Platform Notification System).

• Ontdek de uitgebreide mogelijkheden voor het beheren van notification hubs met de Azure-CLI:

  Volledige referentielijst voor Notification Hubs

  Referentielijst met Notification Hubs-naamruimten

  Referentielijst met Notification Hubs-autorisatieregels

  Referentielijst met Notification Hubs-referenties