تكوين إشعارات دفع المكالمات لـ Webex BroadWorks

في هذا المستند، نستخدم المصطلح "خادم دفع إعلامات المكالمات" (CNPS) لوصف تطبيق XSP المستضاف أو ADP المستضاف والذي يعمل في بيئتك. يعمل CNPS مع نظام BroadWorks ليكون على دراية بالمكالمات الواردة إلى المستخدمين، ويدفع إشعارات تلك المكالمات إلى خدمات إشعارات المراسلة السحابية من Google Firebase (FCM) أو خدمة إشعارات Apple Push Notification (APNs).

تقوم هذه الخدمات بإخطار الأجهزة المحمولة الخاصة ب Webex لمشتركي Cisco BroadWorks بأن لديهم مكالمات واردة على Webex.

لمزيد من المعلومات حول NPS، راجع وصف ميزة خادم دفع الإعلام.

تعمل آلية مماثلة في Webex مع خدمات المراسلة والتواجد في Webex لدفع الإشعارات إلى خدمات إشعارات Google (FCM) أو Apple (APNS). هذه الخدمات بدورها تخطر مستخدمي Webex للجوال بالرسائل الواردة أو تغييرات حالة الحضور.

يصف هذا القسم كيفية تكوين NPS لوكيل المصادقة عندما لا يدعم NPS بالفعل التطبيقات الأخرى. إذا كنت بحاجة إلى ترحيل NPS مشترك لاستخدام وكيل NPS، راجع تحديث Cisco BroadWorks NPS لاستخدام وكيل NPS.

نظرة عامة على وكيل NPS

للتوافق مع Webex ل Cisco BroadWorks ، يجب تصحيح CNPS الخاص بك لدعم ميزة وكيل NPS ، خادم الدفع ل VoIP في UCaaS.

تقوم الميزة بتنفيذ تصميم جديد في خادم دفع الإشعارات لحل الثغرة الأمنية لمشاركة المفاتيح الخاصة لشهادة الإشعارات المباشرة مع موفري الخدمات لعملاء الأجهزة المحمولة. بدلا من مشاركة شهادات ومفاتيح إشعارات الدفع مع مزود الخدمة، تستخدم NPS واجهة برمجة تطبيقات جديدة للحصول على رمز مميز قصير الأجل للإشعارات المباشرة من Webex للواجهة الخلفية ل Cisco BroadWorks، وتستخدم هذا الرمز المميز للمصادقة مع Apple APNs وخدمات Google FCM.

تعمل الميزة أيضا على تحسين قدرة خادم دفع الإشعارات على دفع الإشعارات إلى أجهزة Android من خلال واجهة برمجة تطبيقات HTTPv1 الجديدة للمراسلة السحابية من Google Firebase (FCM).

لمزيد من المعلومات، راجع خادم الدفع ل VoIP في وصف ميزة UCaaS.
تتوفر تصحيحات BroadWorks الخاصة بهذه الميزة على: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.

بالنسبة لبرامج NPS والتحديثات، راجع القسم قم بإعداد NPS الخاص بك لـ Webex لـ Cisco BroadWorks.

ابحث عن التصحيح وقم بتنزيله من صفحة تنزيل البرنامج.
يمكن العثور على مزيد من المعلومات حول خادم ADP في Cisco BroadWorks Application Delivery Platform.

اعتبارات APNS

لن تدعم Apple بعد الآن البروتوكول الثنائي المستند إلى HTTP / 1 على خدمة Apple Push Notification بعد 31 مارس 2021. نوصيك بتكوين XSP|ADP الخاص بك لاستخدام HTTP/2-based واجهة لـ APNs. يتطلب هذا التحديث أن يكون جهاز XSP|ADP الذي يستضيف NPS يعمل بنظام التشغيل R22 أو إصدار أحدث.

قم بإعداد NPS الخاص بك ل Webex ل Cisco BroadWorks

