2021年3月31日以降、Notification Push Server(NPS)はHTTP/2インターフェイスを使用してApple Push Notificationサービス(APNS)と通信する必要があります。 HTTP/2インターフェイスは、パッチap354313を介してBroadWorksリリース22.0で使用でき、リリース23.0はHTTP/2のみをサポートします。
BroadWorksリリース22.0を実行している場合は、ap354313を適用した後で、次の手順を使用してHTTP/2を設定できます。23.0以降にアップグレードする場合は、APNS用にHTTP/2をを2を設定する必要します。
要件
22.0+または23.0 XSP上に存在する必要があります。XSP ONLYがNPSを実行し、ASが21.sp1の場合、22.0/23.0 XSPは21.sp1スタックと並行して実行できます。詳細については、「BroadWorks互換性マトリックス」を参照してください。
HTTP/2を構成するには、認証キーID、チームID、および認証キーとして現在使用されているクライアントを確認する必要があります。21.sp1で構成されたアプリケーションは、次の場所にあります。
XSP_CLI/Applications/NotificationPushServer/APNS/Production/Certificate> get
- Cisco/BroadSoft以外のiOSアプリケーションは、HTTP/2 APNSプロトコルを使用するように設定する必要があります。
- CollaborateまたはSaaS BroadWorksアプリケーションをHTTP/2に移行する必要があります。
- APNsの通知プッシュサーバーにHTTP/2サポートを追加
- SaaSクライアントの場合は、BAMポータル→構成→ BroadWorksにログインし、セクションまでスクロールします。 [Notification Push Server]を選択し、ドロップダウンから適切なリリースを選択して、指示に従います。
- Connect Evalクライアントの場合、TACでチケットを開き、認証キー、認証キーID、およびチームIDを要求します。以下に示すアプリID、認証キーID、チームIDはブランドのないクライアント用です。ブランドクライアントを使用する場合は、Appleからクライアント用にこの情報を取得する必要があります。
他のクライアントに必要なトークンは、Apple Developerポータルから入手できます。Appleのマニュアルは次のリンクから入手できます。
https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/.. にアクセスしてください。
新しい22.0、23.0、またはADPにアップグレードまたは導入する場合は、必要なライセンスが必要です。
また、Xchange for OSおよびアップグレードの要件に関するリリースノートも参照してください。
コンフィギュレーション
Notification Push Server CLIのURLが、実稼働と開発の両方のHTTP/2に対して正しいことを確認します。
HTTP/2のURLを設定します
_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
上記の設定は、ご使用のシステムに合わせて調整する必要があります。上記の例と次の推奨事項から始まる可能性があります。
- 「ConnectionPoolSize」は、NPSがAPNSサーバーに対して実行できる同時接続数です。これにより、NPSのスループットが向上し、タイムアウトの問題に直接対処できない場合があります。ConnectionPoolSizeを2より大きくする必要があります。ap377409がないと、NPSが2より大きい値を正しく登録できない場合があることに注意してください。
- connectionTimeoutを1000を超える値に設定することを推奨します。
Aの設定認証キー
_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.
Produのトークンの追加機能および開発環境
_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を XSP 22.0の使用
XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true
注：23.0またはADPでは、HTTP/2を無効にできないため、この手順は必要ありません。
BroadWorksの再起動
restartbw
トラブルシューティング
HTTP/2 POSTへの応答は、通知プッシュサーバによって処理されます。APNからの応答コード「200」は、APNが通知を正常に受信したことを意味し、デバイスに通知をプッシュしようとします。詳細なエラーメッセージは、Notification Push Serverログに記録されます。
Appleがエラーコードを返した場合、Appleのエラーコードは次のAppleのマニュアルに記載されています。
https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotifi..
ADPを使用する場合は、TLSv1.2を使用するようにASを設定する必要があります。これを設定するには、ASに次のコンテナオプションを追加します。
AS_CLI/Maintenance/ContainerOptions> add platform bw.apache.sslenabledprotocols "-ALL +TLSv1.2"
ASがTLSv1.2を使用するように設定されたら、BroadWorksを停止し、設定を再起動して、ASでBroadWorksを再起動します。
stopbw
configdctl restart
startbw
参考
HTTP/2 BroadWorksドキュメント：https://xchange.broadsoft.com/node/498995
前のバイナリAPNSインターフェイスの交換に関するExchangeに関するアラート： https://xchange.broadsoft.com/node/1053230
UC-Oneソリューションガイド：https://xchange.broadsoft.com/node/1049202
22.0については、ap354313のパッチノートを参照してください。 https://xchange.broadsoft.com/node/496044
ap354313は、プラットフォームだけでなく、AS、EMS、HZS、PS、NS、NFM、UMS、およびXSPにも存在し、Javaを8.0_102bにアップデートするために、これはHTTPで動作するための要件です/2は、UMSが22.0上に存在する必要があるわけではありません。
評価クライアントの接続
https://apps.apple.com/in/app/uc-one-connect-evaluation/id1114743230
フィードバック