Merge pull request #299198 from sethmanheim/nhfresh5-1

Freshness pass on top PV ANH articles

Author: denrea

articles/notification-hubs/android-sdk.md

@@ -7,15 +7,14 @@ manager: lizross
 ms.service: azure-notification-hubs
 ms.tgt_pltfrm: mobile-multiple
 ms.topic: article
-ms.date: 03/19/2024
+ms.date: 05/01/2025
 ms.author: sethm
-ms.reviewer: heathertian
-ms.lastreviewed: 03/19/2024
+
 ---
 
 # Web push notifications with Azure Notification Hubs
 
-This article describes how to send browser push notifications to single users through Azure Notification Hubs.
+This article describes how to send browser push notifications to single users using Azure Notification Hubs.
 
 At a high level, the process is:
 
@@ -24,18 +23,18 @@ At a high level, the process is:
    - [Using the REST API](#set-credentials-using-rest-api)
    - [Using the Azure SDKs](#set-credentials-using-azure-sdks)
 
-2. [Create registrations and installations](#create-registrations-and-installations).
+1. [Create registrations and installations](#create-registrations-and-installations).
 
-3. [Send push notifications](#send-push-notifications):
+1. [Send push notifications](#send-push-notifications):
    - [Direct sends](#create-direct-sends)
    - [Batch (audience) sends](#create-audience-sends)
    - [Debug/test sends](#create-debugtest-sends)
 
 ## Overview
 
-Web push (or browser push) is a type of notification that customers get on their desktop browsers, or in some cases mobile browsers, on a per-website basis.  
+Web push (or *browser push*) is a type of notification that customers get on their desktop browsers, or in some cases mobile browsers, on a per-website basis.  
 
-Azure Notification Hubs now supports [*browser push*](https://developers.google.com/web/ilt/pwa/introduction-to-push-notifications) for all major browsers, including Microsoft Edge, Google Chrome, and Mozilla Firefox. Apple Safari isn't included. For Apple Safari, you can use existing APNS support as described in [Configuring Safari Push Notifications](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/NotificationProgrammingGuideForWebsites/PushNotifications/PushNotifications.html#//apple_ref/doc/uid/TP40013225-CH3-SW1), with certificate-based authentication.
+Azure Notification Hubs now supports [browser push](https://developers.google.com/web/ilt/pwa/introduction-to-push-notifications) for all major browsers, including Microsoft Edge, Google Chrome, and Mozilla Firefox. Apple Safari isn't included. For Apple Safari, you can use existing APNS support as described in [Configure Safari push notifications](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/NotificationProgrammingGuideForWebsites/PushNotifications/PushNotifications.html#//apple_ref/doc/uid/TP40013225-CH3-SW1), with certificate-based authentication.
 
 Browser push is supported across platforms on devices with the following operating systems and browsers.
 
@@ -64,7 +63,7 @@ Browser push support on mobile devices:
 
 ## Set credentials
 
-To subscribe to browser push notifications on your web site, you can use VAPID keys. You can generate VAPID credentials by using services such as the [VAPID key generator](https://www.attheminute.com/vapid-key-generator/). The credentials should look similar to the following:
+To subscribe to browser push notifications on your web site, you can use *VAPID* keys. You can generate VAPID credentials by using services such as the [VAPID key generator](https://www.attheminute.com/vapid-key-generator/). The credentials should look similar to the following example:
 
 ```json
 { 
@@ -89,13 +88,12 @@ To set browser push credentials in the Azure portal, follow these steps:
 
    [![Screenshot showing the Browser (Web Push) blade in Notification Hubs.](media/browser-push/notification-hubs-browser-web-push.png)](media/browser-push/notification-hubs-browser-web-push.png#lightbox)
 
-1. Enter your existing VAPID keys, or generate a new VAPID key pair using a service such as the [VAPID Key Generator](https://www.attheminute.com/vapid-key-generator/).
-
+1. Enter your existing VAPID keys, or generate a new VAPID key pair using a service such as the [VAPID key generator](https://www.attheminute.com/vapid-key-generator/).
 1. Select **Save**.
 
 ### Set credentials using REST API
 
-You can also set the browser credentials for browser push by using the REST API, such as using the [Create Or Update Hub REST API](/rest/api/notificationhubs/notification-hubs/create-or-update) method, the Azure Resource Manager API, or the V2 RP.
+You can also set the browser credentials for browser push by using the REST API, such as using the [Create or update Hub REST API](/rest/api/notificationhubs/notification-hubs/create-or-update) method, the Azure Resource Manager API, or the V2 RP.
 
 Enter the credentials in this format, providing the subscription ID, resource group, namespace, and notification hub:
 
@@ -105,7 +103,7 @@ https://management.azure.com/subscriptions/{subcription}/resourceGroups/{resourc
 
 ### Set credentials using Azure SDKs
 
-You can set the credentials for Browser Push using the Azure SDKs. Here's an example using the .NET SDK:
+You can set the credentials for browser push using the Azure SDKs. Here's an example using the .NET SDK:
 
 ```csharp
 var browserCreds = new BrowserCredential 
@@ -207,7 +205,7 @@ After you [set credentials for browser push](#set-credentials) and [create regis
 
 ### Create direct sends
 
-For a direct send, you'll need the endpoint URI, p25DH key, and auth secret from a browser subscription. For more information about direct send notifications, see [Direct send](/rest/api/notificationhubs/direct-send).
+For a direct send, you need the endpoint URI, p25DH key, and auth secret from a browser subscription. For more information about direct send notifications, see [Direct send](/rest/api/notificationhubs/direct-send).
 
 To create a direct send notification, follow these steps:
 
@@ -265,11 +263,8 @@ After you [create registrations for the devices](#create-registrations-and-insta
    [![Screenshot showing the Test Send blade in a notification hub, for sending a test/debug notification.](media/browser-push/notification-hubs-test-send.png)](media/browser-push/notification-hubs-test-send.png#lightbox)
 
 1. In the **Platform** field, select **Browser**.
-
 1. Specify **Send to Tag Expression**.
-
 1. Modify **Payload** to your desired message.
-
 1. Select **Send**.
 
 ## Next steps  

articles/notification-hubs/browser-push.md

@@ -6,23 +6,21 @@ author: sethmanheim
 manager: lizross
 ms.service: azure-notification-hubs
 ms.topic: quickstart
-ms.date: 06/30/2023
+ms.date: 05/01/2025
 ms.author: sethm
-ms.reviewer: thsomasu
-ms.lastreviewed: 02/14/2019
 ms.custom: mode-ui, devx-track-azurecli
 ---
 
 # 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?](notification-hubs-push-notification-overview.md).
+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) and from any back end (cloud or on-premises). For more information, see [What is Azure Notification Hubs?](notification-hubs-push-notification-overview.md).
 
-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](?tabs=azure-cli#google-firebase-cloud-messaging-fcm) includes instructions for using the Azure CLI.
+In this quickstart, you 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 when you use the Azure portal. [Google Firebase Cloud Messaging](?tabs=azure-cli#google-firebase-cloud-messaging-fcm) includes instructions for using the Azure CLI.
 
 > [!NOTE]
 > For information about Firebase Cloud Messaging deprecation and migration steps, see [Google Firebase Cloud Messaging migration](notification-hubs-gcm-to-fcm.md).
 
-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](create-notification-hub-portal.md) or [Create an Azure notification hub using the Azure CLI](create-notification-hub-azure-cli.md).
+If you didn't already create a notification hub, create one now. For more information, see [Create an Azure notification hub in the Azure portal](create-notification-hub-portal.md) or [Create an Azure notification hub using the Azure CLI](create-notification-hub-azure-cli.md).
 
 ## Apple Push Notification Service
 
@@ -32,35 +30,31 @@ To set up Apple Push Notification Service (APNS):
 
 1. 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.
-   
-     ![Screenshot of an APNS certificate configuration in the Azure portal.](media/configure-notification-hub-portal-pns-settings/notification-hubs-apple-config-cert.png)
-     
-     
-     
-     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.
-   
-     ![Screenshot of an APNS token configuration in the Azure portal.](media/configure-notification-hub-portal-pns-settings/notification-hubs-apple-config-token.png)
-     
-     
-     
+   1. 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.
+
+      ![Screenshot of an APNS certificate configuration in the Azure portal.](media/configure-notification-hub-portal-pns-settings/notification-hubs-apple-config-cert.png)
+
+   1. 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.
+
+      ![Screenshot of an APNS token configuration in the Azure portal.](media/configure-notification-hub-portal-pns-settings/notification-hubs-apple-config-token.png)
+
 For more information, see [Send push notifications to iOS apps using Azure Notification Hubs](ios-sdk-get-started.md).
 
 ## 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.
+1. Update the **Private Key**, **Project ID**, and **Client Email** values from the service account JSON file obtained from the Firebase Console.
 1. Select **Save**.
 
-
 ![Screenshot that shows how to configure Notification Hubs for Google FCMv1.](media/configure-notification-hub-portal-pns-settings/fcm-v1-key.png)
 
 When you complete these steps, an alert indicates that the notification hub has been successfully updated. The **Save** button is disabled.
@@ -70,37 +64,35 @@ When you complete these steps, an alert indicates that the notification hub has
 > [!NOTE]
 > Firebase Cloud Messaging (FCM) has been deprecated and is no longer supported.
 
-# [Portal](#tab/azure-portal)
+### [Portal](#tab/azure-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.
+1. Paste the **API Key** for the Google FCM project that you saved earlier.
 1. Select **Save**.
 
    ![Screenshot that shows how to configure Notification Hubs for Google FCM.](media/configure-notification-hub-portal-pns-settings/fcm-server-key.png)
-   
-   
-   
+
 When you complete these steps, an alert indicates that the notification hub has been successfully updated. The **Save** button is disabled.
 
-# [Azure CLI](#tab/azure-cli)
+### [Azure CLI](#tab/azure-cli)
 
-You will need the **API Key** for your Google Firebase Cloud Messaging (FCM) project.
+You need the **API Key** for your Google Firebase Cloud Messaging (FCM) project.
 
 [!INCLUDE [azure-cli-prepare-your-environment.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-h3.md)]
 
-- This article requires version 2.0.67 or later of the Azure CLI. If using Azure Cloud Shell, the latest version is already installed.
+* This article requires version 2.0.67 or later of the Azure CLI. If you use Azure Cloud Shell, the latest version is already installed.
 
-### Set up push notifications for Google FCM
+## Set up push notifications for Google FCM
 
 1. Use the [az notification-hub credential gcm update](/cli/azure/notification-hub/credential/gcm#az-notification-hub-credential-gcm-update) command to add your Google API key to your notification hub.
 
    ```azurecli
    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](/cli/azure/notification-hub/authorization-rule#az-notification-hub-authorization-rule-list) command to list the available access policies.  Use the [az notification-hub authorization-rule list-keys](/cli/azure/notification-hub/authorization-rule#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.
+1. The Android App needs a connection string to connect with the notification hub.  Use the [az notification-hub authorization-rule list](/cli/azure/notification-hub/authorization-rule#az-notification-hub-authorization-rule-list) command to list the available access policies.  Use the [az notification-hub authorization-rule list-keys](/cli/azure/notification-hub/authorization-rule#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.
 
    ```azurecli
    #list access policies for a notification hub
@@ -113,7 +105,7 @@ You will need the **API Key** for your Google Firebase Cloud Messaging (FCM) pro
    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](/cli/azure/notification-hub#az-notification-hub-test-send) command to test sending messages to the Android App.
+1. Use the [az notification-hub test-send](/cli/azure/notification-hub#az-notification-hub-test-send) command to test sending messages to the Android App.
 
    ```azurecli
    #test with message body
@@ -123,7 +115,7 @@ You will need the **API Key** for your Google Firebase Cloud Messaging (FCM) pro
    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](/cli/azure/notification-hub/credential) command.
+You can get Azure CLI references for other platforms with the [az notification-hub credential](/cli/azure/notification-hub/credential) command.
 
 For more information about sending notifications to an Android application, see [Send push notifications to Android devices using Firebase](notification-hubs-android-push-notification-google-fcm-get-started.md).
 
@@ -134,29 +126,14 @@ For more information about sending notifications to an Android application, see
 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**.
+1. Enter values for **Package SID** and **Security Key**.
 1. Select **Save**.
 
    ![Screenshot that shows the Package SID and Security Key boxes.](media/configure-notification-hub-portal-pns-settings/notification-hub-configure-wns.png)
-   
-   
-   
-For information, see [Send notifications to UWP apps by using Azure Notification Hubs](notification-hubs-windows-store-dotnet-get-started-wns-push-notification.md).
-
-## 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.
-1. Select **Save**.
+For information, see [Send notifications to UWP apps by using Azure Notification Hubs](notification-hubs-windows-store-dotnet-get-started-wns-push-notification.md).
 
-   ![Screenshot of Notification Hubs that shows the Baidu (Android China) configuration for push notifications.](media/configure-notification-hub-portal-pns-settings/azure-notification-services-baidu.png)
-   
-    
-   
-When you complete these steps, an alert indicates that the notification hub has been successfully updated. The **Save** button is disabled.
+When you complete these steps, an alert indicates that the notification hub was successfully updated. The **Save** button is disabled.
 
 For more information, see [Get started with Notification Hubs by using Baidu](notification-hubs-baidu-china-android-notifications-get-started.md).
 
@@ -170,4 +147,3 @@ To learn more about how to push notifications to various platforms, see these tu
 * [Send notifications to Android devices by using Notification Hubs and Google FCM](notification-hubs-android-push-notification-google-fcm-get-started.md)
 * [Send notifications to a UWP app running on a Windows device](notification-hubs-windows-store-dotnet-get-started-wns-push-notification.md)
 * [Send notifications by using Notification Hubs and Baidu cloud push](notification-hubs-baidu-china-android-notifications-get-started.md)
-

articles/notification-hubs/configure-notification-hub-portal-pns-settings.md

@@ -1,12 +1,12 @@
 ---
-title: Create an Azure notification hub using the Azure portal | Microsoft Docs
-description: In this tutorial, you learn how to create an Azure notification hub by using the Azure portal.
+title: Create an Azure notification hub using the Azure portal
+description: Learn how to create an Azure notification hub using the Azure portal.
 services: notification-hubs
 author: sethmanheim
 ms.author: sethm
 manager: lizross
 ms.reviewer: rebpen
-ms.date: 02/21/2024
+ms.date: 05/01/2025
 ms.topic: quickstart
 ms.service: azure-notification-hubs
 ms.custom: mode-ui