- 홈
- /
- 문서
이 구성 가이드를 통해 NPS 프록시를 활용하도록 시스코 브로드웍스 NPS를 업데이트하는 방법을 알아보세요.원활한 통합과 네트워크 성능 향상을 위한 단계별 지침, 고려 사항, 모범 사례를 찾아보세요.
NPS 인증 프록시 개요
이 문서에서는 NPS 인증 프록시를 사용하도록 공유 NPS를 구성하여 Webex 앱으로 통화 알림을 푸시하는 데 사용할 수 있는 방법을 설명해요. NPS가 다른 앱을 지원하지 않는 경우, 브로드웍스용 Webex 솔루션 가이드의 간소화된 절차를 따를 수 있어요.
NPS 프록시 개요
브로드웍스용 웹엑스와 호환하려면, NPS 프록시 기능인 UCaaS의 VoIP용 푸시 서버를 지원하도록 NPS를 패치해야 해요.
이 기능은 모바일 클라이언트의 서비스 제공자와 푸시 알림 인증서 개인 키를 공유할 때 발생하는 보안 취약성을 해결하기 위해 알림 푸시 서버에 새로운 디자인을 구현했어요. NPS는 서비스 제공자와 푸시 알림 인증서와 키를 공유하는 대신 새 API를 사용하여 UCaaS 백엔드에서 수명이 짧은 푸시 알림 토큰을 얻고 이 토큰을 Apple APN 및 Google FCM 서비스 인증에 사용해요.
또한 이 기능은 새로운 구글 파이어베이스 클라우드 메시징 (FCM) HTTPv1 API를 통해 안드로이드 장치에 알림을 푸시하는 알림 푸시 서버의 기능을 향상시켜요.
-
자세한 내용은 UCaaS의 VoIP용 푸시 서버 기능 설명을 참조하세요.
-
이 기능에 대한 브로드웍스 패치는 https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04 에서 사용할 수 있어요.
-
ADP 서버에 대한 자세한 내용은 시스코 브로드웍스 애플리케이션 딜리버리 플랫폼에서 찾을 수 있어요.
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 프록시 마이그레이션 요약

