Sdílet prostřednictvím

Rychlý start: Vytvoření centra oznámení Azure pomocí Azure CLI

  • Článek

Služba Azure Notification Hubs nabízí snadno použitelné, škálovatelné zasílací jádro, které umožňuje posílat oznámení libovolné platformě (iOS, Android, Windows, Kindle, Baidu atd.) z libovolného back-endu (cloudový nebo místní). Další informace o službě najdete v tématu Co je Azure Notification Hubs?.

V tomto rychlém startu vytvoříte centrum oznámení pomocí Azure CLI. V první části najdete postup vytvoření oboru názvů Notification Hubs. Druhá část obsahuje kroky k vytvoření centra oznámení v existujícím oboru názvů. Dozvíte se také, jak vytvořit vlastní zásady přístupu.

Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

Požadavky

  • Použijte prostředí Bash v Azure Cloud Shell. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shell.

  • Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Spuštění Azure CLI v kontejneru Dockeru.

    • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.

    • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

    • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Důležité

Notification Hubs vyžaduje Azure CLI verze 2.0.67 nebo novější. Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Vytvoření skupiny prostředků

Služba Azure Notification Hubs musí být stejně jako všechny prostředky Azure nasazená do skupiny prostředků. Skupiny prostředků vám umožňují organizaci a správu souvisejících prostředků Azure. Další informace o skupinách prostředků najdete v tématu Co je Azure Resource Manager.

Pro účely tohoto rychlého startu vytvořte skupinu prostředků spnhubrg v umístění eastus pomocí následujícího příkazu az group create .

az group create --name spnhubrg --location eastus

Vytvoření oboru názvů Notification Hubs

  1. Vytvořte obor názvů pro vaše centra oznámení.

    Obor názvů obsahuje jedno nebo více center a název musí být jedinečný v rámci všech předplatných Azure a musí mít délku nejméně šest znaků. Pokud chcete zkontrolovat dostupnost názvu, použijte příkaz az notification-hub namespace check-availability .

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

    Azure CLI reaguje na vaši žádost o dostupnost zobrazením následujícího výstupu konzoly:

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

    Všimněte si druhého řádku v odpovědi "isAvailable": trueAzure CLI – . Tento řádek se false přečte, pokud požadovaný název, který jste zadali pro obor názvů, není k dispozici. Jakmile ověříte dostupnost názvu, spuštěním příkazu az notification-hub namespace create vytvořte obor názvů.

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

    --name Pokud příkaz, který jste zadaliaz notification-hub namespace create, není k dispozici nebo nesplňuje pravidla a omezení pojmenování prostředků Azure, Azure CLI odpoví následujícím výstupem konzoly:

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

    Pokud první jméno, které jste vyzkoušeli, není úspěšné, vyberte jiný název nového oboru názvů a spusťte az notification-hub namespace create příkaz znovu.

    Poznámka

    Od tohoto kroku musíte nahradit hodnotu parametru --namespace v každém příkazu Azure CLI, který zkopírujete z tohoto rychlého startu.

  2. Získejte seznam oborů názvů.

    Pokud chcete zobrazit podrobnosti o novém oboru názvů, použijte příkaz az notification-hub namespace list . Parametr --resource-group je volitelný, pokud chcete zobrazit všechny obory názvů pro předplatné.

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

Vytvoření centra oznámení

  1. Vytvořte první centrum oznámení.

    V novém oboru názvů teď můžete vytvořit jedno nebo více center oznámení. Spuštěním příkazu az notification-hub create vytvořte centrum oznámení.

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

  2. Vytvořte druhé centrum oznámení.

    V jednom oboru názvů je možné vytvořit více center oznámení. Pokud chcete ve stejném oboru názvů vytvořit druhé centrum oznámení, spusťte az notification-hub create příkaz znovu s jiným názvem centra.

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

  3. Získejte seznam center oznámení.

    Azure CLI vrací zprávu o úspěchu nebo chybové zprávě s každým spuštěným příkazem. možnost dotazovat se na seznam center oznámení je však ujišťující. K tomuto účelu byl navržen příkaz az notification-hub list .

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

Práce se zásadami přístupu

  1. Azure Notification Hubs používá zabezpečení sdíleného přístupového podpisu prostřednictvím zásad přístupu. Při vytvoření centra oznámení se automaticky vytvoří dvě zásady. Připojovací řetězce z těchto zásad jsou potřeba ke konfiguraci nabízených oznámení. Příkaz az notification-hub authorization-rule list poskytuje seznam názvů zásad a jejich příslušných skupin prostředků.

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

    Důležité

    Nepoužívejte ve své aplikaci zásadu DefaultFullSharedAccessSignature . Tyto zásady se mají používat jenom v back-endu. V klientské aplikaci používejte jenom Listen zásady přístupu.

  2. Pokud chcete vytvořit další autorizační pravidla se smysluplnými názvy, můžete vytvořit a přizpůsobit vlastní zásady přístupu pomocí příkazu az notification-hub authorization-rule create . Parametr --rights je seznam oprávnění, která chcete přiřadit, oddělený mezerami.

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

  3. Pro každou zásadu přístupu existují dvě sady klíčů a připojovacích řetězců. Budete je potřebovat později ke konfiguraci centra oznámení. Pokud chcete zobrazit seznam klíčů a připojovacích řetězců pro zásady přístupu Notification Hubs, použijte příkaz 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

    Poznámka

    Obor názvů Notification Hubs a centrum oznámení mají samostatné zásady přístupu. Ujistěte se, že při dotazování klíčů a připojovacích řetězců používáte správné referenční informace Azure CLI.

Vyčištění prostředků

Pokud už je nepotřebujete, pomocí příkazu az group delete odeberte skupinu prostředků a všechny související prostředky:

az group delete --name spnhubrg

Další kroky