1	قم بتثبيت XSP مخصص وتكوينه (الحد الأدنى للإصدار R22) أو النظام الأساسي لتسليم التطبيقات (ADP).
2	تثبيت تصحيحات وكيل مصادقة NPS: تصحيحات XSP R22: AP.xsp.22.0.1123.ap369607 AP.platform.22.0.1123.ap369607 AP.xsp.22.0.1123.ap374677 AP.xsp.22.0.1123.ap375206 AP.xsp.22.0.1123.ap354313 AP.platform.22.0.1123.ap354313 تصحيحات XSP R23: AP.xsp.23.0.1075.ap369607 AP.platform.23.0.1075.ap369607 AP.xsp.23.0.1075.ap374677 AP.xsp.23.0.1075.ap375206
3	قم بتنشيط تطبيق خادم دفع الإشعارات.
4	(لإشعارات Android) قم بتمكين واجهة برمجة تطبيقات FCM v1 على NPS. `XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true`
5	(لإشعارات Apple iOS) تمكين HTTP/2 على NPS. `XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true` هذا خاص بإصدار 22 والإصدارات الأقدم؛ وهو غير متوفر في إصدارات 23 والإصدارات الأحدث، والتي تدعم فقط HTTP/2.
6	قم بإرفاق دعم فني من NPS XSP/ADP.
7	في كل خادم AS، يجب تكوين ملف namedefs في `/usr/local/broadworks/bw_base/conf` باستخدام سجلات SRV وA لخادم دفع الإشعارات (XSP/ADP) البحث، إذا كان متعددًا XSP/ADP ثم أضف إدخالاً لكل منها حسب الحاجة. مثال: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 بمجرد التعيين، يلزم أحد الخيارات التالية لالتقاط التغييرات: يجب إجراء إعادة التشغيل في نافذة الصيانة. عبر Cisco BroadWorks CLI: R24 وما فوق AS_CLI/ASDiagnostic/DNS> إعادة التحميل R25 + AS_CLI/ASDiagnostic/DNS/ExecutionServer> إعادة التحميل AS_CLI/ASDiagnostic/DNS/ProvisioningServer> إعادة التحميل

التصرف التالي

لتثبيتات جديدة لـ NPS، انتقل إلى تكوين NPS لاستخدام وكيل المصادقة

لترحيل نشر Android الحالي إلى FCMv1، انتقل إلى ترحيل NPS إلى FCMv1

تكوين NPS لاستخدام وكيل المصادقة

تنطبق هذه المهمة على تثبيت جديد ل NPS مخصص ل Webex ل Cisco BroadWorks.

إذا كنت تريد تكوين وكيل المصادقة على NPS مشترك مع تطبيقات جوال أخرى، راجع تحديث Cisco BroadWorks NPS لاستخدام وكيل NPS.

الحصول على بيانات اعتماد OAuth لـ Webex الخاص بك لـ Cisco BroadWorks.

إنشاء حساب العميل على NPS:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

للتحقق من تطابق القيم التي أدخلتها مع ما تم إعطاؤه لك، قم بتشغيل XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

يجب أن يكون CiscoCI issuerUrl دائمًا عبارة عن مجموعة US CI بغض النظر عن موقعك ويجب أن يكون الإعداد الافتراضي هو:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

أدخل عنوان URL لوكيل NPS، واضبط الفاصل الزمني لتحديث الرمز المميز (يوصى ب 30 دقيقة):

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

لتحسين سرعة حل DNS، بدلاً من FQDN الحالي nps.uc-one.broadsoft.com، نوصيك باستخدام FQDN المناسب بناءً على منطقتك.

أسماء النطاقات المؤهلة بالكامل القائمة على المنطقة:

شرق الولايات المتحدة:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

غرب الولايات المتحدة:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

أوروبا:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

إذا انتهت مهلة إشعارات الدفع بسبب تأخير في حل DNS، فقم بزيادة قيمة مهلة الانتظار في "/etc/resolv.conf" الملف على خادم BroadWorks.