|
시퀀스 |
작업 제목 |
작업이 언제, 왜 필요해요? |
|---|---|---|
|
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를 구성하세요.
|
항상 필요해요. |
|
7 |
FCM 레거시 모드 키 제거해요. |
FCMv1에서 NPS에서 성공적으로 지원되는 앱용이에요. |
브로드웍스 콜라보레이트 iOS 앱을 HTTP/2로 마이그레이션하세요
이 작업은 iOS 플랫폼의 UC-one SaaS 및 Webex 앱에 대한 푸시 알림에 필수예요.
시작하기 전에
XSP에서 R22를 실행하는 경우 APNS에 HTTP/2를 사용하도록 NPS 애플리케이션을 구성하려면 먼저 ap354313을 적용해야 해요.
| 1 |
참고: 연결 시간 제한을 1000 미만으로 설정하지 마세요. |
| 2 |
APNS 애플리케이션 컨텍스트에 애플리케이션 ID를 추가하고 인증 키는 생략하고 빈 키로 설정하세요.
웹엑스 앱용: |
| 3 |
|
| 4 |
|
| 5 |
HTTP/2 활성화하세요:
|
| 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 가져와: | ||||||||||||||||
| 2 |
Firebase에서 서비스 계정의 개인 키 받기: | ||||||||||||||||
| 3 |
NPS를 호스팅하는 XSP에 키를 복사하세요. | ||||||||||||||||
| 4 |
FCM 프로젝트 컨텍스트에 프로젝트 ID 및 관련 개인 키를 추가하세요.
| ||||||||||||||||
| 5 |
UC-one (커넥트 또는 SaaS) 애플리케이션 및 관련 프로젝트 ID를 FCM 애플리케이션 컨텍스트에 추가하세요.
| ||||||||||||||||
| 6 |
여기에 표시된 속성과 권장값을 기준으로 FCM 구성을 확인하세요. 필요한 경우
|
브로드웍스 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 가져와: |
| 2 |
Firebase에서 서비스 계정의 개인 키 받기: |
| 3 |
|
| 4 |
ADP CLI에 로그인해서 FCM 프로젝트 컨텍스트에 프로젝트와 API 키를 추가해요.
|
| 5 |
FCM 애플리케이션 컨텍스트에 애플리케이션과 프로젝트 ID를 추가하세요.
|
| 6 |
구성 확인:
|
FCM 레거시 모드 다시 활성화해요
다음과 같은 경우에만 (마이그레이션의 일부로) 이 작업을 수행하면 돼요.
-
당신의 NPS는 UC-one SaaS나 브로드웍스 커넥트 안드로이드 앱에 사용돼요.
-
다른 앱에 대한 호출 푸시 알림이 FCMv1 API에서 작동한다는 것을 이미 테스트하셨어요.
NPS 인증 프록시 구성 프로세스 중에만 이러한 앱의 FCMv1 키를 활성화해야 하기 때문에 FCMv1을 일시적으로 비활성화하고 있어요.
| 1 |
공유 NPS를 호스팅하는 XSP에 로그인하세요. |
| 2 |
FCM 컨텍스트로 이동하여 FCM v1: |
NPS 인증 프록시 패치 설치해요
NPS 인증 프록시 기능을 지원하려면 다음 패치를 설치하세요.
R22 패치
R23 패치
인증 프록시를 사용하도록 NPS를 구성하세요
| 1 |
온보딩 담당자 또는 TAC로 서비스 요청을 만들어 당신의 (Webex 일반 ID) OAuth 클라이언트 계정을 프로비전하세요. 서비스 요청 제목 인증 프록시 설정을 위한 NPS 구성. OAuth 클라이언트 ID, 클라이언트 암호, 60일 동안 유효한 새로고침 토큰을 줘요. NPS에서 사용하기 전에 토큰이 만료되면 다시 요청할 수 있어요.
| |||||||||||||||||||
| 2 |
NPS에 고객 계정 만들기:
명령을 실행하여 입력한 값이 제공된 값과 일치하는지 확인하세요. | |||||||||||||||||||
| 3 |
NPS 프록시 URL을 입력하고 토큰 새로 고침 간격을 설정하세요 (30분 권장). 지역 기반 FQDN: 미국 동부:
미국 서부:
유럽:
사우디아라비아:
오스트레일리아:
DNS 확인 지연으로 푸시 알림 타임아웃이 되면 브로드웍스 서버에 있는 “/etc/resolv.conf” 파일의 타임아웃 값을 늘려주세요. | |||||||||||||||||||
| 4 |
(안드로이드 알림의 경우) 안드로이드 애플리케이션 ID를 NPS의 FCM 애플리케이션 컨텍스트에 추가해요. 안드로이드용 웹엑스 앱용: XSP_CLI/애플리케이션/알림푸시서버/FCM/애플리케이션> 안드로이드용 UC-one 앱용: | |||||||||||||||||||
| 5 |
(Apple iOS알림용) APNS 애플리케이션 컨텍스트에 애플리케이션 ID를 추가하고 인증 키는 생략하고 빈 키로 설정하세요. iOS용 웹엑스 앱용: iOS용 UC-one 앱용: | |||||||||||||||||||
| 6 |
다음 NPS URL을 구성하세요.
| |||||||||||||||||||
| 7 |
다음 NPS 연결 파라미터를 표시된 권장 값으로 구성하세요.
| |||||||||||||||||||
| 8 |
허용 목록에 Webex 앱을 추가해야 할 수 있으므로 애플리케이션 서버가 애플리케이션 ID를 검사하는지 확인하세요. |
NPS 다시 시작하고 푸시 알림 테스트
| 1 |
XSP 다시 시작해요: 베어스타트
|
| 2 |
브로드웍스 가입자한테 안드로이드 전화 클라이언트로 전화를 걸어 안드로이드로 전화 알림을 테스트해요. 안드로이드 장치에 전화 알림이 나타나는지 확인하세요. 참고: UC-one Android 애플리케이션에서 푸시 알림이 실패하기 시작하면 구성이 잘못되었을 수 있어요. 이런 상황이면 다음과 같이 기존 FCM으로 되돌릴 수 있어요.
|
| 3 |
브로드웍스 가입자로부터 iOS의 통화 클라이언트로 전화를 걸어 iOS로 전화 알림을 테스트해 보세요. iOS 장치에 전화 알림이 나타나는지 확인하세요. 참고: UC-one iOS 애플리케이션에서 푸시 알림이 실패하기 시작하면 구성이 잘못되었을 수 있어요. 이런 상황이면 |