Actualizar Cisco BroadWorks NPS para usar el proxy NPS: Guía de configuración

Descripción general del proxy de autenticación NPS

Este artículo describe cómo configurar un NPS compartido para usar el proxy de autenticación NPS, de modo que también se pueda usar para enviar notificaciones de llamadas a aplicaciones Webex. Si su NPS no es compatible con otras aplicaciones, puede seguir el procedimiento simplificado de la Guía de soluciones de Webex para BroadWorks.

Descripción general del proxy NPS

Para la compatibilidad con Webex para BroadWorks, su NPS debe ser parcheado para admitir la función NPS Proxy, Push Server para VoIP en UCaaS.

La función implementa un nuevo diseño en el servidor de notificaciones push para resolver la vulnerabilidad de seguridad de compartir claves privadas de certificados de notificación push con proveedores de servicios para clientes móviles. En lugar de compartir certificados y claves de notificación 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 APN de Apple y los servicios de Google FCM.

La función también mejora la capacidad del servidor de notificaciones push para enviar notificaciones a dispositivos Android a través de la nueva API HTTPv1 de Google Firebase Cloud Messaging (FCM).

Para obtener más información, consulte la descripción de la función Servidor Push para VoIP en 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 NPS

El XSP (o plataforma de entrega de aplicaciones ADP) que aloja NPS debe cumplir los siguientes requisitos:

Versiones mínimas y restricciones de co-residencia

NPS debe estar activado en un XSP/ADP dedicado y NPS debe ser la única aplicación alojada en el servidor. Esto es para eliminar la interferencia con la entrega de notificaciones push.
Solo debería haber una aplicación NPS en una implementación. Si utiliza UC-One Collaborate/Connect móvil y/o UC-One SaaS, 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 R21 si el 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 compartido

Lea estas notas antes de configurar su NPS compartido para usar el proxy NPS:

Si su NPS se usa con otras aplicaciones (no solo la aplicación Webex): Primero configure el proxy NPS y luego cambie el NPS de usar la API heredada de FCM a usar la API HTTP v1 de FCM.
Una vez que haya verificado que las notificaciones funcionan correctamente para aplicaciones antiguas con el proxy NPS, elimine la clave API de FCM para la aplicación Android y la clave de auth APNs para la aplicación iOS.

APN HTTP/2

Si ha implementado alguna aplicación iOS que no sea de Cisco/BroadSoft, configure esas aplicaciones para usar el protocolo APNS HTTP/2 antes de configurar NPS para usar el proxy NPS.
Los XSP/ADP que ya admiten 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 HTTP/2 al servidor push de notificaciones para APNS (la migración de NPS para admitir estas aplicaciones iOS se resume en este artículo).

Android FCMv1

Si ha implementado alguna aplicación de Android que no sea de Cisco/BroadSoft, configure esas aplicaciones para usar las claves FCMv1 antes de configurar NPS para usar el proxy NPS.
Si XSP/ADP admite actualmente la aplicación Connect o UC-One SaaS, habilite las claves FCMv1 después de configurar el proxy NPS. Le recomendamos que migre todas las aplicaciones adicionales a claves FCMv1, habilite y pruebe, luego deshabilite hasta que esté listo para completar las instrucciones de configuración (el flujo de migración está documentado en este artículo).

Resumen de migración de proxy NPS

***Resumen visual de la migración al proxy de autenticación NPS***

Tabla 1. Resumen de las tareas para migrar a NPS Proxy
Secuencia	Título de la tarea	¿Cuándo y por qué se requiere una tarea?
1	Migre NPS a HTTP/2 para aplicaciones UC-One SaaS (o Connect) iOS.	Si el NPS admite esas aplicaciones y aún no están configuradas para HTTP/2.
2	Migre NPS a FCMv1 para aplicaciones de Android UC-One SaaS (o Connect).	Si el NPS admite esas aplicaciones y aún no están configuradas para FCMv1.
3	Habilite el modo FCMv1 y pruebe las notificaciones push.	Si el NPS es compatible con UC-One Connect y/u otras aplicaciones Android (que no sean de Cisco).
4	Vuelva a habilitar el modo heredado de FCM.	Si el NPS es compatible con UC-One SaaS. Si deja FCMv1 habilitado, antes de configurar el proxy NPS, las notificaciones push a UC-One SaaS comienzan a fallar.
5	Instale parches de proxy de autenticación NPS.	Si NPS está en XSP R22 o XSP R23.
6	Configure NPS para usar el proxy de autenticación NPS: Adjunte soporte técnico de NPS Solicite una cuenta CI OAuth Cree una cuenta CI en NPS y configure el tiempo de espera del token de actualización Agregar identificadores de aplicaciones de Android Agregar ID de aplicación iOS Comprobación y configuración de URL y tiempos de espera de conexión Agregar aplicaciones a la lista de permitido de AS (Re-) Habilitar FCMv1 Reinicie XSP/ADP Pruebe los PNs para aplicaciones iOS y Android	Siempre se requiere.
7	Quite las claves de modo heredado de FCM.	Para aplicaciones que son compatibles correctamente con NPS en FCMv1.