(لإشعارات Android) أضف معرف تطبيق Android إلى سياق تطبيقات FCM على NPS.

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

(لإشعارات Apple iOS) أضف معرف التطبيق إلى سياق تطبيقات APNS، مع التأكد من حذف مفتاح المصادقة - قم بتعيينه على فارغ.

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

تكوين عناوين URL NPS التالية:

سياق واجهة سطر أوامر ADP\|[XSP]	المعلمة	القيمة
`XSP\|ADP_CLI/Applications/NotificationPushServer/FCM>`	`authURL`	`https://www.googleapis.com/oauth2/v4/token`
	`pushURL`	`https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send`
	`scope`	`https://www.googleapis.com/auth/firebase.messaging`
`XSP\|ADP_CLI/Applications/NotificationPushServer/APNS/Production>`	`url`	`https://api.push.apple.com/3/device`

قم بتكوين معلمات اتصال NPS التالية إلى القيم الموصى بها الموضحة:

سياق واجهة سطر أوامر ADP\|[XSP]	المعلمة	القيمة
`XSP\|ADP_CLI/Applications/` `NotificationPushServer/FCM>`	`tokenTimeToLiveInSeconds`	3600
	`connectionPoolSize`	10
	`connectionTimeoutInMilliseconds`	3600
	`connectionIdleTimeoutInSeconds`	600
`XSP\|ADP_CLI/Applications/NotificationPushServer/` `APNS/Production>`	`connectionTimeout`	3000
	`connectionPoolSize`	2
	`connectionIdleTimeoutInSeconds`	600

تحقق مما إذا كان خادم التطبيقات يقوم بفحص معرفات التطبيقات، لأنك قد تحتاج إلى إضافة تطبيقات Webex إلى قائمة السماح:

قم بتشغيل AS_CLI/System/PushNotification> get وتحقق من قيمة enforceAllowedApplicationList. إذا كان true، فأنت بحاجة إلى إكمال هذه المهمة الفرعية. وإلا، تخطي بقية المهمة الفرعية.
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

أعد تشغيل XSP|ADP: bwrestart

اختبر إشعارات المكالمات عن طريق إجراء مكالمات من مشترك في BroadWorks إلى اثنين من مستخدمي Webex للجوال. تأكد من ظهور إشعار المكالمة على أجهزة iOS وAndroid.

ترحيل NPS إلى FCMv1

يحتوي هذا الموضوع على إجراءات اختيارية يمكنك استخدامها في وحدة تحكم FCM من Google عندما يكون لديك نشر NPS حالي تحتاج إلى ترحيله إلى FCMv1. هناك ثلاثة إجراءات:

ترحيل عملاء UC-One إلى FCMv1—عندما يكون لديك عملاء UCaaS موجودون وتحتاج إلى ترحيلهم لاستخدام FCMv1.
ترحيل عملاء SaaS إلى FCMv1—عندما يكون لديك عملاء SaaS موجودون وتحتاج إلى ترحيلهم لاستخدام FCMv1.
تحديث خادم ADP—عند ترحيل NPS إلى خادم ADP.

ترحيل عملاء UC-One إلى FCMv1

اتبع الخطوات التالية في وحدة تحكم FCM من Google لترحيل عملاء UC-One إلى Google FCM HTTPv1.

إذا تم تطبيق العلامة التجارية على العميل، فيجب أن يكون لدى العميل معرف المرسل. في وحدة تحكم FCM، راجع إعدادات المشروع > المراسلة السحابية. يظهر الإعداد في جدول بيانات اعتماد المشروع.

للحصول على التفاصيل، راجع دليل العلامة التجارية لـ Connect Mobile على https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. راجع المعلمة gcm_defaultSenderId الموجودة في مجموعة أدوات العلامة التجارية، مجلد الموارد، ملف branding.xml مع بناء الجملة التالي:

