Konfigurera push-meddelanden för samtal för Webex BroadWorks

I detta dokument använder vi termen Call Notifications Push Server (CNPS) för att beskriva ett XSP-värdat eller ADP-värdprogram som körs i din miljö. Ditt CNPS-system samarbetar med BroadWorks-systemet för att vara medveten om inkommande samtal till dina användare och skickar meddelanden om sådana till aviseringstjänsterna Google Firebase Cloud Messaging (FCM) eller Apple Push Notification Service (APN).

Dessa tjänster meddelar mobilenheterna för Webex-prenumeranter på Cisco BroadWorks att de har inkommande samtal på Webex.

Mer information om NPS finns i beskrivningen av aviseringspush-server.

Ett liknande sätt i Webex fungerar med Webex-meddelande- och närvarotjänster för att skicka meddelanden till aviseringstjänsterna Google (FCM) eller Apple (APNS). Dessa tjänster meddelar i sin tur de mobila Webex-användarna om inkommande meddelanden eller närvaroändringar.

Det här avsnittet beskriver hur du konfigurerar NPS för autentiseringsproxy när NPS inte redan stöder andra appar. Om du behöver migrera en delad NPS för att använda NPS-proxy, se Uppdatera Cisco BroadWorks NPS för att använda NPS-proxy.

NPS-proxy, översikt

För att vara kompatibel med Webex för Cisco BroadWorks måste CNPS korrigeras för att stödja NPS-proxyfunktionen, push-server för VoIP i UCaaS.

Funktionen implementerar en ny design i Aviserings push-servern för att lösa säkerhetsrisken för delning av certifikat för push-meddelande med privata nycklar med tjänsteleverantörer för mobilklienter. I stället för att dela push-aviseringscertifikat och -nycklar med tjänsteleverantören använder NPS en ny API för att få en token med kort fördröjning av push-avisering från Webex för Cisco BroadWorks-backend, och använder denna token för autentisering med Apple APN:er och Google FCM-tjänster.

Funktionen förbättrar också möjligheten för push-servern för meddelanden att skicka meddelanden till Android-enheter via google Firebase Cloud Messaging (FCM) HTTPv1 API.

Mer information finns i Push-servern för VoIP i UCaaS-beskrivning.
BroadWorks-patcharna för funktionen finns tillgängliga på: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.

För NPS-programvara och patchar, se avsnittet Förbered din NPS för Webex för Cisco BroadWorks.

Sök och ladda ner patchen från programvarans nedladdningssida.
Mer information om ADP-servern finns på Cisco BroadWorks Application Delivery Platform.

Överväganden vid APNS

Apple kommer inte längre att ha stöd för HTTP/1-baserat binär protokoll på Apple Push Notification-tjänsten efter den 31 mars 2021. Vi rekommenderar att du konfigurerar din XSP|ADP för att använda HTTP/2-based gränssnitt för APN:er. Den här uppdateringen kräver att din XSP|ADP som värdar NPS kör R22 eller senare.

Förbered NPS för Webex för Cisco BroadWorks

1	Installera och konfigurera en dedikerad XSP (lägsta version R22) eller en programleveransplattform (ADP).
2	Installera programfixar för NPS-autentiseringsproxy: XSP R22-programfixar: AP.xsp.22.0.1123.ap369607 AP.platform.22.0.1123.ap369607 AP.xsp.22.0.1123.ap374677 AP.xsp.22.0.1123.ap375206 AP.xsp.22.0.1123.ap354313 AP.platform.22.0.1123.ap354313 XSP R23-programfixar: AP.xsp.23.0.1075.ap369607 AP.platform.23.0.1075.ap369607 AP.xsp.23.0.1075.ap374677 AP.xsp.23.0.1075.ap375206
3	Aktivera programmet för aviserings push-server.
4	(För Android-aviseringar) Aktivera FCM v1 API på NPS. `XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true`
5	(För Apple iOS-aviseringar) Aktivera HTTP/2 på NPS. `XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true` Detta är exklusivt för version 22 och tidigare versioner; det är inte tillgängligt i version 23 och senare, som endast stöder HTTP/2.
6	Bifoga ett tekniskt stöd från NPS XSP/ADP.
7	På varje AS-server måste namedefs-filen i `/usr/local/broadworks/bw_base/conf` konfigureras med SRV- och A-poster för Notification Push Server (XSP/ADP) sökning, om flera XSP/ADP lägg sedan till en post för varje efter behov. Exempel: _pushnotification-klient._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 När ändringarna är inställda krävs ett av följande för att de ska kunna registreras: En omstart bör utföras i ett underhållsfönster. Via Cisco BroadWorks CLI: R24 och äldre AS_CLI/ASDiagnostic/DNS> läs in igen R25 + AS_CLI/ASDiagnostic/DNS/ExecutionServer> läs in igen AS_CLI/ASDiagnostic/DNS/ProvisioningServer> läs in igen

