Sommario

Requisiti

Configurazione

Impostare l'URL per HTTP/2

Configurare le chiavi di autenticazione

Aggiunta di token per ambienti di produzione e sviluppo

Abilitare HTTP/2 se si utilizza XSP 2.0

Riavvia BroadWorks

Risoluzione dei problemi

Riferimento

Connetti client di valutazione

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