Migrar aplicaciones iOS de BroadWorks Collaborate a HTTP/2

Esta tarea es obligatoria para las notificaciones push a las aplicaciones UC-One SaaS y Webex en plataformas iOS.

Antes de comenzar

Si su XSP ejecuta R22, debe aplicar ap354313 antes de poder configurar la aplicación NPS para que use HTTP/2 para APNS.

1	Establezca la URL de producción y los parámetros de conexión en `XSP_CLI/Applications/NotificationPushServer/APNS/Production>` `establecer la URL https://api.push.apple.com/3/device` `establecer ConnectionPoolSize 2` `establecer ConnectionTimeout 3000` `establecer el tiempo de espera del límite de conexión en segundos 600` Nota: No establezca el tiempo de espera de conexión por debajo de 1000.
2	Agregue los ID de aplicación al contexto de aplicaciones APNS, asegurándose de omitir la clave de Auth, configurándola en vacía. `Para UC-One SaaS: XSP_CLI/Applications/NotificationPushServer/APNS/Producción/Tokens> agregar com.broadsoft.uc-one` Para la aplicación Webex: `XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens>` agregar com.cisco.squared
3	`Compruebe las claves de auth con XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> get`
4	`Si la clave de autenticación no está vacía para com.broadsoft.uc-one, puede borrarla con XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> borrar la clave de autenticación`
5	Habilitar HTTP/2: `XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings>` `establecer HTTP2Enabled True`
6	Solo para aplicaciones UC-One SaaS: Inicie sesión en el portal del distribuidor y vaya a Configuración > BroadWorks >.
7	Desplácese hacia abajo hasta la sección Servidor de notificaciones push y seleccione su versión (por ejemplo, la versión 22) y, a continuación, siga las instrucciones proporcionadas en el portal.

Migrar aplicaciones BroadWorks UC-One Connec/SaaS Android a FCMv1

Esta tarea se aplica a NPS en XSP. Ignore si su NPS está en ADP.
Puede utilizar este procedimiento para migrar a notificaciones FCMv1 para aplicaciones de Android UC-One Connect o UC-One SaaS.
Debe usar FCMv1 si desea usar el proxy NPS para autenticar las notificaciones push en UC-One o las aplicaciones Webex Android.
Esta tarea prepara el NPS para FCMv1 para que pueda habilitarlo como parte de la configuración del proxy de autenticación NPS. No habilite FCMv1 hasta que esté listo para configurar el proxy de autenticación NPS, o las notificaciones a los clientes SaaS fallarán.

Obtenga el ID del proyecto de Firebase Console:

Inicie sesión en console.firebase.google.com.
Seleccione el proyecto de la aplicación UC-One (Connect o SaaS), abra la configuración del proyecto.
Abra la pestaña General y registre el ID del proyecto.

Obtenga la clave privada de su cuenta de servicio de Firebase:

Vaya a la pestaña Cuentas de servicio en la configuración del proyecto.
O cree una nueva cuenta de servicio y obtenga su clave privada.
O abra una cuenta de servicio existente y genere una nueva clave privada para ella.

Nota: La cuenta de servicio debe tener el permiso firebaseadmin-sdk.
Descargue la llave de un lugar seguro.

Copie la clave del XSP que hospeda su NPS.

Agregue el ID del proyecto y la clave privada asociada al contexto de los proyectos de FCM:

XSP_CLI/Applications/NotificationPushServer/FCM/Projects> agregar ruta de identificación de proyecto/archivo clave

Agregue la aplicación UC-One (Connect o SaaS) y el ID de proyecto asociado al contexto de aplicaciones de FCM:

xsp_CLI/Aplicaciones/NotificationPushServer/FCM/Aplicaciones> agregar ID de aplicación com.broadsoft.connect ProjectId project-id

Verifique la configuración de FCM con los atributos y valores recomendados que se muestran aquí. Utilice set version del comando para cambiar los valores si es necesario:

Ejecute XSP_CLI/Aplicaciones/NotificationPushServer/FCM> obtener

