Configurare le notifiche push delle chiamate per Webex BroadWorks
In questo documento, viene utilizzato il termine Server push di notifiche di chiamata (CNPS) per descrivere un'applicazione ospitata da XSP o ospitata ad ADP che viene eseguita nel proprio ambiente. IL CNPS collabora con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti ed invia le notifiche di tali notifiche ai servizi di notifica FCM (Google Firebase Cloud Messaging) o APNs (Apple Push Notification).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks la loro chiamata in arrivo su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzionalità del server push dinotifica.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano, a loro volta, gli utenti Webex mobili dei messaggi in arrivo o delle modifiche alla presenza.
Questa sezione descrive come configurare NPS per il proxy di autenticazione quando NPS non supporta già altre app. Se è necessario migrare un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS.
Panoramica proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, il CNPS deve essere patchto per supportare la funzione proxy NPS, Push Server per le VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, il server NPS utilizza una nuova API per ottenere un token di notifica push breve da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APNs Apple e i servizi Google FCM.
La funzione migliora anche la funzionalità del server push di notifica per eseguire il push delle notifiche sui dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere il Server push per VoIP funzionalità in Descrizione funzionalità UCaaS.
-
Le patch BroadWorks per la funzionalità sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparare NPS per Webex per Cisco BroadWorks.
Cerca e scarica la patch dalla pagina di download del software.
-
Ulteriori informazioni sul server ADP sono disponibili all'indirizzo Cisco BroadWorks Application Delivery Platform.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push Apple dopo il 31 marzo 2021. Ti consigliamo di configurare il tuo XSP|ADP per utilizzare HTTP/2-based interfaccia per APN. Questo aggiornamento richiede che l'XSP|ADP che ospita l'NPS esegua R22 o una versione successiva.
Preparazione del sistema NPS per Webex per Cisco BroadWorks
| 1 |
Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma ADP (Application Delivery Platform). |
| 2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
| 3 |
Attivare l'applicazione server push di notifica. |
| 4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
|
| 5 |
(Per notifiche Apple iOS) Abilitare HTTP/2 su NPS.
Questa funzionalità è esclusiva della versione 22 e delle versioni precedenti; non è disponibile nella versione 23 e successive, che supportano solo HTTP/2. |
| 6 |
Allegare un supporto tecnico da NPS XSP/ADP. |
| 7 |
Su ogni server AS, il file namedefs in Esempio: _pushnotification-cliente._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 Una volta impostate, per applicare le modifiche è necessario uno dei seguenti:
|
Operazioni successive
Per le nuove installazioni di un NPS, vai a Configurare NPS per utilizzare il proxy di autenticazione
Per migrare una distribuzione Android esistente a FCMv1, vai a Migrazione di NPS a FCMv1
Configurare NPS per utilizzare il proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicato a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per l'utilizzo del proxy NPS.
| 1 |
Ottenimento delle credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
| 2 |
Creare l'account client su NPS:
Per verificare che i valori immessi corrispondano a quanto fornito, eseguire L'indirizzo CiscoCI issuerUrl dovrebbe SEMPRE essere il cluster US CI, indipendentemente dalla posizione, e l'impostazione predefinita dovrebbe essere:
| |||||||||||||||||||
| 3 |
Inserire l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (è consigliato 30 minuti):
Per migliorare la velocità di risoluzione DNS, invece dell'attuale FQDN nps.uc-one.broadsoft.com ti consigliamo di utilizzare l'FQDN appropriato in base alla tua regione. FQDN basati sulla regione: USA Est: Stati Uniti occidentali:
Europa:
Se le notifiche push scadono a causa di un ritardo nella risoluzione DNS, aumentare il valore di timeout in "/etc/resolv.conf" file sul server BroadWorks. | |||||||||||||||||||
| 4 |
(Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
| 5 |
(Per notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, facendo in modo di omettere la chiave di autenticazione, impostarlo come vuoto.
| |||||||||||||||||||
| 6 |
Configurare i seguenti URL NPS:
| |||||||||||||||||||
| 7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati riportati:
| |||||||||||||||||||
| 8 |
Controllare se il server dell'applicazione è un ID applicazione elettronica, poiché potrebbe essere necessario aggiungere le app Webex all'elenco dei consentiti: | |||||||||||||||||||
| 9 |
Riavviare l'XSP|ADP: | |||||||||||||||||||
| 10 |
Testare le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verifica che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS in FCMv1
Questo argomento contiene le procedure opzionali che è possibile utilizzare nella console FCM di Google quando si dispone di una distribuzione NPS esistente che occorre eseguire la migrazione a FCMv1. Sono disponibili tre procedure:
-
Migrare i client UC-One a FCMv1—Quando si hanno client UCaaS esistenti e si ha bisogno di migrarli per utilizzare FCMv1.
-
Migrazione dei client SaaS a FCMv1—Quando si hanno client SaaS esistenti e si ha bisogno di migrarli per utilizzare FCMv1.
-
Aggiorna server ADP—Quando si esegue la migrazione dell'NPS su un server ADP.
Migrazione dei client UC-One a FCMv1
Per migrare i client UC-One a Google FCM HTTPv1, utilizzare i passaggi indicati di seguito nella console di Google FCM.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere Impostazioni progetto > . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.
Per maggiori dettagli, consulta la Guida al branding di Connect Mobile all'indirizzo https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al parametro gcm_defaultSenderId, che si trova nel Branding Kit, cartella Risorse, file branding.xml con la seguente sintassi:
xxxxxxxxxxxxx
-
Accedere all'SDK di amministrazione FCM su http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID progetto
-
Passare alla scheda degli account di servizio per configurare un account di servizio. È possibile creare un nuovo account di servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
-
Fare clic sul pulsante blu per creare un nuovo account di servizio
-
Fare clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione protetta
Per riutilizzare un account di servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
-
Identificare l'account del servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione protetta.
-
-
Copiare il file json sull'ADP XSP|.
-
Configurare ID progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add -
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add projectId ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project -
Abilitare FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Eseguire il comando
bwrestartper riavviare l'ADP XSP|.
Migrare i client SaaS in FCMv1
Utilizzare le operazioni seguenti su Google FCM Console se si desidera migrare i client SaaS a FCMv1.
Accertarsi di aver già completato la procedura "Configurazione di NPS per l'uso del proxy di autenticazione".
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Eseguire il comando
bwrestartper riavviare l'ADP XSP|. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Eseguire il comando
bwrestartper riavviare l'ADP XSP|.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta migrando il server NPS per l'uso di un server ADP.
-
Ottenere il file JSON dalla console di Google Cloud:
-
Nella console di Google Cloud, andare alla pagina Account di servizio.
-
Fare clic su Seleziona un progetto , scegliere il progetto e fare clic su Apri .
-
Trova la riga dell'account di servizio per cui vuoi creare una chiave, fai clic sul pulsante verticale Altro, quindi fai clic su Crea chiave.
-
Selezionare un tipo di chiavee fare clic su Crea
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON sul server ADP utilizzando il comando
/bw/install. -
Accedere alla CLI ADP e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
Successivamente, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
-