- Inicio
- /
- Artículo
Aprenda cómo actualizar Cisco BroadWorks NPS para utilizar NPS Proxy con esta guía de configuración . Descubra instrucciones paso a paso, consideraciones y mejores prácticas para una integración perfecta y un rendimiento de red mejorado.
Descripción general del proxy de autenticación de NPS
Este artículo describe cómo configurar un NPS compartido para utilizar el proxy de autenticación de NPS, para que también se pueda utilizar para enviar notificaciones de llamadas a aplicaciones de Webex. Si su NPS no admite otras aplicaciones, puede seguir el procedimiento simplificado en la Guía de soluciones de Webex para BroadWorks.
Descripción general del proxy de NPS
Para ser compatible con Webex para BroadWorks, se debe instalar una revisión de NPS para admitir la característica de proxy de NPS y el servidor push VoIP en UCaaS.
La característica implementa un nuevo diseño en el servidor de push de notificación para resolver la vulnerabilidad de seguridad de compartir claves privadas del certificado de notificación emergente con proveedores de servicios para clientes móviles. En lugar de compartir certificados y claves de notificaciones push con el proveedor de servicios, el NPS utiliza una nueva API para obtener un token de notificación push de corta duración del backend de UCaaS, y utiliza este token para la autenticación con los servicios APNs de Apple y FCM de Google.
La característica también mejora la capacidad del servidor de push de notificación para enviar notificaciones a los dispositivos Android a través de la nueva API de Mensajería en la nube de Google Firebase (FCM) HTTPv1.
-
Para obtener más información, consulte el servidor de push para VoIP descripción de la característica UCaaS.
-
Los parches de BroadWorks para la función están disponibles en: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
-
Puede encontrar más información sobre el servidor ADP en Cisco BroadWorks Application Delivery Platform.
Requisitos previos del proxy de autenticación de NPS
El ADP de la plataforma de entrega de aplicaciones (XSP) que organiza NPS debe cumplir con los siguientes requisitos:
Restricciones de residencia en colaboración y versiones mínimas
-
NPS debe activarse en un XSP/ADP dedicado y NPS debe ser la única aplicación alojada en el servidor. Esto es para eliminar interferencia con la entrega de las notificaciones de Push.
-
Solo debe haber una aplicación NPS en una implementación. Si está usando saaS de colaboración/conexión de UC-One móviles o SaaS de UC-One, y está implementando Webex para BroadWorks, debe compartir este único NPS para todas las aplicaciones.
-
NPS debe estar en la versión R22 o posterior XSP, o ADP.
R22/R23 XSP es compatible con una pila de R21 si XSP solo ejecuta NPS y el AS es R21. SP1. Consulte la Matriz de compatibilidad de BroadWorks para obtener más información.
-
Puede encontrar más información sobre el servidor ADP en Cisco BroadWorks Application Delivery Platform.
NPS compartidos
Lea estas notas antes de configurar el servidor NPS compartido para usar el proxy de NPS:
-
Si su NPS se utiliza con otras aplicaciones (no solo con la aplicación Webex): Primero configure el proxy de NPS y, luego, cambie el NPS de uso de la API heredada de FCM a utilizar la API de FCM HTTP v1.
-
Una vez que hayas verificado que las notificaciones funcionan correctamente para las aplicaciones antiguas con el proxy NPS, elimina la clave API de FCM para la aplicación de Android y la clave de autenticación APNs para la aplicación de iOS.
APNs HTTP/2
-
Si has implementado alguna aplicación iOS que no sea de Cisco/BroadSoft, configure esas aplicaciones para que utilicen el HTTP/2 Protocolo APNS antes de configurar NPS para usar el proxy NPS.
-
Los XSP/ADP que ya son compatibles con la aplicación Collaborate o SaaS BroadWorks deben migrarse a HTTP/2. Para obtener información detallada sobre la configuración de HTTP/2, consulte Soporte para el servidor de push de notificaciones de HTTP/2 para APNS (la migración de NPS para admitir estas aplicaciones de iOS se resume en este artículo).
Android FCMv1
-
Si has implementado alguna aplicación de Android que no sea de Cisco/BroadSoft, Configure esas aplicaciones para que utilicen las claves FCMv1 antes de configurar NPS para que utilice el proxy NPS.
-
Si XSP/ADP Actualmente admite la aplicación SaaS Connect o UC-One, luego habilite las claves FCMv1 después de configurar el proxy NPS. Le recomendamos que migre todas las aplicaciones adicionales a claves FCMv1, las habilite y las pruebe, y luego las desactive hasta que esté listo para completar las instrucciones de configuración (el proceso de migración está documentado en este artículo).
Resumen de migración de proxy NPS