Parámetro	Valor recomendado
`AuthURL`	`https://www.googleapis.com/oauth2/v4/token`
`URL push`	`https://fcm.googleapis.com/v1/projects/ ID DEL PROYECTO /mensajes:enviar`
`alcance`	`https://www.googleapis.com/auth/firebase.messaging`
`Toque tiempo para vivir en segundos`	3600
`Tamaño de la piscina de conexión`	10
`Tiempo de espera de conexión en milisegundos`	3000
`Tiempo de espera del límite de conexión en segundos`	600

Migrar aplicaciones BroadWorks UC-One Connec/SaaS Android a FCMv1 (en ADP)

Esta tarea se aplica a NPS en ADP. Ignore si su NPS está en XSP.
Puede utilizar este procedimiento para migrar a notificaciones FCMv1 para aplicaciones de Android UC-One Connect o UC-One SaaS.
Debe usar FCMv1 si desea usar el proxy NPS para autenticar las notificaciones push en UC-One o las aplicaciones Webex Android.
Esta tarea prepara el NPS para FCMv1 para que pueda habilitarlo como parte de la configuración del proxy de autenticación NPS. No habilite FCMv1 hasta que esté listo para configurar el proxy de autenticación NPS, o las notificaciones a los clientes SaaS fallarán.

1	Obtenga el ID del proyecto de Firebase Console: Inicie sesión en console.firebase.google.com. Seleccione el proyecto de la aplicación UC-One (Connect o SaaS), abra la configuración del proyecto. Abra la pestaña General y registre el ID del proyecto.
2	Obtenga la clave privada de su cuenta de servicio de Firebase: Vaya a la pestaña Cuentas de servicio en la configuración del proyecto. O cree una nueva cuenta de servicio y obtenga su clave privada. O abra una cuenta de servicio existente y genere una nueva clave privada para ella. Nota: La cuenta de servicio debe tener el permiso firebaseadmin-sdk. Descargue la clave (archivo.json) a una ubicación segura.
3	`Importe el archivo.json al servidor ADP /bw/install.`
4	Inicie sesión en ADP CLI y agregue el proyecto y la clave API al contexto de proyectos de FCM: `ADP_CLI/Aplicaciones/NotificationPushServer/FCM/Projects> agregar connect-ucaas/bw/install/ nombre de archivo.json`
5	Agregue la solicitud y el ID del proyecto al contexto de aplicaciones de FCM: `ADP_CLI/Aplicaciones/NotificationPushServer/FCM/Aplicaciones> agregar ID de aplicación com.broadsoft.ucaas.connect ProjectId project-id`
6	Verifique su configuración: `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`

Vuelva a habilitar el modo heredado de FCM

Solo necesita hacer esto (como parte de la migración) si:

Su NPS se utiliza para aplicaciones de Android UC-One SaaS o BroadWorks Connect.
Ya probó que las notificaciones push de llamadas a otras aplicaciones funcionan con la API FCMv1.

Deshabilita temporalmente FCMv1 porque las claves FCMv1 para estas aplicaciones solo deben habilitarse durante el proceso de configuración del proxy de autenticación NPS.

1	Inicie sesión en el XSP que hospeda su NPS compartido.
2	Navegue hasta el contexto de FCM y deshabilite FCM v1: `XSP_CLI/Applications/NotificationPushServer/FCM>` establezca V1Enabled false para volver a usar la clave API heredada de FCM.

Instalar parches de proxy de autenticación NPS

Instale los siguientes parches para admitir la función proxy de autenticación NPS:

Parches R22

Parches R23

Configurar NPS para usar el proxy de autenticación

Cree una solicitud de servicio con su contacto de incorporación, o con TAC, para aprovisionar su cuenta de cliente de OAuth (Webex Common Identity). Título de su solicitud de servicio Configuración de NPS para la configuración del proxy de autenticación.

Le damos una identificación de cliente de OAuth, un secreto del cliente y un token de actualización que es válido por 60 días. Si el token expira antes de que lo use con su NPS, puede hacer otra solicitud.

Cree la cuenta de cliente en el NPS:

XSP_CLI/Aplicaciones/NotificationPushServer/CiscoCI/Client> establecer el ID de cliente desde el paso 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

Ejecute el comando para verificar que los valores que ha introducido coinciden con los que se le han proporcionado. XSP_CLI/Aplicaciones/NotificationPushServer/CISCOCI/Cliente> obtener

Introduzca la URL del proxy NPS y establezca el intervalo de actualización del token (se recomienda 30 minutos):

FQDN basados en la región:

Este de EE. UU.:

XSP_CLI/Aplicaciones/NotificationPushServer/CloudNPSService> establecer URL https://broadworks-idp-proxy-a.wbx2.com/nps/

EE.UU. Oeste:

XSP_CLI/Aplicaciones/NotificationPushServer/CloudNPSService> establecer URL https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

