У цій статті
Огляд проксі-сервера автентифікації NPS
dropdown icon
Передумови проксі автентифікації NPS
    Мінімальні версії та обмеження спільного проживання
    Спільний NPS
    APN HTTP/2
    Андроїд FCMv1
Підсумок міграції проксі-сервера NPS
Перенесення програм BroadWorks Collaborate для iOS на HTTP/2
Міграція програм BroadWorks UC-One Connect/SaaS для Android до FCMv1
Міграція програм BroadWorks UC-One Connect/SaaS для Android до FCMv1 (на ADP)
Повторно увімкнути режим застарілого FCM
dropdown icon
Встановіть патчі проксі автентифікації NPS
    Патчі R22
    Патчі R23
Налаштування NPS для використання проксі-сервера аутентифікації
Перезапустіть NPS та перевірте push-сповіщення
Оновіть Cisco BroadWorks NPS для використання проксі-сервера NPS: Посібник з налаштування
list-menuУ цій статті
list-menuНадіслати відгук?

Дізнайтеся, як оновити Cisco BroadWorks NPS для використання проксі NPS за допомогою цього посібника з налаштування. Дізнайтеся про покрокові інструкції, міркування та найкращі практики для безперебійної інтеграції та підвищення продуктивності мережі.

Огляд проксі-сервера автентифікації NPS

У цій статті описано, як налаштувати спільний NPS для використання проксі-сервера автентифікації NPS, щоб його також можна було використовувати для надсилання сповіщень про виклики до програм Webex. Якщо ваш NPS не підтримує інші програми, ви можете виконати спрощену процедуру, наведену в Посібнику з рішень Webex для BroadWorks.

Огляд проксі-сервера NPS

Для сумісності з Webex для BroadWorks ваш NPS повинен бути виправлений, щоб підтримувати функцію проксі-сервера NPS, P ush Server для VoIP в UCaaS.

Функція впроваджує новий дизайн на сервері повідомлень для усунення вразливості безпеки спільного використання приватних ключів сертифікатів push-повідомлень з постачальниками послуг для мобільних клієнтів. Замість того, щоб ділитися сертифікатами та ключами push-сповіщень з постачальником послуг, NPS використовує новий API для отримання короткочасного токена push-сповіщень із бекенду UCaaS та використовує цей маркер для ау тентифікації за допомогою APN Apple та служб Google FCM.

Ця функція також розширює можливості сервера сповіщень для надсилання сповіщень на пристрої Android через новий API HTTPv1 Google Firebase Cloud Messaging (FCM).

Передумови проксі автентифікації NPS

XSP (або ADP платформи доставки додатків), на якому розміщується NPS, повинен відповідати наступним вимогам:

Мінімальні версії та обмеження спільного проживання

  • NPS повинен бути активований на виділеному XSP/ADP, а NPS повинен бути єдиним розміщеним додатком на сервері. Це для усунення перешкод у доставці Push-повідомлень.

  • У розгортанні має бути лише одна програма NPS. Якщо ви використовуєте мобільний UC-One Collaborate/Connect та/або UC-One SaaS і впроваджуєте Webex для BroadWorks, вам потрібно надати спільний доступ до цього єдиного NPS для всіх програм.

  • NPS повинен бути у версії R22 або пізнішої XSP, або ADP.

    R22/R23 XSP сумісний зі стеком R21, якщо XSP запускає лише NPS, а AS - R21.SP1. Для отримання додаткової інформації див. Матрицю сумісності BroadWorks.

  • Більше інформації про сервер ADP можна знайти на платформі доставки додатків Cisco BroadWorks.

Спільний NPS

Прочитайте ці примітки, перш ніж налаштувати спільний NPS для використання проксі-сервера NPS:

  • Якщо ваш NPS використовується з іншими програмами (не лише програмою Webex): спочатку налаш туйте проксі-сервер NPS, а потім змініть NPS з використання застарілого API FCM на використання FCM HTTP v1 API.

  • Після того, як ви перевірите, що сповіщення працюють належним чином для старих програм із проксі-сервером NPS, видаліть ключ API FCM для програми Android та ключ автен тифікації APN для програми iOS.

