Quickstart: Set up push notifications in a notification hub

Azure Notification Hubs provides a push engine that's easy to use and that scales out. Use Notification Hubs to send notifications to any platform (iOS, Android, Windows, Baidu) and from any back end (cloud or on-premises). For more information, see What is Azure Notification Hubs?.

In this quickstart, you'll use the platform notification system (PNS) settings in Notification Hubs to set up push notifications on multiple platforms. The quickstart shows you the steps to take in the Azure portal. Google Firebase Cloud Messaging includes instructions for using the Azure CLI.

Note

For information about Firebase Cloud Messaging deprecation and migration steps, see Google Firebase Cloud Messaging migration.

If you haven't already created a notification hub, create one now. For more information, see Create an Azure notification hub in the Azure portal or Create an Azure notification hub using the Azure CLI.

Apple Push Notification Service

To set up Apple Push Notification Service (APNS):

1. In the Azure portal, on the Notification Hub page, select Apple (APNS) from the left menu.

2. For Authentication Mode, select either Certificate or Token.

   a. If you select Certificate:

   • Select the file icon, and then select the .p12 file you want to upload.

   • Enter a password.

   • Select Sandbox mode. Or, to send push notifications to users who purchased your app from the store, select Production mode.

     

     b. If you select Token:

   • Enter the values for Key ID, Bundle ID, Team ID, and Token.

   • Select Sandbox mode. Or, to send push notifications to users who purchased your app from the store, select Production mode.

     

For more information, see Send push notifications to iOS apps using Azure Notification Hubs.

Google Firebase Cloud Messaging V1 (FCMv1)

To set up push notifications for Google FCMv1:

1. In the Azure portal, on the Notification Hub page, select Google (FCMv1) from the left menu.
2. Update the Private Key, Project ID, and Client Email values from the service account JSON file obtained from the Firebase Console.
3. Select Save.

When you complete these steps, an alert indicates that the notification hub has been successfully updated. The Save button is disabled.

Google Firebase Cloud Messaging (FCM)

Note

Firebase Cloud Messaging (FCM) has been deprecated and is no longer supported.

Portal

To set up push notifications for Google FCM:

1. In the Azure portal, on the Notification Hub page, select Google (GCM/FCM) from the left menu.

2. Paste the API Key for the Google FCM project that you saved earlier.

3. Select Save.

   

When you complete these steps, an alert indicates that the notification hub has been successfully updated. The Save button is disabled.

Azure CLI

You will need the API Key for your Google Firebase Cloud Messaging (FCM) project.

Prepare your environment for the Azure CLI

• Use the Bash environment in Azure Cloud Shell. For more information, see Quickstart for Bash in Azure Cloud Shell.

  

• If you prefer to run CLI reference commands locally, install the Azure CLI. If you're running on Windows or macOS, consider running Azure CLI in a Docker container. For more information, see How to run the Azure CLI in a Docker container.

  • If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see Sign in with the Azure CLI.

  • When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see Use extensions with the Azure CLI.

  • Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.

• This article requires version 2.0.67 or later of the Azure CLI. If using Azure Cloud Shell, the latest version is already installed.

Set up push notifications for Google FCM

1. Use the az notification-hub credential gcm update command to add your Google API key to your notification hub.

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

2. The Android App needs a connection string to connect with the notification hub. Use the az notification-hub authorization-rule list command to list the available access policies. Use the az notification-hub authorization-rule list-keys command to get the access policy connection strings. Specify the primaryConnectionString or secondaryConnectionString in the --query parameter to get the primary connection string directly.

   #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 the az notification-hub test-send command to test sending messages to the Android App.

   #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\"}}"
   

Get Azure CLI references for other platforms with the az notification-hub credential command.

For more information about sending notifications to an Android application, see Send push notifications to Android devices using Firebase.

Windows Push Notification Service

To set up Windows Push Notification Service (WNS):

1. In the Azure portal, on the Notification Hub page, select Windows (WNS) from the left menu.

2. Enter values for Package SID and Security Key.

3. Select Save.

   

For information, see Send notifications to UWP apps by using Azure Notification Hubs.

Baidu (Android China)

To set up push notifications for Baidu:

1. In the Azure portal, on the Notification Hub page, select Baidu (Android China) from the left menu.

2. Enter the API Key that you obtained from the Baidu console in the Baidu cloud push project.

3. Enter the Secret Key that you obtained from the Baidu console in the Baidu cloud push project.

4. Select Save.

   

When you complete these steps, an alert indicates that the notification hub has been successfully updated. The Save button is disabled.

For more information, see Get started with Notification Hubs by using Baidu.

Next steps

In this quickstart, you learned how to configure platform notification system settings for a notification hub in the Azure portal.

To learn more about how to push notifications to various platforms, see these tutorials:

• Send push notifications to iOS apps using Azure Notification Hubs
• Send notifications to Android devices by using Notification Hubs and Google FCM
• Send notifications to a UWP app running on a Windows device
• Send notifications by using Notification Hubs and Baidu cloud push