Contenu

Conditions requises

Configuration

Définir l'URL pour HTTP/2

Configurer les clés d'authentification

Ajouter des jetons pour les environnements de production et de développement

Activer HTTP/2 si vous utilisez XSP 22.0

Redémarrer BroadWorks

Dépannage

Référence

Connect Eval Client

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