APN HTTP/2

  • Якщо ви розгорнули будь-які програми iOS, які не належать до Cisco/BroadSoft, налаштуйте ці програми на використання протоколу HTTP/2 APNS, перш ніж налаштувати NPS для використання проксі-сервера NPS.

  • XSP/ADP, які вже підтримують додаток Collaborate або SaaS BroadWorks, потрібно перенести на HTTP/2. Докладні відомості про налаштування HTTP/2 див. у статті Підтрим ка HTTP/2 до Push сервера сповіщень для APNS (міграція NPS для підтримки цих програм iOS узагальнена в цій статті).

Андроїд FCMv1

  • Якщо ви розгорнули будь-які додатки для Android, які не належать до Cisco/BroadSoft, налаштуйте ці програми на використання ключів FCMv1, перш ніж налаштувати NPS для використання проксі-сервера NPS.

  • Якщо XSP/ADP наразі підтримує програму Connect або UC-One SaaS, увімкніть ключі FCMv1 після налаштування проксі-сервера NPS. Рекомендуємо перенести всі додаткові програми на ключі FCMv1, увімкнути та протестувати, а потім вимкнути, доки ви не будете готові виконати інструкції з налаштування (процес міграції описано в цій статті).

Підсумок міграції проксі-сервера NPS

Візуальний підсумок міграції на проксі-сервер автентифікації NPS
Таблиця 1. Короткий зміст завдань для міграції на проксі NPS

Послідовність

Назва завдання

Коли і навіщо потрібно завдання?

1

Перенесіть NPS на HTTP/2 для програм UC-One SaaS (або Connect) для iOS.

Якщо NPS підтримує ці програми, і вони ще не налаштовані для HTTP/2.

2

Міграція NPS до FCMv1 для програм UC-One SaaS (або Connect) для Android.

Якщо NPS підтримує ці програми, і вони ще не налаштовані для FCMv1.

3

Увімкніть режим FCMv1 та перевірте push-сповіщення.

Якщо NPS підтримує UC-One Connect та/або інші (не Cisco) програми для Android.

4

Повторно увімкніть режим застарілого FCM.

Якщо NPS підтримує UC-One SaaS. Якщо ви залишаєте FCMv1 увімкненим, перш ніж налаштувати проксі-сервер NPS, запустіть сповіщення до UC-One SaaS.

5

Встановіть патчі проксі-сервера автентифікації NPS.

Якщо NPS знаходиться на XSP R22 або XSP R23.

6

Налаштуйте NPS для використання проксі-сервера автентифікації NPS:

  • Приєднати технічну підтримку від NPS

  • Запит облікового запису CI OAuth

  • Створіть обліковий запис CI на NPS та налаштуйте тайм-аут токена оновлення

  • Додайте ідентифікатори додатків Android

  • Додайте ідентифікатори додатків iOS

  • Перевірка/встановіть URL-адреси та таймаути підключення

  • Додавання програм до списку дозволів AS

  • (Повторно) Увімкнути FCMv1

  • Перезапустіть XSP/ADP

  • Тестування ПН для додатків iOS та Android

Завжди потрібно.

7

Видаліть клавіші застарілого режиму FCM.

Для програм, які успішно підтримуються NPS на FCMv1.

Перенесення програм BroadWorks Collaborate для iOS на HTTP/2

Це завдання є обов'язковим для push-сповіщень до програм UC-One SaaS та Webex на платформах iOS.

Перш ніж почати

Якщо у вашому XSP працює R22, вам потрібно застосувати ap354313, перш ніж ви зможете налаштувати програму NPS на використання HTTP/2 для APNS.

1

Встановіть виробничу URL-адресу та параметри підключення за адресою x sp_cli/Applications/NotificationPushServer/APNS/Production>

встановити URL-адресу https://api.push.apple.com/3/device

Набір підключенняБасейнРозмір 2

встановити підключенняТаймаут 3000

встановити неробочий час підключення в секундах 600

Примітка: Не встановлюйте тайм-аут підключення нижче 1000.

2

Додайте ідентифікатори програми до контексту програм APNS, не забудьте пропустити ключ Auth — встановіть його на порожній.

Для SaaS UC-One: X SP_CLI/Додатки/ПовідомленняPushServer/APNS/Виробництво/Токени> додати com.broadsoft.uc-one

