Inicio rápido: Configuración de notificaciones push en un centro de notificaciones

Azure Notification Hubs proporciona un motor de inserción que es fácil de usar y que se escala horizontalmente. Use Notification Hubs para enviar notificaciones a cualquier plataforma (iOS, Android, Windows, Baidu), desde cualquier back-end (en la nube o local). Para más información, consulte ¿Qué es Azure Notification Hubs?.

En este inicio rápido, se usará la configuración del sistema de notificación de plataforma (PNS) en Notification Hubs para configurar las notificaciones push en varias plataformas. El inicio rápido muestra los pasos a seguir en Azure Portal. Google Firebase Cloud Messaging incluye instrucciones sobre el uso de la CLI de Azure.

Nota:

Para obtener información sobre los pasos de desuso y migración de Firebase Cloud Messaging, consulte Migración de Google Firebase Cloud Messaging.

Si aún no ha creado un centro de notificaciones, cree uno ahora. Para más información, consulte Creación de un centro de notificaciones de Azure en Azure Portal o Creación de un centro de notificaciones de Azure mediante la CLI de Azure.

Apple Push Notification Service

Para configurar Apple Push Notification Service (APNS):

1. En Azure Portal, en la página Centro de notificaciones, seleccione Apple (APNS) en el menú izquierdo.

2. Para Modo de autenticación, seleccione Certificado o Token.

   a. Si ha seleccionado Certificado:

   • Seleccione el icono de archivo, y luego el archivo .p12 que desea cargar.

   • Escriba una contraseña.

   • Seleccione el modo Espacio aislado. O para enviar notificaciones push a los usuarios que compraron la aplicación en la tienda, seleccione el modo Producción.

     

     b. Si selecciona Token:

   • Especifique los valores Id. de clave, Id. de agrupación, Id. de equipo y Token.

   • Seleccione el modo Espacio aislado. O para enviar notificaciones push a los usuarios que compraron la aplicación en la tienda, seleccione el modo Producción.

     

Para más información, consulte Envío de notificaciones push a aplicaciones iOS mediante Azure Notification Hubs.

Google Firebase Cloud Messaging V1 (FCMv1)

Para configurar las notificaciones de inserción para Google FCMv1:

1. En Azure Portal, en la página Centro de notificaciones, seleccione Google (FCMv1) en el menú izquierdo.
2. Actualice los valores de Clave privada, Id. de proyecto y Correo electrónico del cliente del archivo JSON de la cuenta de servicio que se obtuvo de la consola de Firebase.
3. Seleccione Guardar.

Cuando haya completado estos pasos, una alerta le indica que el centro de notificaciones se ha actualizado correctamente. El botón Save (Guardar) está deshabilitado.

Google Firebase Cloud Messaging (FCM)

Nota:

Firebase Cloud Messaging (FCM) ha quedado en desuso y ya no se admite.

Portal

Para configurar las notificaciones push para Google FCM:

1. En Azure Portal, en la página Centro de notificaciones, seleccione Google (GCM/FCM) en el menú izquierdo.

2. Pegue la clave de API del proyecto de Google FCM que guardó anteriormente.

3. Seleccione Guardar.

   

Cuando haya completado estos pasos, una alerta le indica que el centro de notificaciones se ha actualizado correctamente. El botón Save (Guardar) está deshabilitado.

CLI de Azure

Necesitará la clave de API del proyecto de Google Firebase Cloud Messaging (FCM).

Preparación del entorno para la CLI de Azure

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante 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 Inicio de sesión con 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 más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

• En este artículo se necesita la versión 2.0.67 de la CLI de Azure, o cualquier versión posterior. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.

Configuración de notificaciones push para Google FCM

1. Use el comando az notification-hub credential gcm update para agregar la clave de API de Google al centro de notificaciones.

   az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
   

2. La aplicación Android necesita una cadena de conexión para conectar con el centro de notificaciones. Use el comando az notification-hub authorization-rule list para enumerar las directivas de acceso disponibles. Use el comando az notification-hub authorization-rule list-keys para obtener las cadenas de conexión de la directiva de acceso. Especifique el valor de primaryConnectionString o secondaryConnectionString en el parámetro --query para obtener la cadena de conexión principal directamente.

   #list access policies for a notification hub
   az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
   
   #list keys and connection strings for a notification hub access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json
   
   #get the primaryConnectionString for an access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
   

3. Use el comando az notification-hub test-send para probar el envío de mensajes a la aplicación Android.

   #test with message body
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"
   
   #test with JSON string
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"
   

Obtenga referencias de la CLI de Azure para otras plataformas con el comando az notification-hub credential.

Para más información sobre el envío de notificaciones a una aplicación Android, consulte Envío de notificaciones push a dispositivos Android mediante Firebase.

Servicios de notificaciones de inserción de Windows

Para configurar Servicios de notificaciones de inserción de Windows (WNS):

1. En Azure Portal, en la página Centro de notificaciones, seleccione Windows (WNS) en el menú izquierdo.

2. Especifique los valores de SID de paquete y Clave de seguridad.

3. Seleccione Guardar.

   

Para más información, consulte Envío de notificaciones a aplicaciones de Plataforma universal de Windows mediante Azure Notification Hubs.

Baidu (Android China)

Para configurar las notificaciones push para Baidu:

1. En Azure Portal, en la página Centro de notificaciones, seleccione Baidu (Android China) en el menú izquierdo.

2. Escriba la clave de API que ha obtenido en la consola de Baidu en el proyecto Baidu Cloud Push.

3. Escriba la clave secreta que ha obtenido en la consola de Baidu, en el proyecto Baidu Cloud Push.

4. Seleccione Guardar.

   

Cuando haya completado estos pasos, una alerta le indica que el centro de notificaciones se ha actualizado correctamente. El botón Save (Guardar) está deshabilitado.

Para más información, consulte Introducción a Notification Hubs con Baidu.

Pasos siguientes

En este inicio rápido, ha aprendido cómo configurar los valores para los sistemas de notificaciones de distintas plataformas para un centro de notificaciones en Azure Portal.

Para más información acerca de cómo enviar notificaciones push a varias plataformas, consulte estos tutoriales:

• Envío de notificaciones push a aplicaciones iOS mediante Azure Notification Hubs
• Envío de notificaciones a dispositivos Android mediante Notification Hubs y Google FCM
• Envío de notificaciones a una aplicación de UWP que se ejecuta en un dispositivo Windows
• Envío de notificaciones mediante Notification Hubs y Baidu Cloud Push