XSP_CLI/Aplicaciones/NotificationPushServer/CloudNPSService> establecer URL https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Aplicaciones/Servidor Push/Servicio NPSen la Nube> establecer el intervalo de actualización de VoIP Token1800

Arabia Saudita:

XSP_CLI/Aplicaciones/NotificationPushServer/CloudNPSService> establecer URL https://broadworks-idp-proxy-d.wbx2.com/nps/

Australia:

XSP_CLI/Aplicaciones/NotificationPushServer/CloudNPSService> establecer URL https://broadworks-idp-proxy-m.wbx2.com/nps/

Si las notificaciones push se agotan debido a un retraso en la resolución DNS, aumente el valor de tiempo de espera en el archivo “/etc/resolv.conf” en el servidor de BroadWorks.

(Para notificaciones de Android) Agregue los ID de aplicación de Android al contexto de aplicaciones FCM en el NPS.

Para la aplicación Webex en Android: XSP_CLI/Applications/NotificationPushServer/FCM/Applications> agregar com.cisco.wx2.android

Para la aplicación UC-One en Android: XSP_CLI/Applications/NotificationPushServer/FCM/Applications> agregar com.broadsoft.connect

(Para Apple iOS notificaciones) Agregue el ID de la aplicación al contexto de aplicaciones APNS, asegurándose de omitir la clave Auth; póngalo en vacío.

Para la aplicación Webex en iOS: XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> agregar com.cisco.squared

Para la aplicación UC-One en iOS: XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> agregar com.cisco.squared

Configure las siguientes URL de NPS:

Contexto de la CLI de XSP	Parámetro	Valor
`XSP_CLI/Aplicaciones/Servidor Push/FCM>`	`AuthURL`	`https://www.googleapis.com/oauth2/v4/token`
	`URL push`	`https://fcm.googleapis.com/v1/projects//messages:send`
	`alcance`	`https://www.googleapis.com/auth/firebase.messaging`
`XSP_CLI/Aplicaciones/Servidor Push de Notificación/APNS/Producción>`	`URL`	`https://api.push.apple.com/3/device`

Configure los siguientes parámetros de conexión NPS a los valores recomendados que se muestran:

Contexto de la CLI de XSP	Parámetro	Valor
`XSP_CLI/Aplicaciones/Servidor Push/FCM>`	`Toque tiempo para vivir en segundos`	3600
	`Tamaño de la piscina de conexión`	10
	`Tiempo de espera de conexión en milisegundos`	3000
	`Tiempo de espera del límite de conexión en segundos`	600
`XSP_CLI/Aplicaciones/Servidor Push de Notificación/APNS/Producción>`	`Tiempo de espera de conexión`	3000
	`Tamaño de la piscina de conexión`	2
	`Tiempo de espera del límite de conexión en segundos`	600

Compruebe si el servidor de aplicaciones está comprobando los ID de las aplicaciones, ya que es posible que necesite agregar las aplicaciones Webex a la lista de permitido:

Ejecute as_CLI/System/PushNotification> obtener y verificar el valor de EnforceAllowedApplicationList. Si es cierto, tiene que completar esta subtarea. De lo contrario, omita el resto de la subtarea.
as_CLI/System/PushNotification/AllowedApplications> agregar com.cisco.wx2.android “Webex Android”
as_CLI/System/PushNotification/AllowedApplications> agregar com.cisco.squared “Webex iOS”

Reinicie NPS y pruebe las notificaciones push

1	Reinicie el XSP: `bwrestart`
2	Pruebe las notificaciones de llamadas a Android haciendo llamadas desde un suscriptor de BroadWorks al cliente que llama en Android. Verifique que la notificación de llamada aparezca en el dispositivo Android. Nota: Si las notificaciones push comienzan a fallar para la aplicación UC-One Android, es posible que haya una configuración incorrecta. Si esta es su situación, puede volver al FCM heredado de la siguiente manera: `Deshabilitar FCMv1: XSP_CLI/Applications/NotificationPushServer/FCM> establecer V1Habilitado como falso` `Reiniciar XSP: bwrestart` Compruebe su configuración. Vuelva a habilitar FCMv1 y reinicie el XSP. Repetir la prueba.
3	Pruebe las notificaciones de llamadas a iOS realizando llamadas desde un suscriptor de BroadWorks al cliente que llama en iOS. Verifique que la notificación de llamada aparezca en el dispositivo iOS. Nota: Si las notificaciones push comienzan a fallar para la aplicación UC-One iOS, es posible que haya una configuración incorrecta. Si esta es su situación, puede volver a la interfaz binaria heredada con `set HTTP2Enabled` false

Cisco AI Assistant

Gracias por sus comentarios.