Avvio rapido: Configurare notifiche push in un hub di notifica

Articolo
08/15/2023

Hub di notifica di Azure offre un motore di push facile da usare e di cui è possibile aumentare il numero di istanze. Usare Hub di notifica per inviare notifiche a qualsiasi piattaforma (iOS, Android, Windows, Baidu) e da qualsiasi back-end (cloud o locale). Per altre informazioni, vedere Informazioni su Hub di notifica di Azure.

In questo argomento di avvio rapido si useranno le impostazioni Platform Notification System (PNS) in Hub di notifica per configurare le notifiche push su più piattaforme. Questo argomento di avvio rapido illustra i passaggi da eseguire nel portale di Azure. Google Firebase Cloud Messaging include le istruzioni per l'uso dell'interfaccia della riga di comando di Azure.

Nota

Per informazioni sui passaggi di deprecazione e migrazione di Firebase Cloud Messaging, vedere Migrazione di Google Firebase Cloud Messaging.

Se non è stato già creato un hub di notifica, crearne uno ora. Per altre informazioni, vedere Creare un hub di notifica di Azure nel portale di Azure o Creare un hub di notifica di Azure con l'interfaccia della riga di comando di Azure.

Apple Push Notification Service

Per configurare Apple Push Notification Service (APNS):

Nella pagina Hub di notifica del portale di Azure, selezionare Apple (APNS) nel menu a sinistra.
Per Modalità di autenticazione selezionare Certificato oppure Token.

a. Se si seleziona Certificato:
- Selezionare l'icona del file e quindi il file con estensione p12 da caricare.
- Immettere una password.
- Selezionare la modalità Sandbox. In alternativa, se si vogliono inviare notifiche push agli utenti che hanno acquistato l'app dallo Store, selezionare la modalità Produzione.
b. Se si seleziona Token:
- Immettere i valori per ID chiave, ID bundle, ID team e Token.
- Selezionare la modalità Sandbox. In alternativa, se si vogliono inviare notifiche push agli utenti che hanno acquistato l'app dallo Store, selezionare la modalità Produzione.

Per altre informazioni, vedere Inviare notifiche push alle app iOS con Hub di notifica di Azure.

Google Firebase Cloud Messaging (FCM)

Portale
Interfaccia della riga di comando di Azure

Per configurare le notifiche push per Google FCM:

Nella pagina Hub di notifica del portale di Azure, selezionare Google (GCM/FCM) nel menu a sinistra.
Incollare il valore di Chiave API per il progetto Google FCM salvato in precedenza.
Selezionare Salva.

Dopo aver completato questi passaggi, un avviso indica che l'hub di notifica è stata aggiornato correttamente. Il pulsante Save (Salva) è disabilitato.

Sarà necessaria la Chiave API per il progetto Google Firebase Cloud Messaging (FCM).

Preparare l'ambiente per l'interfaccia della riga di comando di Azure

Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
- Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
- Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
- Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

Questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.0.67 o successiva. Se si usa Azure Cloud Shell, la versione più recente è già installata.

Configurare le notifiche push per Google FCM

Usare il comando az notification-hub credential gcm update per aggiungere la chiave dell'API Google all'hub di notifica.

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

L'app Android necessita di una stringa di connessione per connettersi all'hub di notifica. Usare il comando az notification-hub authorization-rule list per elencare i criteri di accesso disponibili. Usare il comando az notification-hub authorization-rule list-keys per ottenere le stringhe di connessione dei criteri di accesso. Specificare il primaryConnectionString o secondaryConnectionString nel parametro --query per ottenere direttamente la stringa di connessione primaria.

#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

Usare il comando az notification-hub test-send per testare l'invio di messaggi all'app 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\"}}"

Ottenere i riferimenti all'interfaccia della riga di comando di Azure per altre piattaforme con il comando az notification-hub credential.

Per altre informazioni sull'invio di notifiche a un'applicazione Android, vedere Inviare notifiche push ai dispositivi Android con Firebase.

Servizi notifica Push Windows

Per configurare Servizi notifica Push Windows (WNS):

Nella pagina Hub di notifica del portale di Azure, selezionare Windows (WNS) nel menu a sinistra.
Immettere i valori per SID pacchetto e Chiave di sicurezza.
Selezionare Salva.

Per informazioni, vedere Inviare notifiche alle app della piattaforma UWP con Hub di notifica di Azure.

Servizio notifica push Microsoft per Windows Phone

Nota

Microsoft Push Notification Service (MPNS) è stato deprecato e non è più supportato.

Per configurare Servizio notifica push Microsoft (MPNS) per Windows Phone:

Nella pagina Hub di notifica del portale di Azure, selezionare Windows Phone (MPNS) nel menu a sinistra.
Abilitare le notifiche push non autenticate o autenticate:

a. Per abilitare le notifiche push non autenticate, selezionare Abilita notifiche push non autenticate>Salva.

b. Per abilitare le notifiche push autenticate:
- Selezionare Carica certificato sulla barra degli strumenti.
- Selezionare l'icona del file e quindi il file del certificato.
- Immettere la password per il certificato.
- Selezionare OK.
- Nella pagina Windows Phone(MPNS) selezionare Salva.

Per altre informazioni, vedere Effettuare il push di notifiche alle app Windows Phone con Hub di notifica.

Baidu (Android China)

Per configurare le notifiche push per Baidu:

Nella pagina Hub di notifica del portale di Azure, selezionare Baidu (Android China) nel menu a sinistra.
Immettere il valore di Chiave API ottenuto dalla console di Baidu nel progetto push cloud Baidu.
Immettere il valore Chiave privata ottenuto dalla console di Baidu nel progetto push cloud Baidu.
Selezionare Salva.

Dopo aver completato questi passaggi, un avviso indica che l'hub di notifica è stata aggiornato correttamente. Il pulsante Save (Salva) è disabilitato.

Per altre informazioni, vedere Introduzione ad Hub di notifica tramite Baidu.

Passaggi successivi

In questo argomento di avvio rapido è stato illustrato come configurare le impostazioni Platform Notification System per un hub di notifica nel portale di Azure.

Per altre informazioni su come effettuare il push di notifiche a diverse piattaforme, vedere queste esercitazioni: