이 문서에서
NPS 인증 프록시 개요
dropdown icon
NPS 인증 프록시 전제조건
    최소 버전 및 공동 거주 제한
    공유 NPS
    APN HTTP/2
    안드로이드 FCMv1
NPS 프록시 마이그레이션 요약
브로드웍스 콜라보레이트 iOS 앱을 HTTP/2로 마이그레이션하세요
브로드웍스 UC-One 커넥트/SaaS 안드로이드 앱을 FCMv1로 마이그레이션하세요
브로드웍스 UC-One 커넥트/SaaS 안드로이드 앱을 FCMv1 (ADP 기반) 로 마이그레이션하세요
FCM 레거시 모드 다시 활성화해요
dropdown icon
NPS 인증 프록시 패치 설치해요
    R22 패치
    R23 패치
인증 프록시를 사용하도록 NPS를 구성하세요
NPS 다시 시작하고 푸시 알림 테스트
NPS 프록시를 사용하도록 시스코 브로드웍스 NPS를 업데이트하세요: 구성 가이드
list-menu이 문서에서
list-menu피드백이 있습니까?

이 구성 가이드를 통해 NPS 프록시를 활용하도록 시스코 브로드웍스 NPS를 업데이트하는 방법을 알아보세요.원활한 통합과 네트워크 성능 향상을 위한 단계별 지침, 고려 사항, 모범 사례를 찾아보세요.

NPS 인증 프록시 개요

이 문서에서는 NPS 인증 프록시를 사용하도록 공유 NPS를 구성하여 Webex 앱으로 통화 알림을 푸시하는 데 사용할 수 있는 방법을 설명해요. NPS가 다른 앱을 지원하지 않는 경우, 브로드웍스용 Webex 솔루션 가이드의 간소화된 절차를 따를 수 있어요.

NPS 프록시 개요

브로드웍스용 웹엑스와 호환하려면, NPS 프록시 기능인 UCaaS의 VoIP용 푸시 서버를 지원하도록 NPS를 패치해야 해요.

이 기능은 모바일 클라이언트의 서비스 제공자와 푸시 알림 인증서 개인 키를 공유할 때 발생하는 보안 취약성을 해결하기 위해 알림 푸시 서버에 새로운 디자인을 구현했어요. NPS는 서비스 제공자와 푸시 알림 인증서와 키를 공유하는 대신 새 API를 사용하여 UCaaS 백엔드에서 수명이 짧은 푸시 알림 토큰을 얻고 이 토큰을 Apple APN 및 Google FCM 서비스 인증에 사용해요.

또한 이 기능은 새로운 구글 파이어베이스 클라우드 메시징 (FCM) HTTPv1 API를 통해 안드로이드 장치에 알림을 푸시하는 알림 푸시 서버의 기능을 향상시켜요.

NPS 인증 프록시 전제조건

NPS를 호스팅하는 XSP (또는 애플리케이션 전송 플랫폼 ADP) 는 다음 요구 사항을 충족해야 해요.

최소 버전 및 공동 거주 제한

  • NPS는 전용 XSP/ADP에서 활성화해야 하고 NPS는 서버에 호스팅되는 유일한 응용 프로그램이어야 해요. 푸시 알림 전달에 방해가 되는 것을 없애기 위한 거예요.

  • 배포에는 NPS 앱이 하나만 있어야 해요. 모바일 UC-one 협업/연결 및/또는 UC-one SaaS를 사용하고 브로드웍스용 웹엑스를 구현하는 경우, 모든 앱에서 이 단일 NPS를 공유해야 해요.

  • NPS는 R22 이상 XSP 또는 ADP 버전이어야 해요.

    XSP가 NPS만 실행하고 AS가 R21.SP1인 경우 R22/R23 XSP는 R21 스택과 호환돼요. 자세한 내용은 브로드웍스 호환성 매트릭스를 참조하세요.

  • ADP 서버에 대한 자세한 내용은 시스코 브로드웍스 애플리케이션 딜리버리 플랫폼에서 찾을 수 있어요.

공유 NPS

NPS 프록시를 사용하도록 공유 NPS를 구성하기 전에 다음 메모를 읽어보세요.

  • NPS를 다른 앱 (Webex 앱 뿐만 아니라) 과 함께 사용하는 경우: 먼저 NPS 프록시를 구성한 다음 NPS를 FCM 레거시 API를 사용하던 NPS를 FCM HTTP v1 API 사용으로 변경하세요.

  • NPS 프록시를 사용하는 오래된 앱에서 알림이 제대로 작동하는지 확인한 후에 안드로이드 앱용 FCM API 키와 iOS 앱의 APN 인증 키를 제거하세요.

APN HTTP/2

  • Cisco/BroadSoft가 아닌 iOS 앱을 배포한 경우 NPS 프록시를 사용하도록 NPS를 구성하기 전에 HTTP/2 APNS 프로토콜을 사용하도록 해당 앱을 구성하세요.

  • 콜라보레이트 또는 SaaS 브로드웍스 앱을 이미 지원하는 XSP/ADP는 HTTP/2로 마이그레이션해야 해요. HTTP/2 구성에 대한 자세한 내용은 APNS용 알림 푸시 서버에 대한 HTTP/2 지원을 참조하세요 (이 iOS 앱을 지원하기 위한 NPS의 마이그레이션은 이 문서에 요약되어 있습니다).

안드로이드 FCMv1

  • Cisco/BroadSoft가 아닌 안드로이드 앱을 배포한 경우, NPS 프록시를 사용하도록 NPS를 구성하기 전에 FCMv1 키를 사용하도록 해당 앱을 구성하세요.

  • XSP/ADP가 현재 커넥트 또는 UC-one SaaS 앱을 지원한다면, NPS 프록시를 구성한 후 FCMv1 키를 활성화하세요. 모든 추가 앱을 FCMv1 키로 마이그레이션하고 활성화하고 테스트한 다음 설정 지침을 완료할 준비가 될 때까지 비활성화하는 것이 좋습니다 (마이그레이션 흐름은 이 문서에 설명되어 있습니다).

NPS 프록시 마이그레이션 요약

NPS 인증 프록시로의 마이그레이션 시각적 요약이에요
테이블 1이에요.NPS 프록시로 마이그레이션 작업 요약

시퀀스

작업 제목

작업이 언제, 왜 필요해요?

1

UC-one SaaS (또는 커넥트) iOS 앱을 위해 NPS를 HTTP/2로 마이그레이션하세요.

NPS에서 그 앱들을 지원하는데 아직 HTTP/2용으로 구성되지 않았다면 말이에요.

2

UC-One SaaS (또는 커넥트) 안드로이드 앱을 위해 NPS를 FCMv1로 마이그레이션하세요.

NPS에서 해당 앱을 지원하는데 아직 FCMv1용으로 구성되지 않은 경우.

3

FCMv1 모드 활성화하고 푸시 알림 테스트해요.

NPS가 UC-One 커넥트 및/또는 기타 (시스코 외) 안드로이드 앱을 지원하는 경우.

4

FCM 레거시 모드 다시 활성화해요.

NPS가 UC-one SaaS를 지원한다면요. NPS 프록시를 구성하기 전에 FCMv1을 활성화한 상태로 두면 UC-One SaaS로의 푸시 알림이 실패하기 시작해요.

5

NPS 인증 프록시 패치 설치해요.

NPS가 XSP R22나 XSP R23에 있다면.

6

NPS 인증 프록시를 사용하도록 NPS를 구성하세요.

  • NPS에서 기술 지원 요청하세요

  • CI OAuth 계정 요청하세요

  • NPS에 CI 계정을 만들고 새로 고침 토큰 타임아웃을 구성하세요

  • 안드로이드 앱 ID 추가해요

  • iOS 앱 ID 추가해요

  • URL 및 연결 타임아웃 확인/설정하기

  • AS 허용 목록에 앱 추가해요

  • FCMv1 (다시) 활성화하세요.

  • XSP/ ADP 다시 시작해요

  • iOS와 안드로이드 앱용 테스트 PN

항상 필요해요.

7

FCM 레거시 모드 키 제거해요.

FCMv1에서 NPS에서 성공적으로 지원되는 앱용이에요.

브로드웍스 콜라보레이트 iOS 앱을 HTTP/2로 마이그레이션하세요

이 작업은 iOS 플랫폼의 UC-one SaaS 및 Webex 앱에 대한 푸시 알림에 필수예요.

시작하기 전에

XSP에서 R22를 실행하는 경우 APNS에 HTTP/2를 사용하도록 NPS 애플리케이션을 구성하려면 먼저 ap354313을 적용해야 해요.

1

XSP_CLI/애플리케이션/알림푸시 서버/APNS/프로덕션에서 프로덕션 URL과 연결 매개변수를 설정하세요. >

URL 설정 https://api.push.apple.com/3/device

커넥션 풀 사이즈 2로 설정하세요.

연결 타임아웃 3000으로 설정했어요.

연결 유휴 시간 제한을 초 단위로 600으로 설정해요

참고: 연결 시간 제한을 1000 미만으로 설정하지 마세요.

2

APNS 애플리케이션 컨텍스트에 애플리케이션 ID를 추가하고 인증 키는 생략하고 빈 키로 설정하세요.

UC-one SaaS의 경우: XSP_CLI/애플리케이션/알림 푸시 서버/APNS/프로덕션/토큰> com.broadsoft.uc-one 추가

웹엑스 앱용: XSP_CLI/애플리케이션/알림푸시서버/APNS/프로덕션/토큰> com.cisco.squared 추가

3

XSP_CLI/애플리케이션/알림푸시 서버/APNS/프로덕션/토큰으로 인증 키를 확인해요. > get

4

com.broadsoft.uc-one의 인증 키가 비어 있지 않으면 XSP_CLI/애플리케이션/알림푸시 서버/APNS/프로덕션/토큰> 인증 키 지우기로 지울 수 있어요.

5

HTTP/2 활성화하세요:

XSP_CLI/애플리케이션/알림 푸시 서버/APNS/일반 설정> HTTP2활성화를 참으로 설정하세요

6

UC-one SaaS 앱 전용: 리셀러 포털에 로그인하고 구성 > 브로드웍스 >로 이동하세요.

7

알림 푸시 서버 섹션까지 아래로 스크롤해서 릴리스 (예: 릴리즈 22) 를 선택한 다음 포털에 제공된 지침을 따르세요.

브로드웍스 UC-One 커넥트/SaaS 안드로이드 앱을 FCMv1로 마이그레이션하세요

  • 이 작업은 XSP의 NPS에 적용돼요. NPS가 ADP에 연결되어 있으면 무시하세요.

  • 이 절차를 사용하여 UC-one Connect 또는 UC-one SaaS 안드로이드 앱의 FCMv1 알림으로 마이그레이션할 수 있어요.

  • NPS 프록시를 사용하여 UC-One 또는 Webex 안드로이드 앱에 대한 푸시 알림을 인증하려면 FCMv1을 사용해야 해요.

  • 이 작업은 NPS 인증 프록시 구성의 일부로 활성화할 수 있도록 FCMv1용 NPS를 준비해요. NPS 인증 프록시를 구성할 준비가 될 때까지 FCMv1을 활성화하지 마세요. 그렇지 않으면 SaaS 클라이언트에 대한 알림이 실패해요.

1

파이어베이스 콘솔에서 프로젝트 ID 가져와:

  1. 콘솔.파이어베이스.google.com에 로그인하세요.

  2. UC-one (커넥트 또는 SaaS) 앱 프로젝트를 선택하고 프로젝트 설정을 여세요.

  3. 일반 탭을 열고 프로젝트 ID를 기록해요.

2

Firebase에서 서비스 계정의 개인 키 받기:

  1. 프로젝트 설정에서 서비스 계정 탭으로 이동해요.

  2. 새 서비스 계정을 만들고 개인 키를 받아도 돼요.

  3. 아니면 기존 서비스 계정을 열고 새 개인 키를 생성하세요.

    참고: 서비스 계정에는 firebaseAdmin-sdk 권한이 있어야 해요.

  4. 키 다운로드해서 안전한 곳으로 보내세요.

3

NPS를 호스팅하는 XSP에 키를 복사하세요.

4

FCM 프로젝트 컨텍스트에 프로젝트 ID 및 관련 개인 키를 추가하세요.

XSP_CLI/애플리케이션/알림푸시 서버/FCM/프로젝트> 프로젝트 ID 경로/키파일에 추가

5

UC-one (커넥트 또는 SaaS) 애플리케이션 및 관련 프로젝트 ID를 FCM 애플리케이션 컨텍스트에 추가하세요.

XSP_CLI/애플리케이션/알림푸시 서버/FCM/애플리케이션> 추가 애플리케이션 ID com.broadsoft.Connect 프로젝트 ID 프로젝트 ID 프로젝트 ID

6

여기에 표시된 속성과 권장값을 기준으로 FCM 구성을 확인하세요. 필요한 경우 set 버전의 명령을 사용하여 값을 변경하세요.

XSP_CLI/애플리케이션/알림푸시 서버/FCM> get 실행하세요

파라미터

추천 가치

인증 URL

https://www.googleapis.com/oauth2/v4/token

푸시 URL

https://fcm.googleapis.com/v1/projects/ 프로젝트 ID /메시지:보내기

스코프

https://www.googleapis.com/auth/firebase.messaging

몇 초만에 살 시간이 됐어요

3600

연결 풀 사이즈

10

연결 제한 시간 (밀리초)

3000

연결 대기 시간 제한 (초)

600

브로드웍스 UC-One 커넥트/SaaS 안드로이드 앱을 FCMv1 (ADP 기반) 로 마이그레이션하세요

  • 이 작업은 ADP의 NPS에 적용돼요. NPS가 XSP에 있으면 무시하세요.

  • 이 절차를 사용하여 UC-one Connect 또는 UC-one SaaS 안드로이드 앱의 FCMv1 알림으로 마이그레이션할 수 있어요.

  • NPS 프록시를 사용하여 UC-One 또는 Webex 안드로이드 앱에 대한 푸시 알림을 인증하려면 FCMv1을 사용해야 해요.

  • 이 작업은 NPS 인증 프록시 구성의 일부로 활성화할 수 있도록 FCMv1용 NPS를 준비해요. NPS 인증 프록시를 구성할 준비가 될 때까지 FCMv1을 활성화하지 마세요. 그렇지 않으면 SaaS 클라이언트에 대한 알림이 실패해요.

1

파이어베이스 콘솔에서 프로젝트 ID 가져와:

  1. 콘솔.파이어베이스.google.com에 로그인하세요.

  2. UC-one (커넥트 또는 SaaS) 앱 프로젝트를 선택하고 프로젝트 설정을 여세요.

  3. 일반 탭을 열고 프로젝트 ID를 기록해요.

2

Firebase에서 서비스 계정의 개인 키 받기:

  1. 프로젝트 설정에서 서비스 계정 탭으로 이동해요.

  2. 새 서비스 계정을 만들고 개인 키를 받아도 돼요.

  3. 아니면 기존 서비스 계정을 열고 새 개인 키를 생성하세요.

    참고: 서비스 계정에는 firebaseAdmin-sdk 권한이 있어야 해요.

  4. 키 (.json 파일) 를 안전한 곳으로 다운로드해요.

3

.json 파일을 ADP 서버 /bw/설치로 가져오세요.

4

ADP CLI에 로그인해서 FCM 프로젝트 컨텍스트에 프로젝트와 API 키를 추가해요.

ADP_CLI/애플리케이션/알림푸시 서버/FCM/프로젝트> add connect-ucaas /bw/install/ filename.json

5

FCM 애플리케이션 컨텍스트에 애플리케이션과 프로젝트 ID를 추가하세요.

ADP_CLI/애플리케이션/알림푸시 서버/FCM/애플리케이션> 추가 애플리케이션ID com.broadsoft.ucaas.Connect ProjectID 프로젝트 ID 프로젝트 ID

6

구성 확인:

ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get
Project ID Accountkey
========================
connect-ucaas ********
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas

FCM 레거시 모드 다시 활성화해요

다음과 같은 경우에만 (마이그레이션의 일부로) 이 작업을 수행하면 돼요.

  • 당신의 NPS는 UC-one SaaS나 브로드웍스 커넥트 안드로이드 앱에 사용돼요.

  • 다른 앱에 대한 호출 푸시 알림이 FCMv1 API에서 작동한다는 것을 이미 테스트하셨어요.

NPS 인증 프록시 구성 프로세스 중에만 이러한 앱의 FCMv1 키를 활성화해야 하기 때문에 FCMv1을 일시적으로 비활성화하고 있어요.

1

공유 NPS를 호스팅하는 XSP에 로그인하세요.

2

FCM 컨텍스트로 이동하여 FCM v1: XSP_CLI/애플리케이션/알림푸시서버/FCM> FCM 레거시 API 키 사용으로 돌아가려면 V1Enabled false를 설정하세요.

인증 프록시를 사용하도록 NPS를 구성하세요

1

온보딩 담당자 또는 TAC로 서비스 요청을 만들어 당신의 (Webex 일반 ID) OAuth 클라이언트 계정을 프로비전하세요. 서비스 요청 제목 인증 프록시 설정을 위한 NPS 구성.

OAuth 클라이언트 ID, 클라이언트 암호, 60일 동안 유효한 새로고침 토큰을 줘요. NPS에서 사용하기 전에 토큰이 만료되면 다시 요청할 수 있어요.
2

NPS에 고객 계정 만들기:

XSP_CLI/애플리케이션/알림푸시 서버/시스코CI/클라이언트> 1단계부터 클라이언트 ID 클라이언트 ID 설정

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

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

명령을 실행하여 입력한 값이 제공된 값과 일치하는지 확인하세요.XSP_CLI/애플리케이션/알림푸시 서버/시스코CI/클라이언트> get

3

NPS 프록시 URL을 입력하고 토큰 새로 고침 간격을 설정하세요 (30분 권장).

지역 기반 FQDN:

미국 동부:

XSP_CLI/애플리케이션/알림푸시 서버/클라우드NPS서비스> URL 설정 https://broadworks-idp-proxy-a.wbx2.com/nps/

미국 서부:

XSP_CLI/애플리케이션/알림푸시 서버/클라우드NPS서비스> URL 설정 https://broadworks-idp-proxy-r.wbx2.com/nps/

유럽:

XSP_CLI/애플리케이션/알림푸시 서버/클라우드NPS서비스> URL 설정 https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/애플리케이션/알림 푸시 서버/클라우드 NPS 서비스> VoIP 토큰 새로 고침 간격 1800으로 설정하세요

사우디아라비아:

XSP_CLI/애플리케이션/알림푸시 서버/클라우드NPS서비스> URL 설정 https://broadworks-idp-proxy-d.wbx2.com/nps/

오스트레일리아:

XSP_CLI/애플리케이션/알림푸시 서버/클라우드NPS서비스> URL 설정 https://broadworks-idp-proxy-m.wbx2.com/nps/

DNS 확인 지연으로 푸시 알림 타임아웃이 되면 브로드웍스 서버에 있는 “/etc/resolv.conf” 파일의 타임아웃 값을 늘려주세요.

4

(안드로이드 알림의 경우) 안드로이드 애플리케이션 ID를 NPS의 FCM 애플리케이션 컨텍스트에 추가해요.

안드로이드용 웹엑스 앱용: XSP_CLI/애플리케이션/알림푸시서버/FCM/애플리케이션> com.cisco.wx2.android 추가