Nästa steg

För nya installationer av en NPS, gå till Konfigurera NPS för att använda autentiseringsproxy

För att migrera en befintlig Android-distribution till FCMv1, gå till Migrera NPS till FCMv1

Konfigurera NPS för att använda autentiseringsproxy

Den här uppgiften gäller för en ny installation av NPS som är dedikerad för Webex för Cisco BroadWorks.

Om du vill konfigurera autentiseringsproxyn på en NPS som delas med andra mobilappar, se Uppdatera Cisco BroadWorks NPS för att använda NPS-proxy.

Hämta OAuth-inloggningsuppgifter för ditt Webex för Cisco BroadWorks.

Skapa klientkontot på NPS:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Om du vill verifiera de värden som du angett stämmer överens med de du fått kör du XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI-issuerUrl:n ska ALLTID vara ett US CI-kluster oavsett var du befinner dig och standardinställningen ska vara:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

Ange NPS-proxy-URL och ställ in uppdateringsintervallet för token (30 minuter rekommenderas):

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

För att förbättra DNS-upplösningshastigheten rekommenderar vi att du använder lämpligt FQDN baserat på din region istället för det nuvarande FQDN:et nps.uc-one.broadsoft.com.

Regionbaserade FQDN:er:

Östra USA:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

Västamerika:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Om push-meddelanden får timeout på grund av en fördröjning i DNS-matchningen, öka timeout-värdet i "/etc/resolv.conf" filen på BroadWorks-servern.

(För Android-aviseringar) Lägg till app-ID för Android i FCM-programsammanhanget på NPS.

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

(För Apple iOS-aviseringar) Lägg till program-ID i APNS-programsammanhanget och se till att utelämna autentiseringsnyckeln – ställ in den på tom.

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

Konfigurera följande NPS-URL:er:

XSP\|ADP CLI-kontext	Parameter	Värde
`XSP\|ADP_CLI/Applications/NotificationPushServer/FCM>`	`authURL`	`https://www.googleapis.com/oauth2/v4/token`
	`pushURL`	`https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send`
	`scope`	`https://www.googleapis.com/auth/firebase.messaging`
`XSP\|ADP_CLI/Applications/NotificationPushServer/APNS/Production>`	`url`	`https://api.push.apple.com/3/device`

Konfigurera följande NPS-anslutningsparametrar till de rekommenderade värden som visas:

XSP\|ADP CLI-kontext	Parameter	Värde
`XSP\|ADP_CLI/Applications/` `NotificationPushServer/FCM>`	`tokenTimeToLiveInSeconds`	3600
	`connectionPoolSize`	10
	`connectionTimeoutInMilliseconds`	3600
	`connectionIdleTimeoutInSeconds`	600
`XSP\|ADP_CLI/Applications/NotificationPushServer/` `APNS/Production>`	`connectionTimeout`	3000
	`connectionPoolSize`	2
	`connectionIdleTimeoutInSeconds`	600

Kontrollera om programservern är ett program-ID eftersom du kan behöva lägga till Webex-apparna i listan över tillåtna program:

Kör AS_CLI/System/PushNotification> get och kontrollera värdet på enforceAllowedApplicationList. Om det är truemåste du slutföra denna deluppgift. Annars kan du hoppa över resten av deluppgiften.
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

Starta om XSP|ADP:n: bwrestart

Testa samtalsaviseringar genom att ringa från en BroadWorks-prenumerant till två Webex-mobilanvändare. Kontrollera att samtalsaviseringen visas på iOS- och Android-enheter.

Migrera NPS till FCMv1

