Guida introduttiva: Configurare le notifiche push in un hub di notifica

Articolo
12/14/2024

Hub di notifica di Azure offre un motore di push facile da usare e scalabilità orizzontale. 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 V1 (FCMv1)

Per configurare le notifiche push per Google FCMv1:

Nella pagina Hub di notifica della portale di Azure selezionare Google (FCMv1) dal menu a sinistra.
Aggiornare i valori di Chiave privata, ID progetto e Posta elettronica client dal file JSON dell'account del servizio ottenuto dalla console Firebase.
Seleziona Salva.

Screenshot che mostra come configurare Hub di notifica per Google FCMv1.

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

Google Firebase Cloud Messaging (FCM)

Nota

Firebase Cloud Messaging (FCM) è deprecato e non è più supportato.

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.
Seleziona 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 su 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 tramite l'interfaccia della riga di comando di Azure.
- Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. 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.
Seleziona Salva.

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

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.
Seleziona 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:

Condividi tramite

Guida introduttiva: Configurare le notifiche push in un hub di notifica

Apple Push Notification Service

Google Firebase Cloud Messaging V1 (FCMv1)

Google Firebase Cloud Messaging (FCM)

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

Configurare le notifiche push per Google FCM

Servizi notifica Push Windows

Baidu (Android China)

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive