Inicio rápido: Creación de un centro de notificaciones de Azure mediante la CLI de Azure

Azure Notification Hubs proporciona un motor de notificaciones escalable y fácil de usar que permite enviar notificaciones a cualquier plataforma (iOS, Android, Windows, Kindle, Baidu, etc.) desde cualquier backend (nube o local). Para más información sobre el servicio, consulte ¿Qué es Azure Notification Hubs?.

En este inicio rápido, creará un centro de notificaciones mediante la CLI de Azure. En la primera sección se proporcionan pasos para crear un espacio de nombres de Notification Hubs. En la segunda sección se proporcionan pasos para crear un centro de notificaciones en un espacio de nombres existente. También aprenderá a crear una directiva de acceso personalizada.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Prerrequisitos

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.

  

• Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.

  • Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.

  • Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.

Creación de un grupo de recursos

Azure Notification Hubs, como todos los recursos de Azure, se deben implementar en un grupo de recursos. Los grupos de recursos permiten organizar y administrar recursos de Azure relacionados. Consulte ¿Qué es Azure Resource Manager para más información sobre los grupos de recursos?

Para este inicio rápido, cree un grupo de recursos denominado spnhubrg en la ubicación eastus con el siguiente comando az group create .

az group create --name spnhubrg --location eastus

Creación de un espacio de nombres de Notification Hubs

1. Cree un espacio de nombres para los centros de notificaciones.

   Un espacio de nombres contiene uno o varios centros, y el nombre debe ser único en todas las suscripciones de Azure y tener al menos seis caracteres de longitud. Para comprobar la disponibilidad de un nombre, use el comando az notification-hub namespace check-availability .

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

   La CLI de Azure responde a la solicitud de disponibilidad mostrando la siguiente salida de la consola:

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

   Observe la segunda línea en la respuesta de la CLI de Azure, "isAvailable": true. Esta línea muestra false si el nombre deseado que especificó para el espacio de nombres no está disponible. Una vez que haya confirmado la disponibilidad del nombre, ejecute el comando az notification-hub namespace create para crear el espacio de nombres.

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

   Si el --name proporcionado al az notification-hub namespace create comando no está disponible o no cumple las reglas y restricciones de nomenclatura de los recursos de Azure, la CLI de Azure responde con la siguiente salida de consola:

   #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 el primer nombre que probó no tuvo éxito, seleccione otro nombre para el nuevo espacio de nombres y ejecute de nuevo el comando az notification-hub namespace create.

   Nota:

   A partir de este paso, debe reemplazar el valor del parámetro --namespace en cada comando de la CLI de Azure que copie de este inicio rápido.

2. Obtenga una lista de espacios de nombres.

   Para ver los detalles sobre el nuevo espacio de nombres, use el comando az notification-hub namespace list . El parámetro --resource-group es opcional si desea ver todos los espacios de nombres de una suscripción.

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

Creación de centros de notificaciones

1. Cree el primer centro de notificaciones.

   Ahora se pueden crear uno o varios centros de notificaciones en el nuevo espacio de nombres. Ejecute el comando az notification-hub create para crear un centro de notificaciones.

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

2. Cree un segundo centro de notificaciones.

   Se pueden crear varios centros de notificaciones en un solo espacio de nombres. Para crear un segundo centro de notificaciones en el mismo espacio de nombres, vuelva a ejecutar el az notification-hub create comando con un nombre de centro diferente.

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

3. Obtenga una lista de centros de notificaciones.

   La CLI de Azure devuelve un mensaje de éxito o error con cada comando ejecutado; sin embargo, poder consultar una lista de centros de notificación es reconfortante. El comando az notification-hub list se diseñó para este propósito.

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

Trabajar con directivas de acceso

1. Azure Notification Hubs usa la seguridad de firma de acceso compartido mediante el uso de directivas de acceso. Al crear un centro de notificaciones, se crean automáticamente dos directivas. Las cadenas de conexión de estas directivas son necesarias para configurar las notificaciones push. El comando az notification-hub authorization-rule list proporciona una lista de nombres de directiva y sus respectivos grupos de recursos.

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

   Importante

   No use la directiva DefaultFullSharedAccessSignature en la aplicación. Esta directiva está diseñada para usarse solo en el backend. Use solo directivas de acceso Listen en la aplicación cliente.

2. Si desea crear reglas de autorización adicionales con nombres significativos, puede crear y personalizar su propia directiva de acceso mediante el comando az notification-hub authorization-rule create . El --rights parámetro es una lista delimitada por espacios de los permisos que desea asignar.

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

3. Hay dos conjuntos de claves y cadenas de conexión para cada directiva de acceso. Los necesitará más adelante para configurar un centro de notificaciones. Para enumerar las claves y las cadenas de conexión de una directiva de acceso de Notification Hubs, use el comando 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
   

   Nota:

   Un espacio de nombres de Notification Hubs y un centro de notificaciones tienen directivas de acceso independientes. Asegúrese de que usa la referencia correcta de la CLI de Azure al consultar las claves y las cadenas de conexión.

Limpieza de recursos

Cuando ya no sea necesario, use el comando az group delete para quitar el grupo de recursos y todos los recursos relacionados:

az group delete --name spnhubrg

Pasos siguientes

• En este inicio rápido, ha creado un centro de notificaciones. Para obtener información sobre cómo configurar el centro con la configuración del sistema de notificaciones de plataforma (PNS), consulte Configuración de notificaciones push en un centro de notificaciones.

• Descubra las amplias funcionalidades para administrar los centros de notificaciones con la CLI de Azure:

  Lista de referencia completa de Notification Hubs

  Lista de referencias para los espacios de nombres de Notification Hubs

  Lista de referencias de reglas de autorización de Notification Hubs

  Lista de referencia de credenciales de Notification Hubs