Для програми Webex: XSP _CLI/Додатки/ПовідомленняPushServer/APNS/Виробництво/Токени> додати com.cisco.squared

3

Перевірте ключі авторизації за допомогою XSP_CLI/Додатки/NotificationPushServer/APNS/Виробництво/токени> отримати

4

Якщо ключ авторизації не порожній для com.broadsoft.uc-one, ви можете очистити його за допомогою XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> очистити аутентифікаційний ключ

5

Увімкнути HTTP/2:

xsp_CLI /Програми/ПовідомленняPushServer/APNS/Загальні Налаштування> встановити HTTP2Enabled true

6

Тільки для програм SaaS UC-One: увійдіть на портал торгового посередника та перейдіть до Кон фігурації> BroadWorks >.

7

Прокрутіть униз до розділу Push Server повідомлень і виберіть свій випуск (наприклад, випуск 22), а потім дотримуйтесь інструкцій, наведених на порталі.

Міграція програм BroadWorks UC-One Connect/SaaS для Android до FCMv1

  • Це завдання стосується NPS на XSP. Ігноруйте це, якщо ваш NPS знаходиться на ADP.

  • Цю процедуру можна використовувати для переходу на сповіщення FCMv1 для програм UC-One Connect або UC-One SaaS для Android.

  • Ви повинні використовувати FCMv1, якщо ви хочете використовувати проксі-сервер NPS для автентифікації push-сповіщень у програмах UC-One або Webex для Android.

  • Це завдання готує NPS для FCMv1, щоб ви могли ввімкнути його як частину конфігурації проксі-сервера автентифікації NPS. Не вмикайте FCMv1, поки не будете готові налаштувати проксі-сервер автентифікації NPS, інакше сповіщення клієнтам SaaS не вдасться.

1

Отримати ідентифікатор проекту з консолі Firebase:

  1. Увійдіть на console.firebase.google.com.

  2. Виберіть проект додатка UC-One (Connect або SaaS), відкрийте його налаштування проекту.

  3. Відкрийте вклад ку Заг альні та запишіть ID проекту.

2

Отримайте приватний ключ облікового запису служби у Firebase:

  1. Перейдіть на вкладку Службові облікові записи в налаштуваннях проекту.

  2. Або створіть новий обліковий запис служби та отримайте його приватний ключ.

  3. Або відкрити існуючий обліковий запис сервісу і створити для нього новий закритий ключ.

    Примітка: обліковий запис служби повинен мати дозвіл firebasead min-sdk.

  4. Завантажте ключ у захищене місце.

3

Скопіюйте ключ до XSP, де розміщується ваш NPS.

4

Додайте ідентифікатор проекту та пов'язаний закритий ключ до контексту проектів FCM:

xsp_CLI /Додатки/ПовідомленняPushServer/FCM/Проекти> додати шлях ідентифікатора проекту/до/файла ключа

5

Додайте програму UC-One (Connect або SaaS) та пов'язаний ідентифікатор проекту до контексту програм FCM:

xsp_CLI/Додатки/ПовідомленняPushServer/FCM/Додатки> додати ідентифікатор додатка com.broadsoft.connect ID проекту ID

6

Перевірте конфігурацію для FCM з атрибутами та рекомендованими значеннями, показаними тут. Скорист ай теся встановленою версією команди, щоб змінити значення, якщо це необхідно:

Запустіть XSP _CLI/Додатки/ПовідомленняPushServer/FCM> отримати

Параметр

Рекомендоване значення

Авторська адреса URL

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

Пушхурл

https://fcm.googleapis.com/v1/projects/ Ідентифікатор проекту /повідомлення:надіслати

сфера застосування

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

ТокениТимОліва в секундах

3600

ПідключенняРозмір басейну

10

Час відключення в мілісекундах

3000

ПідключенняНевільний час очікування в секундах

600

Міграція програм BroadWorks UC-One Connect/SaaS для Android до FCMv1 (на ADP)

  • Це завдання стосується NPS на ADP. Ігноруйте його, якщо ваш NPS знаходиться на XSP.

  • Цю процедуру можна використовувати для переходу на сповіщення FCMv1 для програм UC-One Connect або UC-One SaaS для Android.

  • Ви повинні використовувати FCMv1, якщо ви хочете використовувати проксі-сервер NPS для автентифікації push-сповіщень у програмах UC-One або Webex для Android.

  • Це завдання готує NPS для FCMv1, щоб ви могли ввімкнути його як частину конфігурації проксі-сервера автентифікації NPS. Не вмикайте FCMv1, поки не будете готові налаштувати проксі-сервер автентифікації NPS, інакше сповіщення клієнтам SaaS не вдасться.

