Configurar notificaciones push de llamadas para Webex BroadWorks
En este documento, utilizamos el término Servidor de push de notificaciones de llamadas (CALL Notifications Push Server, CNPS) para describir una aplicación alojada en XSP o alojada en ADP que se ejecuta en su entorno. Su CNPS funciona con su sistema de BroadWorks para estar al tanto de las llamadas entrantes a sus usuarios y envía notificaciones de dichas personas a los servicios de notificación de Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APNs).
Esos servicios notifican a los dispositivos móviles de Webex para los suscriptores de Cisco BroadWorks que tienen llamadas entrantes en Webex.
Para obtener más información sobre NPS, consulte la Descripción de la característica del servidor de push de notificación.
Un mecanismo similar en Webex funciona con los servicios de presencia y mensajería de Webex para enviar notificaciones a los servicios de notificaciones de Google (FCM) o Apple (APNS). Esos servicios, a su vez, notifican a los usuarios de Webex móviles sobre los cambios de presencia o mensajes entrantes.
Esta sección describe cómo configurar NPS para el proxy de autenticación cuando NPS aún no admite otras aplicaciones. Si necesita migrar un NPS compartido para usar el proxy NPS, consulte Actualización de Cisco BroadWorks NPS para usar el proxy NPS.
Descripción general del proxy de NPS
Para ser compatible con Webex para Cisco BroadWorks, se debe instalar una revisión de su CNPS para admitir la característica de proxy NPS, Push Server para 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 notificación de push con el proveedor de servicios, NPS utiliza una nueva API para obtener un token de notificación de push emergente breve de Webex para backend de Cisco BroadWorks, y usa este token para la autenticación con los servicios API de Apple y Google FCM.
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 esta función están disponibles en: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Para obtener software y parches de NPS, consulte la sección Prepare su NPS para Webex para Cisco BroadWorks.
Busque y descargue el parche desde la página de descarga de software.
-
Puede encontrar más información sobre el servidor ADP en Cisco BroadWorks Application Delivery Platform.
Consideraciones de APNS
Apple ya no será compatible con el protocolo binario basado en HTTP/1 en el servicio de notificación de push de Apple después del 31 de marzo de 2021. Le recomendamos que configure su XSP|ADP para utilizar el HTTP/2-based Interfaz para APN. Esta actualización requiere que su ADP XSP|que aloja el NPS ejecute R22 o posterior.
Prepare sus NPS para Webex para Cisco BroadWorks
| 1 |
Instale y configure una plataforma de entrega de aplicaciones (ADP) O XSP (versión mínima R22) exclusiva. |
| 2 |
Instale las revisiones del proxy de autenticación de NPS: Revisiones XSP R22: Revisiones XSP R23: |
| 3 |
Active la aplicación Notification Push Server. |
| 4 |
(Para notificaciones de Android) Habilite la API de FCM v1 en el NPS.
|
| 5 |
(Para notificaciones de Apple iOS) Habilite HTTP/2 en el servidor NPS.
Esto es exclusivo de la versión 22 y versiones anteriores; no está disponible en la versión 23 y versiones posteriores, que solo admiten HTTP/2. |
| 6 |
Adjunte un soporte técnico desde NPS XSP/ADP. |
| 7 |
En cada servidor AS, el archivo namedefs en Ejemplo: _pushnotification-cliente._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com EN A 10.193.78.149 Una vez configurado, se requiere uno de los siguientes para recoger los cambios:
|
Qué hacer a continuación
Para instalaciones nuevas de un NPS, vaya a Configurar NPS para usar proxy de autenticación
Para migrar una implementación de Android existente a FCMv1, vaya a Migrar NPS a FCMv1
Configurar NPS para usar el proxy de autenticación
Esta tarea se aplica a una nueva instalación de NPS, dedicado a Webex para Cisco BroadWorks.
Si desea configurar el proxy de autenticación en un NPS que se comparte con otras aplicaciones móviles, consulte Actualización de Cisco BroadWorks NPS para usar el proxy NPS.
| 1 |
Obtener credenciales de OAuth para su Webex para Cisco BroadWorks. | |||||||||||||||||||
| 2 |
Cree la cuenta de cliente en NPS:
Para verificar que los valores que introdujo coinciden con lo que se le ha dado, ejecute El emisorUrl de CiscoCI SIEMPRE debe ser el clúster de CI de EE. UU. independientemente de su ubicación y el valor predeterminado debe ser:
| |||||||||||||||||||
| 3 |
Introduzca la URL del proxy de NPS y defina el intervalo de actualización del token (se recomiendan 30 minutos):
Para mejorar la velocidad de resolución de DNS, en lugar del FQDN actual nps.uc-one.broadsoft.com le recomendamos que utilice el FQDN apropiado según su región. FQDN basados en regiones: Este de EE. UU.: Oeste de EE. UU.:
Europa:
Si las notificaciones push expiran debido a un retraso en la resolución de DNS, aumente el valor del tiempo de espera en el "/etc/resolv.conf" archivo en el servidor BroadWorks. | |||||||||||||||||||
| 4 |
(Para notificaciones de Android) Agregue el ID de la aplicación de Android al contexto de las aplicaciones FCM en el nps.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 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: | |||||||||||||||||||
| 9 |
Reinicie el XSP|ADP: | |||||||||||||||||||
| 10 |
Pruebe las notificaciones de llamadas haciendo llamadas de un suscriptor de BroadWorks a dos usuarios móviles de Webex. Verificar que la notificación de llamada aparezca en dispositivos iOS y Android. |
Migrar NPS a FCMv1
Este tema contiene procedimientos opcionales que puede usar en la consola FCM de Google cuando tiene una implementación de NPS existente que debe migrar a FCMv1. Existen tres procedimientos:
-
Migrar clientes de UC-One a FCMv1—Cuando tiene clientes UCaaS existentes y necesita migrarlos para usar FCMv1.
-
Migrar clientes SaaS a FCMv1—Cuando tiene clientes SaaS existentes y necesita migrarlos para usar FCMv1.
-
Actualizar servidor ADP—Cuando está migrando el NPS a un servidor ADP.
Migrar clientes de UC-One a FCMv1
Utilice los siguientes pasos en la consola de Google FCM para migrar clientes de UC-One a Google FCM HTTPv1.
Si se aplica la imagen de marca al cliente, el cliente debe tener el ID de remitente. En la consola de FCM, consulte Configuración . La configuración aparece en la tabla de credenciales del proyecto.
Para obtener más detalles, consulte la Guía de marca móvil de Connect en https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Consulte el parámetro gcm_defaultSenderId, que se encuentra en el archivo branding.xml de la carpeta de recursos del kit de marca, con la siguiente sintaxis:
xxxxxxxxxxxxx
-
Inicie sesión en el SDK de administración de FCM en http://console.firebase.google.com.
-
Seleccione la aplicación de Android adecuada.
-
En la ficha General, grabe el ID del proyecto
-
Diríjase a la ficha cuentas de servicio para configurar una cuenta de servicio. Puede crear una cuenta de servicio nueva o configurar una existente.
Para crear una cuenta de servicio nueva:
-
Haga clic en el botón azul para crear una cuenta de servicio nueva
-
Haga clic en el botón azul para generar una nueva clave privada
-
Descargar clave en una ubicación segura
Para volver a utilizar una cuenta de servicio existente:
-
Haga clic en el texto azul para ver las cuentas de servicio existentes.
-
Identificar la cuenta de servicio que se debe utilizar. La cuenta de servicio necesita permiso firebaseadmin-sdk.
-
A la derecha, haga clic en el menú hamburguesa y cree una nueva clave privada.
-
Descargue el archivo json que contiene la clave y guárdelo en una ubicación segura.
-
-
Copie el archivo json en el ADP XSP|.
-
Configure el ID del proyecto y :
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add -
Configurar la aplicación:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add projectId ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project -
Activar FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Ejecute el comando
bwrestartpara reiniciar el ADP XSP|.
Migrar clientes SaaS a FCMv1
Siga los siguientes pasos en la consola FCM de Google si desea migrar clientes SaaS a FCMv1.
Asegúrese de haber completado el procedimiento "Configurar NPS para utilizar el proxy de autenticación".
-
Desactivar FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Ejecute el comando
bwrestartpara reiniciar el ADP XSP|. -
Activar FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Ejecute el comando
bwrestartpara reiniciar el ADP XSP|.
Actualizar servidor de ADP
Utilice los siguientes pasos en la consola FCM de Google si está migrando el servidor NPS para utilizar un servidor ADP.
-
Obtenga el archivo JSON de la consola de Google Cloud:
-
En la consola de Google Cloud, vaya a la página Cuentas de servicio.
-
Haga clic en Seleccionar un proyecto , elija su proyecto y haga clic en Abrir .
-
Busque la fila de la cuenta de servicio para la que desea crear una clave, haga clic en el botón vertical Más y luego haga clic en Crear clave.
-
Seleccione un tipo de Clave y haga clic en Crear
Se descargará el archivo.
-
-
Agregue FCM al servidor de ADP:
-
Importe el archivo JSON al servidor ADP usando el comando
/bw/install. -
Inicie sesión en la CLI de ADP y agregue la clave de proyecto y API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
A continuación, agregue la aplicación y la clave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
Verifique la configuración:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
-