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
Comentarios