1

Отримати ідентифікатор проекту з консолі Firebase:

  1. Увійдіть на console.firebase.google.com.

  2. Виберіть проект додатка UC-One (Connect або SaaS), відкрийте його налаштування проекту.

  3. Відкрийте вклад ку Заг альні та запишіть ID проекту.

2

Отримайте приватний ключ облікового запису служби у Firebase:

  1. Перейдіть на вкладку Службові облікові записи в налаштуваннях проекту.

  2. Або створіть новий обліковий запис служби та отримайте його приватний ключ.

  3. Або відкрити існуючий обліковий запис сервісу і створити для нього новий закритий ключ.

    Примітка: обліковий запис служби повинен мати дозвіл firebasead min-sdk.

  4. Завантажте ключ (файл.json) у захищене місце.

3

Імпортуйте файл.json на сервер ADP /bw/install.

4

Увійдіть до ADP CLI та додайте ключ проекту та API до контексту проектів FCM:

adp_cli/Додатки/ПовідомленняPushServer/FCM/Проекти> додати connect-ucaas /bw/install/ім'я файлу.json

5

Додайте ідентифікатор програми та проекту до контексту програм FCM:

adp_cli/Додатки/ПовідомленняPushServer/FCM/Додатки> додати ідентифікатор додатка com.broadsoft.ucaas.connect 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 або BroadWorks Connect для Android.

  • Ви вже перевірили, що push-сповіщення про виклики в інші програми працюють з FCMv1 API.

Ви тимчасово вимикаєте FCMv1, оскільки ключі FCMv1 для цих програм повинні бути ввімкнені лише під час процесу налаштування про ксі-сервера автентифікації NPS.

1

Увійдіть у XSP, де розміщується ваш спільний NPS.

2

Перейдіть до контексту FCM та вимкніть FCM v1: xsp_CLI/Applications/NotificationPushServer/fcm> встановити V1enabled false, щоб повернутися до використання застарілого ключа API FCM.

Встановіть патчі проксі автентифікації NPS

Налаштування NPS для використання проксі-сервера аутентифікації

1

Створіть запит на обслуговування зі своїм контактом для впровадження або за допомогою TAC, щоб надати обліковий запис клієнта OAuth (спільна ідентичність Webex). Назвіть запит на службу Конфігура ція NPS для налаштування проксі-сервера авторизації.

Ми надаємо вам ідентифікатор клієнта OAuth, секрет клієнта та маркер оновлення, який діє протягом 60 днів. Якщо термін дії токена закінчується до того, як ви використовуєте його зі своїм NPS, ви можете підняти інший запит.
2

Створіть обліковий запис клієнта на НПС:

XSP_CLI /Програми/ПовідомленняPushServer/Ciscoci/Клієнт> встановити клієнт-ідентифікатор клієнта з-кроку1

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/Додатки/ПовідомленняPushServer/Ciscoci/Клієнт> отримати

3

Введіть URL-адресу проксі-сервера NPS та встановіть інтервал оновлення токена (рекомендується 30 хвилин):

Регіональні FQDNS:

Схід США:

XSP_CLI /Додатки/ПовідомленняPushServer/CloudNPSService> встановити URL-адресу https://broadworks-idp-proxy-a.wbx2.com/nps/

Захід США:

XSP_CLI /Додатки/ПовідомленняPushServer/CloudNPSService> встановити URL-адресу https://broadworks-idp-proxy-r.wbx2.com/nps/

Європа:

XSP_CLI /Додатки/ПовідомленняPushServer/CloudNPSService> встановити URL-адресу https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI /Додатки/ПовідомленняPushServer/CloudnpsService> встановити VoipTokenRefreshInterval 1800

Саудівська Аравія:

XSP_CLI /Додатки/ПовідомленняPushServer/CloudNPSService> встановити URL-адресу https://broadworks-idp-proxy-d.wbx2.com/nps/

Австралія:

