Configurar notificaciones push de llamadas para Webex BroadWorks

list-menu¿Comentarios?
Aprenda a configurar notificaciones push de llamadas para Webex para BroadWorks usando NPS para Android e iOS.

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.

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:

3

Active la aplicación Notification Push Server.

4

(Para notificaciones de Android) Habilite la API de FCM v1 en el NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Para notificaciones de Apple iOS) Habilite HTTP/2 en el servidor NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

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 /usr/local/broadworks/bw_base/conf debe configurarse con registros SRV y A para el servidor de inserción de notificaciones. (XSP/ADP) búsqueda, si son múltiples XSP/ADP Luego agregue una entrada para cada uno según sea necesario.

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:

  1. Se puede realizar un reinicio en una ventana de mantenimiento.

  2. A través de la CLI de Cisco BroadWorks:

    R24 y mayores

    AS_CLI/ASDiagnostic/DNS> volver a cargar

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> volver a cargar

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> volver a cargar

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:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Para verificar que los valores que introdujo coinciden con lo que se le ha dado, ejecute XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

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:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

3

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

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.:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

Oeste de EE. UU.:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

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.

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.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.

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

6

Configure las siguientes URL de NPS:

Contexto de CLI de ADP|XSP

Parámetro

Valor

  • XSP|ADP_CLI/Applications/NotificationPushServer/FCM>

authURL

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

pushURL

https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send

scope

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

  • XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production>

url

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

7

Configure los siguientes parámetros de conexión NPS con los valores recomendados:

Contexto de CLI de ADP|XSP

Parámetro

Valor

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

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:

  1. Ejecute AS_CLI/System/PushNotification> get y verifique el valor de enforceAllowedApplicationList. Si es true, debes completar esta subtarea. De lo contrario, omita el resto de la subtación.

  2. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

9

Reinicie el XSP|ADP: bwrestart

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

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 del proyecto > mensajería en la nube. 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

  1. Inicie sesión en el SDK de administración de FCM en http://console.firebase.google.com.

  2. Seleccione la aplicación de Android adecuada.

  3. En la ficha General, grabe el ID del proyecto

  4. 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:

    1. Haga clic en el botón azul para crear una cuenta de servicio nueva

    2. Haga clic en el botón azul para generar una nueva clave privada

    3. Descargar clave en una ubicación segura

    Para volver a utilizar una cuenta de servicio existente:

    1. Haga clic en el texto azul para ver las cuentas de servicio existentes.

    2. Identificar la cuenta de servicio que se debe utilizar. La cuenta de servicio necesita permiso firebaseadmin-sdk.

    3. A la derecha, haga clic en el menú hamburguesa y cree una nueva clave privada.

    4. Descargue el archivo json que contiene la clave y guárdelo en una ubicación segura.

  5. Copie el archivo json en el ADP XSP|.

  6. Configure el ID del proyecto y :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
  7. 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
  8. Activar FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Ejecute el comando bwrestart para 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".

  1. Desactivar FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Ejecute el comando bwrestart para reiniciar el ADP XSP|.

  3. Activar FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Ejecute el comando bwrestart para 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.

  1. Obtenga el archivo JSON de la consola de Google Cloud:

    1. En la consola de Google Cloud, vaya a la página Cuentas de servicio.

    2. Haga clic en Seleccionar un proyecto , elija su proyecto y haga clic en Abrir .

    3. 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.

    4. Seleccione un tipo de Clave y haga clic en Crear

      Se descargará el archivo.

  2. Agregue FCM al servidor de ADP:

    1. Importe el archivo JSON al servidor ADP usando el comando /bw/install.

    2. 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 :

    3. 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

    4. 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
¿Ha encontrado este artículo útil?
¿Ha encontrado este artículo útil?