Dopo il 31 marzo 2021, il Server dei criteri di rete deve utilizzare un'interfaccia HTTP/2 per comunicare con il servizio Apple Push Notification (APNS). L'interfaccia HTTP/2 è disponibile su BroadWorks versione 2.0 tramite la patch ap354313 e la release 23.0 supporta solo HTTP/2.
Se si esegue BroadWorks release 22.0, è possibile configurare HTTP/2 seguendo le istruzioni riportate di seguito dopo aver applicato ap354313. Se si esegue l'aggiornamento alla versione 23.0 o successive, per configurare HTTP/2 per APNS è necessario eseguire i passaggi seguenti.
Requisiti
È necessario utilizzare XSP 2.0+ o 23.0. Un XSP 22.0/23.0 è compatibile per l'esecuzione in parallelo con uno stack 21.sp1 se XSP esegue SOLO Server dei criteri di rete e AS è 21.sp1. Vedere la matrice di compatibilità BroadWorks per ulteriori informazioni.
È necessario conoscere i client attualmente in uso. Per configurare HTTP/2, saranno necessari l'ID della chiave di autenticazione, il TeamID e la chiave di autenticazione. Le app configurate in 21.sp1 sono disponibili qui:
XSP_CLI/Applications/NotificationPushServer/APNS/Production/Certificate> get
- Tutte le app iOS non Cisco/BroadSoft devono essere configurate per l'utilizzo del protocollo HTTP/2 APNS.
- È necessario eseguire la migrazione delle app Collaborate o SaaS BroadWorks a HTTP/2.
- Aggiungi supporto HTTP/2 al server Push di notifica per i nomi del punto di accesso
- Per i client SaaS, accedere al portale BAM → Configurazione → BroadWorks, scorrere fino alla sezione: Notification Push Server, selezionare la versione corretta nell'elenco a discesa, quindi seguire le istruzioni.
- Per Connect Eval, i client aprono un ticket con TAC per richiedere le chiavi Auth, l'ID della chiave Auth e il TeamID. Notare che l'ID app, l'ID chiave autenticazione e l'ID team elencati di seguito sono relativi al client senza marchio. Se si utilizza un client con marchio, queste informazioni dovranno essere ottenute per i client da Apple.
I token richiesti per altri client possono essere ottenuti dal portale per sviluppatori Apple, vedere la documentazione di Apple qui:
https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/...
Se si esegue l'aggiornamento a o si distribuisce una nuova versione 2.0, 23.0 o ADP, sarà necessaria la licenza necessaria.
Consultare inoltre le note di rilascio relative a Xchange per i requisiti relativi al sistema operativo e all'aggiornamento.
Configurazione
Verificare che l'URL nella CLI del server di push delle notifiche sia corretto per HTTP/2 sia per la produzione che per lo sviluppo.
Impostare l'URL per 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
Potrebbe essere necessario regolare le impostazioni di cui sopra in base al sistema in uso. L'esempio precedente e le raccomandazioni seguenti possono costituire un punto di partenza.
- 'ConnectionPoolSize' indica il numero di connessioni simultanee che il Server dei criteri di rete può effettuare ai server del servizio APN. Ciò contribuirà alla velocità effettiva di Server dei criteri di rete e potrebbe non contribuire direttamente ai problemi di timeout. ConnectionPoolSize deve essere aumentato a un valore superiore a 2. Tenere presente che senza ap377409 è possibile che il Server dei criteri di rete non registri correttamente un valore superiore a 2.
- Si consiglia di impostare connectionTimeout su un valore superiore a 1000.
Configurare lachiavi 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.
Aggiungi token per ProduAmbienti di azione e sviluppo
_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.
Abilita HTTP/2 se utilizzo di XSP 2.0
XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true
Nota: Se nella versione 23.0 o ADP questo passaggio non è necessario, in quanto non è possibile disabilitare HTTP/2.
Riavvia BroadWorks
restartbw
Risoluzione dei problemi
La risposta al POST HTTP/2 viene elaborata dal server Push di notifica. Un codice di risposta "200" da parte dei numeri APN indica che la notifica è stata ricevuta correttamente dai numeri APN e proverà a inviare la notifica al dispositivo. I messaggi di errore dettagliati vengono acquisiti nei registri del server Push di notifica.
Se Apple restituisce un codice di errore, i codici di errore Apple sono disponibili nella documentazione di Apple riportata di seguito:
https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotifi...
Se si utilizza l'ADP, l'AS deve essere impostato in modo da utilizzare TLSv1.2. Per impostare questa opzione, aggiungere la seguente opzione di contenitore nell'AS:
AS_CLI/Maintenance/ContainerOptions> add platform bw.apache.sslenabledprotocols "-ALL +TLSv1.2"
Dopo aver impostato l'ASA per l'utilizzo di TLSv1.2, arrestare BroadWorks, riavviare configurata e avviare nuovamente BroadWorks sull'ASA.
stopbw
configdctl restart
startbw
Riferimento
Documentazione di BroadWorks HTTP/2: https://xchange.broadsoft.com/node/498995
Avviso relativo a Xchange in relazione alla sostituzione dell'interfaccia APNS binaria precedente: https://xchange.broadsoft.com/node/1053230
Guida alle soluzioni UC-One: https://xchange.broadsoft.com/node/1049202
Vedere le note sulle patch su ap354313 per la versione 2.0: https://xchange.broadsoft.com/node/496044
Si tenga presente che ap354313 è disponibile per piattaforma e per AS, EMS, HZS, PS, NS, NFM, UMS e XSP per aggiornare Java a 8.0_102b. Questo è un requisito per XSP su 22.0 per funzionare con HTTP/2, non significa che UMS debba essere su 22.0.
Connetti client di valutazione
https://apps.apple.com/in/app/uc-one-connect-evaluation/id1114743230
Feedback