XSP_CLI /Додатки/ПовідомленняPushServer/CloudNPSService> встановити URL-адресу https://broadworks-idp-proxy-m.wbx2.com/nps/

Якщо тайм-аут push-повідомлень через затримку вирішення DNS, збільште значення тайм-ауту у файлі «/etc/resolv.conf» на сервері BroadWorks.

4

(Для сповіщень Android) Додайте ідентифікатори додатків Android до контексту програм FCM на NPS.

Для програми Webex на Андроїд: XSP _CLI/Додатки/ПовідомленняPushServer/FCM/Додатки> додати com.cisco.wx2.android

Для програми UC-One на Андроїд: X SP_CLI/Додатки/ПовідомленняPushServer/FCM/Додатки> додати com.broadsoft.connect

5

(Для Apple iOS сповіщень) Додайте ідентифікатор програми до контексту програм APNS, не забудьте пропустити ключ Auth — встановіть його на порожній.

Для програми Webex на iOS: XSP _CLI/Додатки/ПовідомленняPushServer/APNS/Виробництво/Токени> додати com.cisco.squared

Для програми UC-One на iOS: X SP_CLI/Додатки/ПовідомленняPushServer/APNS/Виробництво/Токени> додати com.cisco.squared

6

Налаштуйте наступні URL-адреси NPS:

Контекст CLI XSP

Параметр

Значення

XSP_CLI/Додатки/ПовідомленняPushServer/FCM>

Авторська адреса URL

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

Пушхурл

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

сфера застосування

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

XSP_CLI/Додатки/ПовідомленняPushServer/APNS/Виробництво>

URL-адреса

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

7

Налаштуйте наступні параметри підключення NPS до рекомендованих показаних значень:

Контекст CLI XSP

Параметр

Значення

XSP_CLI/Додатки/ПовідомленняPushServer/FCM>

ТокениТимОліва в секундах

3600

ПідключенняРозмір басейну

10

Час відключення в мілісекундах

3000

ПідключенняНевільний час очікування в секундах

600

XSP_CLI/Додатки/ПовідомленняPushServer/APNS/Виробництво>

ПідключенняТаймаут

3000

ПідключенняРозмір басейну

2

ПідключенняНевільний час очікування в секундах

600

8

Перевірте, чи сервер додатків перевіряє ідентифікатори програм, тому що вам може знадобитися додати програми Webex до списку дозволів:

  1. Запустіть as_CLI/System/PushNotification> get і перевірте значення EnforceAllowedApplicationList. Якщо це правда, вам потрібно виконати це підзавдання. В іншому випадку пропустіть решту підзавдання.

  2. as_CLI/система/Push Notification/дозволені додатки> додати com.cisco.wx2.android «Webex Android»

  3. as_CLI/System/Push Notification/Дозволені додатки> додати com.cisco.squared «Webex iOS»

Перезапустіть NPS та перевірте push-сповіщення

1

Перезапустіть XSP:

перезапуск
2

Перевірте повідомлення про дзвінки на Android, здійснюючи дзвінки від абонента BroadWorks клієнту, що телефонує на Android. Переконайтеся, що на пристрої Android з'являється сповіщення про дзвінок.

Примітка: Якщо push-сповіщення починають виходити з ладу для програми UC-One android, можливо, є неправильна конфігурація. Якщо це ваша ситуація, ви можете повернутися до застарілого FCM наступним чином:

  1. Вимкнути FCMv1: XSP _CLI/Додатки/ПовідомленняPushServer/FCM> встановити V1Enabled false

  2. Перезапустити XSP: bwrestart

  3. Перевірте свою конфігурацію.

  4. Повторно увімкніть FCMv1 і перезапустіть XSP.

  5. Повторіть тест.

3

Перевірте сповіщення про дзвінки на iOS, здійснюючи дзвінки від абонента BroadWorks клієнту, що телефонує на iOS. Переконайтеся, що на пристрої iOS з'являється сповіщення про дзвінок.

Примітка: Якщо push-сповіщення починають виходити з ладу для програми UC-One iOS, можливо, є неправильна конфігурація. Якщо це ваша ситуація, ви можете повернутися до застарілого двійкового інтерфейсу із встановленням http2enabled false

Чи була ця стаття корисною?
Чи була ця стаття корисною?