Конфигуриране на push известия за обаждания за Webex BroadWorks

list-menuОбратна връзка?
Научете как да настроите push известия за обаждания за Webex за BroadWorks, използвайки NPS за Android и iOS.

В този документ използваме термина Call Notifications Push Server (CNPS), за да опишем хоствано с XSP или aDP хоствано приложение, което се изпълнява във вашата среда. Вашият CNPS работи с вашата система BroadWorks, за да е наясно с входящите обаждания към потребителите ви, и избутва известия за тези към услугите за уведомяване на Google Firebase Cloud Messaging (FCM) или apple Push Notification service (APNs).

Тези услуги уведомяват мобилните устройства на Webex за абонатите на Cisco BroadWorks, че имат входящи повиквания в Webex.

За повече информация относно NPS вижте известие push сървър функция описание.

Подобен механизъм в Webex работи с услугите за съобщения и присъствие на Webex, за да прокара известия до услугите за уведомяване на Google (FCM) или Apple (APNS). Тези услуги от своя страна уведомяват потребителите на mobile Webex за входящи съобщения или промени в присъствието.

Този раздел описва как да конфигурирате NPS за прокси за удостоверяване, когато NPS не поддържа други приложения. Ако трябва да мигрирате споделен NPS, за да използвате NPS прокси, вижте Актуализиране на Cisco BroadWorks NPS за използване на NPS прокси.

Общ преглед на NPS прокси

За съвместимост с Webex за Cisco BroadWorks вашият CNPS трябва да бъде закърпена, за да поддържа функцията NPS прокси сървър, Push Server за VoIP в UCaaS.

Функцията внедрява нов дизайн в Известяване Push Server за разрешаване на уязвимостта на защитата на споделяне push уведомление сертификат частни ключове с доставчици на услуги за мобилни клиенти. Вместо да споделя сертификати за push известия и ключове с доставчика на услуги, NPS използва нов API, за да получи краткотраен маркер за известия за натискане от Webex за Cisco BroadWorks backend и използва този маркер за удостоверяване с apple APNs и услугите на Google FCM.

Функцията също така повишава възможността на Сървъра за натискане на известията да прокара известия до устройства с Android чрез новия API на Google Firebase Cloud Съобщения (FCM) HTTPv1.

APNS Съображения

Apple вече няма да поддържа базирания на HTTP/1 двоичен протокол на услугата Apple Push Notification след 31 март 2021 г. Препоръчваме ви да конфигурирате вашия XSP|ADP да използва HTTP/2-based интерфейс за APN. Тази актуализация изисква вашият XSP|ADP, хостващ NPS, да работи с R22 или по-нова версия.

Подгответе Своя NPS за Webex за Cisco BroadWorks

1

Инсталирайте и конфигурирайте специализиран XSP (минимална версия R22), или Платформа за доставка на приложения (ADP).

2

Инсталиране на NPS удостоверяване прокси кръпки:

3

Активиране на приложението "Избутване на сървър за известия".

4

(За известия за Android) Разрешаване на FCM v1 API на NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(За известия на Apple iOS) Разрешаване на HTTP/2 на NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

Това е ексклузивно за Версия 22 и по-ранни версии; не е налично във Версия 23 и по-нови версии, които поддържат само HTTP/2.

6

Прикрепете техноподдържане от NPS XSP/ADP.

7

На всеки AS сървър, файлът namedefs в /usr/local/broadworks/bw_base/conf трябва да бъде конфигуриран със SRV и A записи за Notification Push Server. (XSP/ADP) търсене, ако са няколко XSP/ADP след това добавете запис за всеки, ако е необходимо.

Пример: _pushnotification-клиент._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com В A 10.193.78.149

След като е настроено, е необходимо едно от следните неща, за да се приемат промените:

  1. Рестартирането трябва да се извърши в прозорец за поддръжка.

  2. Чрез Cisco BroadWorks CLI:

    R24 и по-стари

    AS_CLI/ASDiagnostic/DNS> презареждане

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> презареждане

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> презареждане

Какво да направите след това

За нови инсталации на NPS, отидете на Конфигуриране на NPS за използване на прокси сървър за удостоверяване

За да мигрирате съществуващо внедряване на Android към FCMv1, отидете на Мигриране на NPS към FCMv1

Конфигуриране на NPS за използване на прокси за удостоверяване

Тази задача се отнася за нова инсталация на NPS, посветена на Webex за Cisco BroadWorks.

Ако искате да конфигурирате прокси сървър за удостоверяване на NPS, който се споделя с други мобилни приложения, вижте Актуализиране на Cisco BroadWorks NPS за използване на NPS прокси.

1

Получаване на OAuth идентификационни данни за вашия Webex за Cisco BroadWorks.

2

Създаване на клиентския акаунт на 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

За да проверите стойностите, които въведохте, съвпадат с това, което ви е дадено, изпълнете XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI issuerUrl ВИНАГИ трябва да бъде US CI клъстер, независимо от вашето местоположение, а по подразбиране трябва да бъде:

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

3

Въведете NPS Прокси URL адреса и задайте интервала за обновяване на маркера (препоръчват се 30 минути):

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

За да подобрите скоростта на преобразуване на DNS, вместо текущото FQDN име nps.uc-one.broadsoft.com, ви препоръчваме да използвате подходящото FQDN име, базирано на вашия регион.