안드로이드용 UC-one 앱용: XSP_CLI/애플리케이션/알림푸시서버/FCM/애플리케이션> com.broadsoft.connect 추가

5

(Apple iOS알림용) APNS 애플리케이션 컨텍스트에 애플리케이션 ID를 추가하고 인증 키는 생략하고 빈 키로 설정하세요.

iOS용 웹엑스 앱용: XSP_CLI/애플리케이션/알림푸시서버/APNS/프로덕션/토큰> com.cisco.squared 추가

iOS용 UC-one 앱용: XSP_CLI/애플리케이션/알림푸시서버/APNS/프로덕션/토큰> com.cisco.squared 추가

6

다음 NPS URL을 구성하세요.

XSP CLI 컨텍스트

파라미터

가치

XSP_CLI/애플리케이션/알림푸시 서버/FCM>

인증 URL

https://www.googleapis.com/oauth2/v4/token

푸시 URL

https://fcm.googleapis.com/v1/projects//messages:send

스코프

https://www.googleapis.com/auth/firebase.messaging

XSP_CLI/애플리케이션/알림 푸시 서버/APNS/프로덕션>

URL

https://api.push.apple.com/3/device

7

다음 NPS 연결 파라미터를 표시된 권장 값으로 구성하세요.

XSP CLI 컨텍스트

파라미터

가치

XSP_CLI/애플리케이션/알림푸시 서버/FCM>

몇 초만에 살 시간이 됐어요

3600

연결 풀 사이즈

10

연결 제한 시간 (밀리초)

3000

연결 대기 시간 제한 (초)

600

XSP_CLI/애플리케이션/알림 푸시 서버/APNS/프로덕션>

연결 타임아웃

3000

연결 풀 사이즈

2

연결 대기 시간 제한 (초)

600

8

허용 목록에 Webex 앱을 추가해야 할 수 있으므로 애플리케이션 서버가 애플리케이션 ID를 검사하는지 확인하세요.

  1. AS_CLI/시스템/푸시 알림> 실행해서 EnforceAllowedApplicationList 값 가져와서 확인해 보세요. 사실이라면, 이 하위 작업을 완료해야 해요. 그렇지 않으면, 나머지 하위 작업은 건너뛰세요.

  2. as_CLI/시스템/푸시 알림/허용 애플리케이션> com.cisco.wx2.android “웹엑스 안드로이드” 추가

  3. as_CLI/시스템/푸시 알림/허용 애플리케이션> addcom.cisco.squared “Webex iOS”

NPS 다시 시작하고 푸시 알림 테스트

1

XSP 다시 시작해요:

베어스타트
2

브로드웍스 가입자한테 안드로이드 전화 클라이언트로 전화를 걸어 안드로이드로 전화 알림을 테스트해요. 안드로이드 장치에 전화 알림이 나타나는지 확인하세요.

참고: UC-one Android 애플리케이션에서 푸시 알림이 실패하기 시작하면 구성이 잘못되었을 수 있어요. 이런 상황이면 다음과 같이 기존 FCM으로 되돌릴 수 있어요.

  1. FCMv1 비활성화: XSP_CLI/애플리케이션/알림푸시서버/FCM> V1 활성화 설정 거짓

  2. SP 재시작: 베리스타트

  3. 구성을 확인해 보세요.

  4. FCMv1 다시 활성화하고 XSP를 다시 시작해요.

  5. 테스트를 반복해요.

3

브로드웍스 가입자로부터 iOS의 통화 클라이언트로 전화를 걸어 iOS로 전화 알림을 테스트해 보세요. iOS 장치에 전화 알림이 나타나는지 확인하세요.

참고: UC-one iOS 애플리케이션에서 푸시 알림이 실패하기 시작하면 구성이 잘못되었을 수 있어요. 이런 상황이면 HTTP2Enabled false로 설정하여 레거시 바이너리 인터페이스로 되돌릴 수 있어요.

이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?