المحتويات

المتطلبات

التكوين

تعيين عنوان URL ل HTTP/2

تكوين مفاتيح المصادقة

إضافة رموز مميزة لبيئات الإنتاج والتطوير

تمكين HTTP/2 في حالة إستخدام XSP 22.0

إعادة تشغيل BroadWorks

استكشاف الأخطاء وإصلاحها

المرجع

عميل تقييم الاتصال

بعد 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