Contenido

Requirements

Configuración

Establecer la URL para HTTP/2

Configurar las claves de autenticación

Agregar tokens para entornos de producción y desarrollo

Habilite HTTP/2 si utiliza XSP 2.0

Reiniciar BroadWorks

Resolución de problemas

Referencia

Connect Eval Client

Después del 31 de marzo de 2021, Notification Push Server (NPS) debe utilizar una interfaz HTTP/2 para comunicarse con el servicio Apple Push Notification (APNS). La interfaz HTTP/2 está disponible en la versión 22.0 de BroadWorks a través del parche ap354313 y la versión 23.0 sólo admite HTTP/2.

Si se ejecuta la versión 22.0 de BroadWorks, HTTP/2 se puede configurar con las siguientes instrucciones después de aplicar ap354313. Si actualiza a 23.0 o posterior, se necesitarán los siguientes pasos para configurar HTTP/2 para APNS.

Requirements

Debe estar en 22.0+ o 23.0 XSP. Un XSP 22.0/23.0 es compatible para ejecutarse en paralelo con una pila 21.sp1 si el XSP SOLAMENTE ejecuta NPS y el AS es 21.sp1. Consulte la matriz de compatibilidad de BroadWorks para obtener más información.

Para configurar HTTP/2, deberá saber qué clientes están en uso actualmente como ID de clave de autenticación, ID de equipo y clave de autenticación. Las aplicaciones configuradas en 21.sp1 se pueden encontrar aquí:

XSP_CLI/Applications/NotificationPushServer/APNS/Production/Certificate> get

- Cualquier aplicación iOS que no sea de Cisco/BroadSoft debe configurarse para utilizar el protocolo APNS HTTP/2.

- Las aplicaciones Collaboration o SaaS BroadWorks deben migrarse a HTTP/2.

- Agregar compatibilidad con HTTP/2 al servidor de inserción de notificaciones para APN

- Para los clientes SaaS, inicie sesión en el portal BAM → Configuración → BroadWorks, desplácese hacia abajo hasta la sección: Servidor de inserción de notificaciones, seleccione la versión adecuada en la lista desplegable y siga las instrucciones.

- Para Connect Eval Clients, abra un ticket con el TAC para solicitar las claves de autenticación, la ID de clave de autenticación y la ID de equipo. Tenga en cuenta que la ID de la aplicación, la ID de la clave de autenticación y la ID del equipo que se muestran a continuación pertenecen al cliente sin marca, si utiliza un cliente con marca, esta información deberá obtenerse de Apple para sus clientes.

Los tokens necesarios para otros clientes se pueden obtener del portal de desarrolladores de Apple, consulte la documentación de Apple aquí:

https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/...

Si actualiza o implementa una nueva versión 22.0, 23.0 o ADP, se requerirá la licencia necesaria.

Consulte también las notas de la versión correspondientes disponibles en Xchange para OS y requisitos de actualización.

Configuración

Asegúrese de que la URL de la CLI del servidor de inserción de notificaciones sea correcta para HTTP/2 tanto para Producción como para Desarrollo.

Establecer la URL para HTTP/2

_CLI/Applications/NotificationPushServer/APNS/Production> get

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

connectionPoolSize = 5

connectionTimeout = 1000

connectionIdleTimeoutInSeconds = 600

_CLI/Applications/NotificationPushServer/APNS/Development> get

url = https://api.development.push.apple.com/3/device

connectionPoolSize = 5

connectionTimeout = 1000

connectionIdleTimeoutInSeconds = 600

Es posible que sea necesario ajustar los parámetros anteriores para su sistema específico. El ejemplo anterior y las recomendaciones siguientes pueden proporcionar un punto de partida.

- 'ConnectionPoolSize' es el número de conexiones simultáneas que NPS puede realizar a los servidores APNS. Esto ayudará al rendimiento de NPS y puede que no ayude directamente a los problemas de tiempo de espera. ConnectionPoolSize debe incrementarse por encima de 2, tenga en cuenta que sin ap377409 es posible que el NPS no registre correctamente un valor por encima de 2.

- Se recomienda establecer connectionTimeout en un valor superior a 1000.

Configure el Auth Keys

_CLI/Applications/NotificationPushServer/APNS/AuthKey> add UTHPSAD667 Y2V5KSH586 /export/home/bwadmin/EVAL_Team-Y2V5KSH586-APNsAuthKey_ID-UTHPSAD667.p8

...Done

_CLI/Applications/NotificationPushServer/APNS/AuthKey> get

Auth Key Id    Team Id     Auth Key

===================================

64D9E5NY4S     D775LZJG9V  ********       <- SaaS

L44B3C998K     698ZB8543V  ********       <- Connect Dev

UTHPSAD667     Y2V5KSH586  ********       <- Connect Eval

3 entry found.

Agregar tokens para ProduEntornos de acción y desarrollo

_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.broadsoft.connect.eval authKeyId UTHPSAD667

...Done

_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> get

App Id   Auth Key Id

===================================================

com.broadsoft.uc-one   64D9E5NY4S       <- SaaS

com.broadsoft.connect.eval   UTHPSAD667       <- Connect Eval

2 entries found.

Habilitar HTTP/2 si utilización de XSP 22.0

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

Nota: Si en 23.0 o ADP no se requiere este paso, ya que HTTP/2 no se puede inhabilitar.

Reiniciar BroadWorks

restartbw

Resolución de problemas

El servidor de inserción de notificaciones procesa la respuesta HTTP/2 POST. Un código de respuesta de "200" de los APN significa que la notificación fue recibida con éxito por los APN y que intentará enviar la notificación al dispositivo. Los mensajes de error detallados se capturan en los registros del servidor de inserción de notificaciones.

Si Apple devuelve un código de error, los códigos de error de Apple se pueden encontrar en la documentación de Apple aquí:

https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotifi...

Si utiliza el ADP, el AS debe configurarse para utilizar TLSv1.2. Para establecer esto, agregue la siguiente opción de contenedor en el AS:

AS_CLI/Maintenance/ContainerOptions> add platform bw.apache.sslenabledprotocols "-ALL +TLSv1.2"

Una vez que el AS se ha configurado para utilizar TLSv1.2, detenga BroadWorks, reinicie el sistema configurado e inicie BroadWorks nuevamente en el AS.

stopbw

configdctl restart

startbw

Referencia

Documentación de HTTP/2 BroadWorks: https://xchange.broadsoft.com/node/498995

Alerta sobre Xchange con respecto a la sustitución de la interfaz APNS binaria anterior: https://xchange.broadsoft.com/node/1053230

Guía de soluciones de UC-One: https://xchange.broadsoft.com/node/1049202

Vea las notas del parche en ap354313 para 22.0: https://xchange.broadsoft.com/node/496044

Tenga en cuenta que ap354313 existe tanto para la plataforma como para AS, EMS, HZS, PS, NS, NFM, UMS y XSP para actualizar Java a 8.0_102b, esto es un requisito para que el XSP 22.0 funcione con HTTP/2, no significa que el UMS también deba estar en 22.0. ...

Connect Eval Client

https://apps.apple.com/in/app/uc-one-connect-evaluation/id1114743230