Регионално базирани FQDN имена:

САЩ Изток:

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

Западна част на САЩ:

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

Европа:

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Ако времето за изчакване на push известията изтече поради забавяне в разрешаването на DNS, увеличете стойността на времето за изчакване в "/etc/resolv.conf" файл на сървъра BroadWorks.

4

(За известия за Android) Добавете Идентификационния номер на приложението android към контекста на Приложенията на FCM на NPS.

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

5

(За известия на Apple iOS) Добавете ИД на приложението в контекста на приложенията APNS, като се уверите, че пропускате ключа Auth – задайте го да се изпразни.

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

6

Конфигуриране на следните NPS URL адреси:

XSP|ADP CLI контекст

Параметър

Стойност

  • 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

7

Конфигурирайте следните параметри на NPS връзка към показаните препоръчителни стойности:

XSP|ADP CLI контекст

Параметър

Стойност

  • 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

8

Проверете дали Сървърът за приложения скрининг приложение Идентификатори, защото може да се наложи да добавите приложенията webex към списъка с разрешения:

  1. Изпълнете AS_CLI/System/PushNotification> get и проверете стойността на enforceAllowedApplicationList. Ако е true, трябва да изпълните тази подзадача. В противен случай пропуснете останалата част от под задачата.

  2. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

9

Рестартирайте XSP|ADP: bwrestart

10

Тествайте известията за обаждания, като провеждате обаждания от абонат на BroadWorks до двама мобилни потребители на Webex. Проверете дали известието за обаждане се показва на устройства с iOS и Android.

Мигриране на НПС към FCMv1

Тази тема съдържа незадължителни процедури, които можете да използвате в Google FCM Console, когато имате съществуващо разполагане на NPS, което трябва да мигрирате към FCMv1. Има три процедури:

Мигриране на UC-One клиенти към FCMv1

Използвайте стъпките по-долу в конзолата на Google FCM, за да мигрирате клиентите на UC-One към Google FCM HTTPv1.

Ако брандиране се прилага към клиента, клиентът трябва да има ИД на подателя. В конзолата на FCM вижте Настройки на проекта > съобщения в облака . Настройката се появява в таблицата идентификационни данни на проекта.

За подробности вижте Ръководството за брандиране на Connect Mobile на 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?. Вижте параметъра gcm_defaultSenderId, който се намира в Branding Kit, папка Resource, файл branding.xml със следния синтаксис:

xxxxxxxxxxxxx

  1. Влезте В FCM Администратор SDK при http://console.firebase.google.com.

  2. Изберете съответното приложение за Android.

  3. В раздела Общи запишете ИД на проекта

  4. Навигирайте до раздела акаунти за услуги, за да конфигурирате акаунт за сервиз. Можете да създадете нов акаунт за сервиз или да конфигурирате съществуващ такъв.

    За да създадете нов акаунт за сервиз:

    1. Щракнете върху синия бутон за създаване на нов акаунт за услуги

    2. Кликнете върху синия бутон, за да генерирате нов частен ключ

    3. Изтегляне на ключ на сигурно място

    За да използвате повторно съществуващ сервизен акаунт:

    1. Кликнете върху синия текст, за да видите съществуващите акаунти за услуги.

    2. Идентифицирайте сервизния акаунт, който да използвате. Сервизен акаунт се нуждае от разрешение firebaseadmin-sdk.

    3. В самото дясно кликнете върху менюто с хамбургери и създайте нов частен ключ.

    4. Изтеглете файла json, който съдържа ключа, и запишете на защитено място.

  5. Копирайте json файла в XSP|ADP.

  6. Конфигуриране на ИД на проекта и :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
  7. Конфигуриране на приложението:

    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
  8. Разрешаване на FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Изпълнете командата bwrestart, за да рестартирате XSP|ADP.

Мигрират SaaS клиенти към FCMv1

Използвайте стъпките по-долу в Google FCM Console, ако искате да мигрирате SaaS клиенти към FCMv1.

Уверете се, че вече сте завършили процедурата "Конфигуриране на NPS за използване на прокси за удостоверяване".

  1. Забраняване на FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Изпълнете командата bwrestart, за да рестартирате XSP|ADP.

  3. Разрешаване на FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Изпълнете командата bwrestart, за да рестартирате XSP|ADP.

Актуализиране на ADP сървър

Използвайте стъпките по-долу в Google FCM Console, ако мигрирате NPS, за да използвате ADP сървър.

  1. Получете файла JSON от облачната конзола на Google:

    1. В облачната конзола на Google отидете на страницата Профили за услуги.

    2. Щракнете върху Избор на проект , изберете вашия проект и щракнете върху Отвори .

    3. Намерете реда на сервизния акаунт, за който искате да създадете ключ, щракнете върху вертикалния бутон Още и след това щракнете върху Създаване на ключ.

    4. Изберете тип ключ и щракнете върху Създаване

      Файлът изтегля.

  2. Добавяне на FCM към ADP сървъра:

    1. Импортирайте JSON файла към ADP сървъра, като използвате командата /bw/install.

    2. Вход в ADP CLI и добавете Project и API ключ:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :

    3. След това добавете Приложението и ключа:

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done

    4. Проверете конфигурацията:

      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
Беше ли полезна тази статия?
Беше ли полезна тази статия?