xxxxxxxxxxxxx

قم بتسجيل الدخول إلى FCM Admin SDK على http://console.firebase.google.com.
حدد تطبيق Android المناسب.
في علامة التبويب عام ، سجل معرف المشروع
انتقل إلى علامة التبويب حسابات الخدمة لتكوين حساب خدمة. يمكنك إنشاء حساب خدمة جديد أو تكوين حساب موجود.

لإنشاء حساب خدمة جديد:
1. انقر على الزر الأزرق لإنشاء حساب خدمة جديد
2. انقر على الزر الأزرق لإنشاء مفتاح خاص جديد
3. تنزيل المفتاح إلى موقع آمن
لإعادة استخدام حساب خدمة موجود:
1. انقر على النص الأزرق لعرض حسابات الخدمة الحالية.
2. تحديد حساب الخدمة المراد استخدامه. يحتاج حساب الخدمة إلى إذن firebaseadmin-sdk.
3. على اليسار ، انقر فوق قائمة الهامبرغر وقم بإنشاء مفتاح خاص جديد.
4. قم بتنزيل ملف json الذي يحتوي على المفتاح واحفظه في مكان آمن.
انسخ ملف json إلى XSP|ADP.

تكوين معرف المشروع و:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add

تكوين التطبيق:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add  projectId 
...Done

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
  Application ID    Project ID
==============================
          my_app    my_project

تمكين FCMv1:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

قم بتشغيل الأمر bwrestart لإعادة تشغيل XSP|ADP.

ترحيل عملاء SaaS إلى FCMv1

اتبع الخطوات التالية على وحدة تحكم Google FCM إذا كنت تريد ترحيل عملاء SaaS إلى FCMv1.

تأكد من إكمال الإجراء "تكوين NPS لاستخدام وكيل المصادقة".

تعطيل FCM:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
...Done

قم بتشغيل الأمر bwrestart لإعادة تشغيل XSP|ADP.

تمكين FCM:

XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

قم بتشغيل الأمر bwrestart لإعادة تشغيل XSP|ADP.

تحديث خادم ADP

اتبع الخطوات التالية في Google FCM Console إذا كنت تقوم بترحيل NPS لاستخدام خادم ADP.

احصل على ملف JSON من وحدة تحكم Google Cloud:
1. على Google Cloud Console، انتقل إلى صفحة حسابات الخدمة.
2. انقر فوق تحديد مشروع، واختر مشروعك، ثم انقر فوق فتح.
3. ابحث عن صف حساب الخدمة الذي تريد إنشاء مفتاح له، ثم انقر فوق الزر الرأسي المزيد ، ثم انقر فوق إنشاء مفتاح.
4. حدد نوع المفتاح وانقر فوق إنشاء
  
  يتم تنزيل الملف.
إضافة FCM إلى خادم ADP:
1. قم باستيراد ملف JSON إلى خادم ADP باستخدام الأمر /bw/install.
2. قم بتسجيل الدخول إلى ADP CLI وأضف مفتاح Project و API:
  
  ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :
3. بعد ذلك ، أضف التطبيق والمفتاح:
  
  ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
4. تحقق من التكوين:
```
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g
Project ID Accountkey
========================
connect-ucaas ********

ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas
```

Cisco AI Assistant

شكرًا على ملاحظاتك.

تكوين إشعارات دفع المكالمات لـ Webex BroadWorks

نظرة عامة على وكيل NPS

اعتبارات APNS

قم بإعداد NPS الخاص بك ل Webex ل Cisco BroadWorks

تكوين NPS لاستخدام وكيل المصادقة

ترحيل NPS إلى FCMv1

ترحيل عملاء UC-One إلى FCMv1

ترحيل عملاء SaaS إلى FCMv1

تحديث خادم ADP

الشركات صغيرة الحجم

المؤسسة

الأجهزة

حلول لـ

الموارد

الشركة