Après le 31 mars 2021, le serveur NPS (Notification Push Server) doit utiliser une interface HTTP/2 pour communiquer avec le service APNS (Apple Push Notification Service). L'interface HTTP/2 est disponible sur BroadWorks version 22.0 via le patch ap354313 et la version 23.0 ne prend en charge que HTTP/2.
Si vous exécutez BroadWorks version 22.0, HTTP/2 peut être configuré en suivant les instructions suivantes après l'application de la norme ap354313. Si vous effectuez une mise à niveau vers la version 23.0 ou ultérieure, les étapes suivantes seront nécessaires pour configurer HTTP/2 pour APNS.
Conditions requises
Vous devez être sur 22.0+ ou 23.0 XSP. Un XSP 22.0/23.0 est compatible pour fonctionner en parallèle avec une pile 21.sp1 si le XSP UNIQUEMENT exécute NPS et l'AS est 21.sp1. Pour plus d'informations, reportez-vous à la matrice de compatibilité de BroadWorks.
Vous devez savoir quels clients sont actuellement utilisés, car l'ID de clé d'authentification, l'ID d'équipe et la clé d'authentification seront nécessaires pour configurer HTTP/2. Les applications configurées sur 21.sp1 se trouvent ici :
XSP_CLI/Applications/NotificationPushServer/APNS/Production/Certificate> get
- Toutes les applications iOS non Cisco/BroadSoft doivent être configurées pour utiliser le protocole HTTP/2 APNS.
- Les applications Collaborate ou SaaS BroadWorks doivent être migrées vers HTTP/2.
- Ajout de la prise en charge HTTP/2 au serveur de diffusion de notifications pour les APN
- Pour les clients SaaS, connectez-vous au portail BAM → Configuration → BroadWorks, faites défiler jusqu'à la section : Notification Push Server, sélectionnez la version appropriée dans la liste déroulante, puis suivez les instructions.
- Pour les clients d'évaluation de connexion, ouvrez un ticket auprès du TAC pour demander les clés d'authentification, l'ID de clé d'authentification et l'ID d'équipe. Notez que l'ID d'application, l'ID de clé d'authentification et l'ID d'équipe répertoriés ci-dessous concernent le client sans marque, si vous utilisez un client de marque, ces informations devront être obtenues auprès d'Apple pour vos clients.
Les jetons requis pour d'autres clients peuvent être obtenus à partir du portail Apple Developer, voir la documentation Apple ici :
https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/...
Si vous effectuez une mise à niveau vers ou déployez un nouveau 22.0, 23.0 ou ADP, la licence nécessaire sera requise.
Veuillez également consulter les notes de version disponibles sur Xchange pour le système d'exploitation et les exigences de mise à niveau.
Configuration
Assurez-vous que l'URL de l'interface de ligne de commande du serveur de diffusion de notifications est correcte pour HTTP/2 pour Production et Développement.
Définir l'URL pour 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
Il se peut que les paramètres ci-dessus doivent être réglés pour votre système spécifique. L'exemple ci-dessus et les recommandations suivantes peuvent servir de point de départ.
- Le 'ConnectionPoolSize' est le nombre de connexions simultanées que NPS peut établir aux serveurs APNS. Cela permettra d'améliorer le débit de NPS et peut ne pas aider directement les problèmes de délai d'attente. ConnectionPoolSize doit être augmenté au-dessus de 2, notez que sans ap377409, le NPS peut ne pas enregistrer correctement une valeur au-dessus de 2.
- Il est recommandé de définir connectionTimeout sur une valeur supérieure à 1000.
Configurer le ATouches uth
_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.
Ajouter des jetons pour ProduEnvironnement d'action et de développement
_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.
Activer HTTP/2 si utilisation de XSP 22.0
XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true
Note: Si sur 23.0 ou ADP, cette étape n'est pas requise car HTTP/2 ne peut pas être désactivé.
Redémarrer BroadWorks
restartbw
Dépannage
La réponse au test POST HTTP/2 est traitée par le serveur d'envoi de notifications. Un code de réponse de “ 200 ” provenant des APN signifie que la notification a été reçue avec succès par les APN et qu'il tentera de transmettre la notification au périphérique. Les messages d'erreur détaillés sont capturés dans les journaux du serveur d'envoi de notifications.
Si Apple renvoie un code d'erreur, les codes d'erreur Apple se trouvent dans la documentation Apple ici :
https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotifi...
Si vous utilisez le protocole ADP, le système autonome doit être configuré pour utiliser TLSv1.2. Pour définir cette option, ajoutez l'option de conteneur suivante sur le système autonome :
AS_CLI/Maintenance/ContainerOptions> add platform bw.apache.sslenabledprotocols "-ALL +TLSv1.2"
Une fois que le système autonome a été configuré pour utiliser TLSv1.2, arrêtez BroadWorks, redémarrez la configuration et redémarrez BroadWorks sur le système autonome.
stopbw
configdctl restart
startbw
Référence
Documentation HTTP/2 BroadWorks : https://xchange.broadsoft.com/node/498995
Alerte sur Xchange en ce qui concerne le remplacement de l'interface APNS binaire précédente : https://xchange.broadsoft.com/node/1053230
Guide des solutions UC-One : https://xchange.broadsoft.com/node/1049202
Reportez-vous aux notes de correctif sur ap354313 pour 22.0 : https://xchange.broadsoft.com/node/496044
Veuillez noter que la carte ap354313 existe pour la plate-forme ainsi que pour les systèmes AS, EMS, HZS, PS, NS, NFM, UMS et XSP afin de mettre à jour Java vers 8.0_102b, ceci est une condition requise pour que XSP sur 22.0 fonctionne avec HTTP/2, cela ne signifie pas que l'UMS doit également être sur 2.0. ..
Connect Eval Client
https://apps.apple.com/in/app/uc-one-connect-evaluation/id1114743230