Detta ämne innehåller valfria procedurer som du kan använda i Google FCM-konsolen när du har en befintlig NPS-distribution som du behöver migrera till FCMv1. Det finns tre metoder:

Migrera UC-One-klienter till FCMv1—När du har befintliga UCaaS-klienter och behöver migrera dem för att använda FCMv1.
Migrera SaaS-klienter till FCMv1—När du har befintliga SaaS-klienter och behöver migrera dem för att använda FCMv1.
Uppdatera ADP-server—När du migrerar NPS till en ADP-server.

Migrera UC-One-klienter till FCMv1

Använd stegen nedan i Google FCM-konsolen för att migrera UC-One-klienter till Google FCM HTTPv1.

Om varumärke tillämpas på klienten måste klienten ha avsändar-ID. I FCM-konsolen, se Projektinställningar > Cloud Messaging. Inställningen visas i tabellen för Projektuppgifter.

För mer information, se Connect Mobile Branding Guide på 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?. Se parametern gcm_defaultSenderId, som finns i Branding Kit, mappen Resource, filen branding.xml med syntaxen nedan:

xxxxxxxxxxxxx

Logga in på FCM Admin SDK på http://console.firebase.google.com.
Välj lämpligt Android-program.
På fliken Allmänt spelar du in projekt-ID:t
Gå till fliken tjänstekonton för att konfigurera ett tjänstekonto. Du kan skapa ett nytt tjänstekonto eller konfigurera ett befintligt.

Så här skapar du ett nytt tjänstekonto:
1. Klicka på den blå knappen för att skapa ett nytt tjänstkonto
2. Klicka på den blå knappen om du vill skapa en ny privat nyckel
3. Hämta nyckel till en säker plats
Så här återanvänder du ett befintligt tjänstekonto:
1. Klicka på den blå texten för att visa befintliga tjänstekonton.
2. Identifiera vilket tjänstekonto som ska användas. Tjänstekontot behöver behörighet firebaseadmin-sdk.
3. Klicka på hamburgermenyn till höger och skapa en ny privat nyckel.
4. Hämta json-filen som innehåller nyckeln och spara den på en säker plats.
Kopiera json-filen till XSP|ADP.

Konfigurera projekt-ID och :

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add

Konfigurera programmet:

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

Aktivera FCMv1:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

Kör kommandot bwrestart för att starta om XSP|ADP.

Migrera SaaS-klienter till FCMv1

Använd stegen nedan på Google FCM-konsol om du vill migrera SaaS-klienter till FCMv1.

Se till att du redan har slutfört proceduren "Konfigurera NPS för att använda autentiseringsproxy".

Inaktivera FCM:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
...Done

Kör kommandot bwrestart för att starta om XSP|ADP.

Aktivera FCM:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

Kör kommandot bwrestart för att starta om XSP|ADP.

Uppdatera ADP-server

Använd stegen nedan på Google FCM-konsolen om du migrerar NPS för att använda en ADP-server.

Hämta JSON-filen från Google Cloud Console:
1. På Google Cloud Console går du till sidan Tjänstekonton.
2. Klicka på Välj ett projekt , välj ditt projekt och klicka på Öppna .
3. Hitta raden för det servicekonto som du vill skapa en nyckel för, klicka på den vertikala knappen Mer och klicka sedan på Skapa nyckel.
4. Välj en Nyckeltyp och klicka på Skapa
  
  Filen hämtas.
Lägg till FCM till ADP-servern:
1. Importera JSON-filen till ADP-servern med kommandot /bw/install.
2. Logga in på ADP CLI och lägg till projekt- och API-nyckel:
  
  ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :
3. Lägg sedan till programmet och nyckeln:
  
  ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
4. Verifiera konfigurationen:
```
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
```

Cisco AI Assistant

Tack för din feedback.

Konfigurera push-meddelanden för samtal för Webex BroadWorks

NPS-proxy, översikt

Överväganden vid APNS

Förbered NPS för Webex för Cisco BroadWorks

Konfigurera NPS för att använda autentiseringsproxy

Migrera NPS till FCMv1

Migrera UC-One-klienter till FCMv1

Migrera SaaS-klienter till FCMv1

Uppdatera ADP-server

Små företag

Företag

Enheter

Lösningar för

Resurser

Företag