Webex BroadWorks에 대한 통화 푸시 알림 구성

list-menu피드백이 있습니까?
Android 및 iOS용 NPS를 사용하여 BroadWorks용 Webex에 대한 통화 푸시 알림을 설정하는 방법을 알아보세요.

이 문서에서 사용된 용어 통화 알림 푸시 서버(CNPS)는 귀사의 환경에서 실행되는 XSP- 또는 ADP-호스팅된 응용프로그램을 나타냅니다. CNPS는 BroadWorks 시스템과 함께 작동하여 사용자들에게서 걸려 오는 전화를 인식하고, 이것에 대한 알림을 Google FCM(Firebase Cloud Messaging) 또는 APN(Apple Push Notification) 알림 서비스로 푸시합니다.

이 서비스는 Webex에서 걸려오는 전화가 있음을 Cisco BroadWorks용 Webex 구독자의 모바일 장치로 알려줍니다.

NPS에 대한 자세한 정보는 알림 푸시 서버 기능 설명을 참조하십시오.

Webex에서의 유사한 메커니즘은 Webex 메시징 및 프레즌스 서비스와 함께 작동하여 알림을 Google(FCM) 또는 Apple(APNS) 알림 서비스로 푸시합니다. 그러면 이 서비스는 모바일 Webex 사용자에게 수신 메시지 또는 프레즌스의 변경 사항에 대하여 알려줍니다.

이 섹션에서는 NPS가 다른 앱을 지원하지 않는 경우 인증 프록시를 위해 NPS를 구성하는 방법을 설명합니다. NPS 프록시를 사용하도록 공유 NPS를 마이그레이션해야 하는 경우 NPS 프록시를 사용하도록 Cisco BroadWorks NPS 업데이트를 참조하세요.

NPS 프록시 개요

Cisco BroadWorks용 Webex와 호환성을 위해 CNPS가 NPS 프록시 기능인 UCaaS의 VoIP용 푸시 서버를 지원하도록 패치되어야 합니다.

이 기능은 NPS의 새로운 설계를 사용하여 푸시 알림 인증서 비공개 키를 모바일 클라이언트를 위한 서비스 제공자와 공유할 때의 보안 취약점을 해결합니다. 서비스 공급자와 푸시 알림 인증서 및 키를 공유하는 대신, NPS는 새로운 API를 사용하여 Cisco BroadWorks용 Webex 백엔드에서 짧은 푸시 알림 토큰을 확보하고, Apple APN 및 Google FCM 서비스에서 인증을 위해 이 토큰을 사용합니다.

이 기능은 또한 새로운 Google FCM HTTPv1 API를 통해 Android 장치로 알림을 푸시하는 NPS의 기능도 강화합니다.

APNS 고려 사항

Apple은 2021년 3월 31일 이후부터 더 이상 Apple 푸시 알림 서비스에서 HTTP/1 기반 바이너리 프로토콜을 지원하지 않습니다. XSP|ADP를 구성하여 사용하는 것이 좋습니다. HTTP/2-based APN에 대한 인터페이스. 이 업데이트를 적용하려면 NPS를 호스팅하는 XSP|ADP가 R22 이상을 실행해야 합니다.

Cisco BroadWorks용 Webex에 대해 NPS 준비

1

전용 XSP(최소 버전 R22) 또는 ADP(Application Delivery Platform)을 설치하고 구성합니다.

2

NPS 인증 프록시 패치를 설치합니다.

3

NPS 응용프로그램을 활성화합니다.

4

(Android 알림의 경우) NPS에서 FCM v1 API를 활성화합니다.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Apple iOS 알림의 경우) NPS에서 HTTP/2를 활성화합니다.

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

이것은 릴리스 22 및 이전 버전에만 해당되며 릴리스 23 이상 버전에서는 사용할 수 없습니다. HTTP/2.

6

NPS XSP/ADP의 techsupport를 붙입니다.

7

각 AS 서버에서 /usr/local/broadworks/bw_base/conf 의 namedefs 파일은 알림 푸시 서버에 대한 SRV 및 A 레코드로 구성되어야 합니다. (XSP/ADP) 조회, 여러 개일 경우 XSP/ADP 그런 다음 필요에 따라 각각에 대한 항목을 추가합니다.

예: _pushnotification-클라이언트._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN 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 구성

이 작업은 Cisco BroadWorks용 Webex에 대해 전용인 NPS의 새로운 설치에 적용됩니다.

다른 모바일 앱과 공유되는 NPS에서 인증 프록시를 구성하려면 NPS 프록시를 사용하도록 Cisco BroadWorks NPS 업데이트를 참조하세요.

