Inhoud

Vereisten

Configuratie

Stel de URL in voor HTTP/2

De auth Keys configureren

Tokens toevoegen voor productie- en ontwikkelingsomgevingen

HTTP/2 inschakelen bij gebruik van XSP 2.0

BroadWorks herstarten

Probleemoplossing

Referentie

Connect Eval-client

Na 31 maart 2021 moet de melding Push Server (NPS) een HTTP/2-interface gebruiken om te communiceren met de Apple Push Recognition Service (APNS). De HTTP/2-interface is beschikbaar op BroadWorks release 22.0 via de patch ap354313 en release 23.0 ondersteunt alleen HTTP/2.

Als BroadWorks release 22.0 wordt uitgevoerd, kan HTTP/2 worden geconfigureerd met behulp van de volgende instructies na het toepassen van ap354313. Als upgrade naar 23.0 of hoger is dan zullen de volgende stappen nodig zijn om HTTP/2 voor APNS te configureren.

Vereisten

U moet ingesteld zijn op 22.0+ of 23.0 XSP. Een 22.0/23.0 XSP is compatibel om parallel met een 21.sp1 stack te draaien als XSP ALLEEN NPS draait en AS 21.sp1. Zie de BreadWorks Compatibiliteitsmatrix voor meer informatie.

U moet weten welke klanten momenteel in gebruik zijn aangezien de Auth Key ID, TeamID en Auth Key Key Key Key nodig zijn om HTTP/2 te configureren. De apps die op 21.sp1 zijn geconfigureerd, zijn hier te vinden:

XSP_CLI/Applications/NotificationPushServer/APNS/Production/Certificate> get

- Alle iOS-apps die geen Cisco/BroadSoft apps maken, moeten worden geconfigureerd voor gebruik van het HTTP/2 APNS-protocol.

- Collaborate of SaaS BroadWorks-apps moeten worden gemigreerd naar HTTP/2.

- Ondersteuning van HTTP/2 toevoegen aan Meldings-drukserver voor APN’s

- Voor SaaS-clients kunt u inloggen op het BAM-portal → Configuration BroadbandWorks, doorschuiven naar paragraaf:  Meldingen drukken Server, selecteer de juiste release in de vervolgkeuzelijst en volg de instructies.

- Voor Connect Eval Clients opent u een ticket met TAC om de Auth Keys, Auth Key ID en TeamID aan te vragen. Merk op dat de app ID, Auth Key ID en Team ID hieronder voor de niet-gebrandde client zijn vermeld. Als u een merknaam gebruikt, dient deze informatie voor uw klanten bij Apple te worden verkregen.

De vereiste penningen voor andere cliënten kunnen bij de Steek van Apple Ontwikkeler worden verkregen, zie de documentatie van Apple hier:

https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/...

Als u een nieuwe 22.0, 23.0 of ADP-indeling wilt maken of implementeren, is de benodigde licentie vereist.

Raadpleeg ook de relevante release notes die beschikbaar zijn op Xchange voor OS- en upgradevereisten.

Configuratie

Zorg ervoor dat de URL in de melding Push Server CLI correct is voor HTTP/2 voor zowel productie als ontwikkeling.

Stel de URL in voor 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

Het kan nodig zijn om de bovenstaande instellingen voor uw specifieke systeem aan te passen. Het bovenstaande voorbeeld en de volgende aanbevelingen kunnen als uitgangspunt dienen.

- De 'ConnectionPoolSize' is het aantal gelijktijdige verbindingen dat NPS kan maken met APNS-servers. Dit zal de doorvoersnelheid van NPS helpen en kan niet direct helpen bij tijdelijke problemen. De waarde van ConnectionPoolSize moet hoger worden dan 2, let er op dat zonder ap377409 het NPS mogelijk niet correct een waarde boven 2 registreert.

- Aanbevolen wordt om de Time-outwaarde voor verbinding in te stellen op een waarde boven 1000.

Een A configurerenKeys

_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.

Tokens toevoegen voor Produmilieu's voor actie en ontwikkeling

_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.

HTTP/2 inschakelen indien gebruik van XSP 22.0

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

Opmerking: Als op 23.0 of ADP deze stap niet vereist is aangezien HTTP/2 niet kan worden uitgeschakeld.

BroadWorks herstarten

restartbw

Probleemoplossing

De respons op de HTTP/2 POST wordt verwerkt door de melding Push Server. Een responscode van "200" van de APN's betekent dat de kennisgeving met succes is ontvangen door de APN's en zal proberen de kennisgeving aan het toestel te doen toekomen. Gedetailleerde foutmeldingen worden opgenomen in de logbestanden van de Meldingsdrukserver.

Als Apple een foutcode retourneert, kunnen de Apple error codes hier gevonden worden in de Apple documentatie:

https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotifi...

Als u de ADP gebruikt, moet AS worden ingesteld op gebruik van TLSv1.2. Om dit in te stellen, moet u de volgende containeroptie op het AS toevoegen:

AS_CLI/Maintenance/ContainerOptions> add platform bw.apache.sslenabledprotocols "-ALL +TLSv1.2"

Nadat het AS is ingesteld om TLSv1.2 te gebruiken, stop BroadWorks, start de installatie opnieuw en start BroadWorks opnieuw op het AS.

stopbw

configdctl restart

startbw

Referentie

HTTP/2 BroadWorks-documentatie: https://xchange.broadsoft.com/node/498995

Waarschuwing met betrekking tot Xchange wat betreft de vervanging van de vorige binaire APNS-interface:  https://xchange.broadsoft.com/node/1053230

Guide voor UC-één oplossingen: https://xchange.broadsoft.com/node/1049202

Zie de opmerkingen op ap354313 voor 22.0:  https://xchange.broadsoft.com/node/496044

Merk op dat ap354313 bestaat voor platform en voor de AS, EMS, HZS, PS, NS, NFM, UMS en XSP om Java te kunnen bijwerken naar 8.0_102b. Dit is een vereiste dat de XSP op 22.0 moet werken met HTTP/2. Dit betekent niet dat de UMS ook op 22 moet zijn 2.0.

Connect Eval-client

https://apps.apple.com/in/app/uc-one-connect-evaluation/id1114743230