بعد 31 مارس 2021، يجب أن يستخدم خادم دفع الإعلامات (NPS) واجهة HTTP/2 للاتصال بخدمة الإعلامات من Apple (APNS). تتوفر واجهة HTTP/2 في الإصدار 22.0 من BroadWorks من خلال نقطة الوصول في الوضع Flash AP354313، بينما يدعم الإصدار 23.0 بروتوكول HTTP/2 فقط.
في حالة تشغيل الإصدار 22.0 من BroadWorks، يمكن تكوين HTTP/2 باستخدام التعليمات التالية بعد تطبيق AP354313. إذا تم الترقية إلى 23.0 أو إصدار أحدث، فستلزم الخطوات التالية لتكوين HTTP/2 لواجهات برمجة التطبيقات (APN).
المتطلبات
يجب أن تكون في 22.0+ أو 23.0 XSP. يتوافق 22.0/23.0 XSP ليتم تشغيله بالتوازي مع مكدس 21.sp1 إذا كان XSP يشغل NPS و AS هو 21.sp1 فقط. راجع مصفوفة توافق BroadWorks للحصول على مزيد من المعلومات.
ستحتاج إلى معرفة العملاء المستخدمين حاليا حيث سيكون معرف مفتاح المصادقة و TeamID ومفتاح المصادقة مطلوبا لتكوين HTTP/2. يمكن العثور على التطبيقات التي تم تكوينها على 21.sp1 هنا:
XSP_CLI/Applications/NotificationPushServer/APNS/Production/Certificate> get
- يجب تكوين أي تطبيقات بنظام التشغيل iOS ليست من تطبيقات Cisco/BroadSoft لاستخدام بروتوكول HTTP/2 APNs.
- يجب ترحيل تطبيقات BroadWorks أو SaaS إلى HTTP/2.
- إضافة دعم HTTP/2 إلى خادم دفع الإعلامات ل APN
- بالنسبة لعملاء SAAs، قم بتسجيل الدخول إلى → BroadWorks لتكوين بوابة BAM →، ثم قم بالتمرير إلى القسم: خادم دفع الإعلامات، وحدد الإصدار المناسب في القائمة المنسدلة، ثم اتبع التعليمات.
- بالنسبة لعملاء تقييم الاتصال، افتح تذكرة باستخدام TAC لطلب مفاتيح المصادقة ومعرف مفتاح المصادقة ومعرف الفريق. لاحظ أن معرف التطبيق ومعرف مفتاح المصادقة ومعرف الفريق المدرجين أدناه هي للعميل الذي لم يتم وضع علامة تجارية عليه، إذا كان إستخدام عميل يحمل علامة تجارية، فسيلزم الحصول على هذه المعلومات لعملائك من Apple.
يمكن الحصول على الرموز المميزة المطلوبة للعملاء الآخرين من بوابة Apple Developer، راجع وثائق Apple هنا:
https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/...
في حالة الترقية إلى إصدار 22.0 أو 23.0 أو ADP جديد أو نشره، يلزم الحصول على الترخيص اللازم.
يرجى الرجوع أيضا إلى ملاحظات الإصدار ذات الصلة المتوفرة على Xchange للحصول على متطلبات نظام التشغيل والترقية.
التكوين
تأكد من صحة عنوان URL الموجود في واجهة سطر الأوامر الخاصة بخادم دفع الإعلامات ل HTTP/2 لكل من الإنتاج والتطوير.
تعيين عنوان URL ل 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
قد يلزم ضبط الإعدادات المذكورة أعلاه لنظامك المحدد. وقد يوفر المثال المذكور أعلاه والتوصيات التالية نقطة بداية.
- ConnectionPoolSize هو عدد الاتصالات المتزامنة التي يمكن أن تقوم بها NPS لخوادم APNS. وسيساعد ذلك على إنتاج مصادر القدرة النووية وقد لا يساعد مباشرة في حل مشاكل التعطيل. يجب زيادة ConnectionPoolSize فوق 2، لاحظ أنه بدون AP377409 قد لا تقوم NPS بتسجيل قيمة أعلى من 2 بشكل صحيح.
- يوصى بتعيين connectionTimeout إلى قيمة أعلى من 1000.
تكوين Aمفاتيح 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.
إضافة رموز مميزة لبرودوبيئات العمل والتطوير
_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 بواسطة خادم دفع الإعلامات. يعني رمز الاستجابة "200" من APNs أن الإخطار تم إستلامه بنجاح من قبل APNs وسيحاول دفع الإعلام إلى الجهاز. يتم التقاط رسائل خطأ تفصيلية في سجلات خادم دفع الإعلامات.
إذا قامت Apple بإرجاع رمز خطأ يمكن العثور على رموز أخطاء Apple في وثائق Apple هنا:
https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotifi...
إذا كان إستخدام ADP يجب تعيين AS لاستخدام TLSv1.2. لتعيين هذا الخيار إضافة خيار الحاوية التالي على AS:
AS_CLI/Maintenance/ContainerOptions> add platform bw.apache.sslenabledprotocols "-ALL +TLSv1.2"
بمجرد تعيين AS لاستخدام TLSv1.2، قم بإيقاف BroadWorks، ثم أعد تكوين BroadWorks، ثم قم بتشغيل BroadWorks مرة أخرى على AS.
stopbw
configdctl restart
startbw
المرجع
وثائق HTTP/2 BroadWorks: https://xchange.broadsoft.com/node/498995
تنبيه حول Xchange فيما يتعلق باستبدال واجهة APN الثنائية السابقة: https://xchange.broadsoft.com/node/1053230
دليل حلول UC-One: https://xchange.broadsoft.com/node/1049202
راجع ملاحظات التصحيح على AP354313 ل 22.0: https://xchange.broadsoft.com/node/496044
يرجى ملاحظة أن نقطة الوصول AP354313 موجودة للنظام الأساسي وكذلك بالنسبة ل AS و EMS و HZS و PS و NS و NFM و UMS و XSP لتحديث Java إلى 8.0_102b، وهذا مطلب ل XSP على 22.0 للعمل مع HTTP/2، ولا يعني أن UMS يجب أن تكون أيضا على 22.0.
عميل تقييم الاتصال
https://apps.apple.com/in/app/uc-one-connect-evaluation/id1114743230
التعليقات