1

Cisco BroadWorks용 Webex에 대한 OAuth 자격 증명 얻기.

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

DNS 확인 지연으로 인해 푸시 알림 시간이 초과되는 경우 시간 초과 값을 늘리십시오. "/etc/resolv.conf" BroadWorks 서버의 파일입니다.

4

(Android 알림의 경우) Android 응용프로그램 ID를 NPS의 FCM 응용프로그램 컨텍스트에 추가합니다.

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

5

(Apple iOS 알림의 경우) 응용프로그램 ID를 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 앱을 허용 목록에 추가해야 할 수도 있기 때문에 응용프로그램 서버가 응용프로그램 ID를 스크리닝하고 있는지 확인하십시오.

  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 구독자가 2명의 Webex 모바일 사용자에게 전화를 걸어서 통화 알림을 테스트합니다. iOS 및 Android 기기에 전화 알림이 표시되는지 확인하세요.

NPS를 FCMv1로 마이그레이션

이 주제에는 FCMv1로 마이그레이션해야 하는 기존의 NPS 배포가 있는 경우, Google FCM 콘솔에서 사용할 수 있는 선택적인 절차가 포함되어 있습니다. 세 가지 절차가 있습니다.

UC-One 클라이언트를 FCMv1로 마이그레이션

Google FCM 콘솔에서 아래 단계를 사용하여 UC-One 클라이언트를 Google FCM HTTPv1로 마이그레이션합니다.

브랜딩이 클라이언트에 적용되는 경우, 클라이언트에는 발신자 ID가 있어야 합니다. FCM 콘솔에서 프로젝트 설정 > 클라우드 메시징을 선택합니다. 설정은 Project 자격 증명 표에서 볼 수 있습니다.

자세한 내용은 []의 Connect Mobile Branding Guidehttps://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?를 참조하세요. 아래 구문을 사용하여 Branding Kit, Resource 폴더, branding.xml 파일에 있는 gcm_defaultSenderId 매개변수를 참조하세요.

xxxxxxxxxxxxx

  1. http://console.firebase.google.com에서 FCM 관리 SDK에 로그인합니다.

  2. 적절한 Android 응용프로그램을 선택합니다.

  3. 일반 탭을 열고 프로젝트 ID를 기록합니다.

  4. 서비스 계정 탭에서 서비스 계정을 구성합니다. 새로운 서비스 계정을 만들거나 기존의 것을 구성할 수 있습니다.

    새 서비스 계정을 만들려면:

    1. 새로운 서비스 계정을 만들려면 파란색 버튼을 클릭합니다.

    2. 새로운 비공개 키를 생성하려면 파란색 버튼을 클릭합니다.

    3. 키를 보안 위치로 다운로드합니다.

    기존 서비스 계정을 다시 사용하려면:

    1. 기존 서비스 계정을 확인하려면 파란색 텍스트를 클릭합니다.

    2. 사용할 서비스 계정을 확인합니다. 서비스 계정은 권한 firebaseadmin-sdk가 필요합니다.

    3. 오른쪽에서 햄버거 메뉴를 클릭하고 새로운 비공개 키를 만듭니다.

    4. 키가 포함된 json 파일을 다운로드하고 안전한 위치에 저장합니다.

  5. JSON 파일을 XSP|ADP에 복사합니다.

  6. 프로젝트 ID를 구성합니다.

    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로 마이그레이션

SaaS 클라이언트를 FCMv1로 마이그레이션하려면 Google FCM 콘솔에서 아래 단계를 따르십시오.

"인증 프록시를 사용하려면 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 서버 업데이트

ADP 서버를 사용하기 위해 NPS를 마이그레이션하는 경우, Google FCM 콘솔에서 아래 단계를 따르십시오.

  1. Google 클라우드 콘솔에서 JSON 파일을 얻습니다.

    1. Google 클라우드 콘솔에서 서비스 계정 페이지로 이동합니다.

    2. 프로젝트 선택을 클릭하고 프로젝트를 선택한 후 열기를 클릭합니다.

    3. 키를 생성하려는 서비스 계정의 행을 찾은 다음 더보기 세로 버튼을 클릭한 다음 키 생성을 클릭합니다.

    4. 유형을 선택하고 생성을 클릭하세요.

      파일이 다운로드됩니다.

  2. FCM을 ADP 서버에 추가합니다.

    1. /bw/install 명령을 사용하여 JSON 파일을 ADP 서버로 가져옵니다.

    2. ADP CLI에 로그인하고 프로젝트 및 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
이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?