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