|
Secuencia |
Título de la tarea |
¿Cuándo/por qué se requiere la tarea? |
|---|---|---|
|
1 |
Migrar NPS a HTTP/2 para aplicaciones SaaS (o Connect) de UC-One para iOS. |
Si NPS es compatible con esas aplicaciones, y todavía no están configuradas para HTTP/2. |
|
2 |
Migrar NPS a FCMv1 para aplicaciones SaaS (o Connect) De UC-One para Android. |
Si NPS es compatible con esas aplicaciones, y todavía no están configuradas para FCMv1. |
|
3 |
Habilite el modo FCMv1 y pruebe las notificaciones de push. |
Si NPS es compatible con UC-One Connect y/u otras aplicaciones de Android (que no son de Cisco). |
|
4 |
Vuelva a habilitar el modo heredado de FCM. |
Si NPS es compatible con SaaS para UC-One. Si deja FCMv1 habilitado, antes de configurar el proxy de NPS, las notificaciones de push a SaaS de UC-One comienzan a fallar. |
|
5 |
Instale revisiones de proxy de autenticación de NPS. |
Si NPS está en XSP R22 o XSP R23. |
|
6 |
Configure NPS para usar el proxy de autenticación de NPS:
|
Siempre necesario. |
|
7 |
Elimine las claves de los modo heredados de FCM. |
Para aplicaciones que son compatibles con éxito por NPS en FCMv1. |
Migrar BroadWorks Colaborar aplicaciones iOS a HTTP/2
Esta tarea es obligatoria para las notificaciones de push en saaS de UC-One y aplicaciones Webex en plataformas iOS.
Antes de comenzar
Si su XSP está ejecutando R22, debe aplicar ap354313 antes de configurar la aplicación de NPS para utilizar HTTP/2 para APNS.
| 1 |
Defina la URL de producción y los parámetros de conexión en
Nota: No establezca el tiempo de espera de conexión por debajo de 1000. |
| 2 |
Agregue los IDs de la aplicación al contexto de las aplicaciones APNS, asegúrese de omitir la clave de autenticación y descúbala en vacía. Para SaaS de UC-One: Para la aplicación de Webex: |
| 3 |
Compruebe las claves de autenticación con |
| 4 |
Si la clave de autenticación no está vacía para |
| 5 |
Habilitar HTTP/2:
|
| 6 |
Solo para aplicaciones SaaS UC-One: Inicie sesión en el portal del revendedor y vaya a |
| 7 |
Desplácese hacia abajo hasta la sección Servidor de notificaciones push y seleccione su versión (por ejemplo Versión 22), luego siga las instrucciones proporcionadas en el portal. |
Migrar BroadWorks UC-One Connect/Aplicaciones SaaS para Android a FCMv1
-
Esta tarea se aplica a NPS en XSP. Omitirlo si su NPS está en ADP.
-
Puede utilizar este procedimiento para migrar a las notificaciones FCMv1 para las aplicaciones UC-One Connect o UC-One SaaS para Android.
-
Debe usar FCMv1 si quiere usar el proxy NPS para autenticar las notificaciones emergentes a UC-One o a las aplicaciones Webex para Android.
-
Esta tarea prepara NPS para FCMv1 para que pueda habilitarlo como parte de la configuración del proxy de autenticación de NPS. No habilite FCMv1 hasta que esté listo para configurar el proxy de autenticación de NPS, o las notificaciones a clientes SaaS fallarán.
| 1 |
Obtenga el ID del proyecto de la consola de Firebase: | ||||||||||||||||
| 2 |
Obtenga la clave privada de su cuenta de servicio de Firebase: | ||||||||||||||||
| 3 |
Copie la clave en el XSP que aloja sus NPS. | ||||||||||||||||
| 4 |
Agregue el ID del proyecto y la clave privada asociada al contexto de los proyectos FCM:
| ||||||||||||||||
| 5 |
Agregue la aplicación UC-One (Connect o SaaS) y el ID de proyecto asociado al contexto de las aplicaciones FCM:
| ||||||||||||||||
| 6 |
Verifique la configuración de FCM con respecto a los atributos y los valores recomendados que se muestran aquí. Utilice la versión Ejecutar
|
Migrar BroadWorks UC-One Connect/Aplicaciones SaaS para Android a FCMv1 (en ADP)
-
Esta tarea se aplica a NPS en ADP. Omitirlo si su NPS está en XSP.
-
Puede utilizar este procedimiento para migrar a las notificaciones FCMv1 para las aplicaciones UC-One Connect o UC-One SaaS para Android.
-
Debe usar FCMv1 si quiere usar el proxy NPS para autenticar las notificaciones emergentes a UC-One o a las aplicaciones Webex para Android.
-
Esta tarea prepara NPS para FCMv1 para que pueda habilitarlo como parte de la configuración del proxy de autenticación de NPS. No habilite FCMv1 hasta que esté listo para configurar el proxy de autenticación de NPS, o las notificaciones a clientes SaaS fallarán.
| 1 |
Obtenga el ID del proyecto de la consola de Firebase: |
| 2 |
Obtenga la clave privada de su cuenta de servicio de Firebase: |
| 3 |
Importa el archivo .json al servidor ADP |
| 4 |
Inicie sesión en la CLI de ADP y agregue el proyecto y la clave API al contexto de los proyectos FCM:
|
| 5 |
Agregue el ID de la aplicación y del proyecto al contexto de las aplicaciones FCM:
|
| 6 |
Verifique su configuración: |
Volver a habilitar el modo heredado FCM
Solo debe hacerlo (como parte de la migración) si:
-
Sus NPS se utilizan para las aplicaciones SaaS de UC-One o BroadWorks Connect para Android.
-
Ya probó que las notificaciones de push de llamadas a otras aplicaciones están funcionando con la API FCMv1.
Está deshabilitando temporalmente FCMv1 porque las claves FCMv1 para estas aplicaciones solo deben estar habilitadas durante el proceso de configuración del proxy de autenticación de NPS.
| 1 |
Inicie sesión en el XSP que aloja sus NPS compartidos. |
| 2 |
Navegue hasta el contexto DE FCM y deshabilite FCM v1: |
Instalar revisiones de proxy de autenticación de NPS
Instale las siguientes revisiones para admitir la característica de proxy de autenticación de NPS:
Revisiones R22
Revisiones R23
Configure NPS para usar un proxy de autenticación.
| 1 |
Cree una solicitud de servicio con su contacto de incorporación, o con TAC, para aprovisionar su cuenta de cliente de autenticación OAuth (Common Identity Webex Common Identity tac). Título de su solicitud de servicio Configuración de NPS para la configuración del proxy de autenticación. Te proporcionamos un ID de cliente OAuth, un secreto de cliente y un token de actualización válido durante 60 días. Si el token caduca antes de que usted lo utilice con su NPS, puede generar otra solicitud.
| |||||||||||||||||||
| 2 |
Cree la cuenta de cliente en NPS:
Ejecuta el comando para verificar que los valores que ingresaste coinciden con los que se te proporcionaron. | |||||||||||||||||||
| 3 |
Introduzca la URL del proxy de NPS y defina el intervalo de actualización del token (se recomiendan 30 minutos): Nombres de dominio completos (FQDN) basados en la región: Este de EE. UU.: Oeste de EE. UU.:
Europa:
Arabia Saudita:
Australia
Si las notificaciones push caducan debido a un retraso en la resolución DNS, aumente el valor de tiempo de espera en el "/etc/resolv.conf" archivo en el servidor de BroadWorks. | |||||||||||||||||||
| 4 |
(Para notificaciones de Android) Agregue los IDs de la aplicación de Android al contexto de las aplicaciones FCM en nps. Para la aplicación Webex en Android: Para la aplicación UC-One en Android: | |||||||||||||||||||
| 5 |
(Para notificaciones de Apple iOS) Agregue el ID de aplicación al contexto de las aplicaciones de APNS, asegúrese de omitir la clave de autenticación y descúbala en vacía. Para la aplicación Webex en iOS: Para la aplicación UC-One en iOS: | |||||||||||||||||||
| 6 |
Configure las siguientes URL de NPS:
| |||||||||||||||||||
| 7 |
Configure los siguientes parámetros de conexión NPS con los valores recomendados:
| |||||||||||||||||||
| 8 |
Compruebe si el servidor de aplicaciones es un IDs de aplicación móviles, ya que es posible que deba agregar las aplicaciones Webex a la lista de permitidos: |
Reiniciar NPS y probar notificaciones de push
| 1 |
Reinicie XSP: bwrestart |
| 2 |
Pruebe las notificaciones de llamadas a Android mediante la realización de llamadas de un suscriptor de BroadWorks al cliente de llamadas en Android. Verifique que la notificación de llamada aparezca en el dispositivo Android. Nota: Si las notificaciones emergentes comienzan a fallar para la aplicación uc-one para Android, es posible que se haya un error de configuración. Si esta es su situación, puede volver a la FCM heredada de la siguiente manera:
|
| 3 |
Pruebe las notificaciones de llamadas a iOS mediante la realización de llamadas desde un suscriptor de BroadWorks al cliente de llamadas en iOS. Verifique que la notificación de llamada aparezca en el dispositivo iOS. Nota: Si las notificaciones de push comienzan a fallar para la aplicación de iOS UC-One, es posible que se haya un error de configuración. Si esta es su situación, puede volver a la interfaz binario heredada con |