متطلبات الإقامة المشتركة

• يجب أن تكون خدمة المصادقة موجودة بشكل مشترك مع تطبيقات Xsi، لأن هذه الواجهات يجب أن تقبل الرموز المميزة طويلة الأجل للحصول على ترخيص الخدمة. خدمة المصادقة مطلوبة للتحقق من صحة هذه الرموز.

• يمكن تشغيل خدمة المصادقة و Xsi على نفس المنفذ إذا لزم الأمر.

• يمكنك فصل الخدمات/التطبيقات الأخرى على النحو المطلوب للمقياس الخاص بك (مزرعة XSP|ADP المخصصة لإدارة الأجهزة، على سبيل المثال).

• يمكنك المشاركة في تحديد موقع تطبيقات Xsi وCTI وخدمة المصادقة وDMS.

• لا تقم بتثبيت تطبيقات أو خدمات أخرى على XSP|ADPS المستخدمة لدمج BroadWorks مع Webex.

• لا تشارك تطبيق NPS مع أي تطبيقات أخرى.

واجهات Xsi

قم بتثبيت تطبيقات Xsi-Actions وXsi-Events وتكوينها كما هو موضح في دليل تكوين واجهة الخدمات الممتدة من Cisco BroadWorks.

يجب نشر مثيل واحد فقط من تطبيقات Xsi-Events على XSP|ADP المستخدم لواجهة CTI.

يجب أن تحتوي جميع أحداث Xsi المستخدمة لدمج Broadworks مع Webex على نفس اسم تطبيق CallControl/المحدد ضمن التطبيقات/أحداث XSI/الإعدادات العامة. على سبيل المثال:

ADP_CLI/التطبيقات/أحداث XSI/الإعدادات العامة> احصل على

اسم تطبيق التحكم في المكالمات = com.broadsoft.xsi - الأحداث

عندما يكون المستخدم متصلاً بـ Webex، يقوم Webex بإنشاء اشتراك للمستخدم على AS من أجل تلقي الأحداث الهاتفية للتواجد وسجل المكالمات. يرتبط الاشتراك بـ CallControlApplicationName ويستخدمه AS لمعرفة أحداث Xsi-Events التي سيتم إرسال الأحداث الهاتفية إليها.

تكوين خدمة المصادقة (مع التحقق من صحة رمز CI)

استخدم هذا الإجراء لتكوين خدمة المصادقة لاستخدام التحقق من صحة رمز CI مع TLS. يوصى باستخدام طريقة المصادقة هذه إذا كنت تقوم بتشغيل R22 أو أعلى وكان نظامك يدعمها.

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

2. قم بتثبيت التصحيحات التالية على كل خادم XSP|ADP. قم بتثبيت التصحيحات المناسبة للإصدار الخاص بك:

   • بالنسبة لـ R22:

     منصة التداول 22.0.1123.AP376508

     الفصل الدراسي 22.0.1123.AP376508

     AP.SP.22.0.1123.AP368601

   • بالنسبة لـ R23:

     AP.XSP.23.0.1075.AP376509

     منصة التداول. 23.0.1075.AP376509

   • بالنسبة لـ R24 - لا يلزم التصحيح

   تتضمن أي إشارة إلى XSP إما XSP أو ADP.

3. قم بتثبيت تطبيق خدمة المصادقة على كل خدمة XSP|ADP.

   1. قم بتشغيل الأمر التالي لتنشيط تطبيق خدمة المصادقة على XSP|ADP إلى مسار السياق /AuthService.

      XSP | ADP_CLI/الصيانة/الكائنات المُدارة > تنشيط خدمة مصادقة التطبيق 22.0_1.1123/خدمة المصادقة

   2. قم بتشغيل هذا الأمر لنشر خدمة المصادقة على XSP|ADP:

      XSP | ADP_CLI/الصيانة/الكائنات المُدارة > نشر التطبيق /خدمة المصادقة Broadworks SW Manager /AuthService...

4. بدءًا من إصدار Broadworks 2022.10، لم تعد سلطات الشهادات التي تأتي مع Java مضمنة تلقائيًا في متجر BroadWorks Trust عند التبديل إلى إصدار جديد من java. تفتح خدمة المصادقة اتصال TLS بـ Webex لجلب رمز الوصول، وتحتاج إلى الحصول على ما يلي في متجر الثقة الخاص بها للتحقق من صحة عنوان URL الخاص بـ IDBroker و Webex:

   • الجذر التجاري لشركة IdenTrust CA 1

   • جو دادي روت Certificate Authority - G2

   تحقق من وجود هذه الشهادات ضمن CLI التالي

   ADP_CLI/النظام/SSLالإعدادات الشائعة/الثقت/الافتراضات> get

   إذا لم تكن موجودة، قم بتشغيل الأمر التالي لاستيراد صناديق Java الافتراضية:

   ADP_CLI/النظام/SSL الإعدادات الشائعة/الثقت/الافتراضات> استيراد JavaScript Trust

   بدلاً من ذلك، يمكنك إضافة هذه الشهادات يدويًا كمرتكزات ثقة باستخدام الأمر التالي:

   ADP_CLI/النظام/SSL الإعدادات الشائعة/الاستئمان/حلقات العمل > UpdateTrust <alias><trustAnchorFile>

   إذا تمت ترقية ADP من إصدار سابق، فسيتم استيراد المراجع المصدقة من الإصدار القديم تلقائيًا إلى الإصدار الجديد وسيستمر استيرادها حتى تتم إزالتها يدويًا.

   يُعفى تطبيق خدمة المصادقة من إعداد ValidatePeerIdentity ضمن ADP_CLI/System/SSLCommonSettings/GeneralSettings، ويقوم دائمًا بالتحقق من هوية الأقران. راجع FD للتحقق من صحة شهادة Cisco Broadworks X509 للحصول على مزيد من المعلومات حول هذا الإعداد.

5. قم بتكوين موفري الهوية عن طريق تشغيل الأوامر التالية على كل خادم XSP|ADP:

   XSP | ADP_CLI/التطبيقات/خدمة المصادقة/مزودي الهوية/CISCO> احصل على

   • تعيين معرف العميل - معرف العميل من الخطوة 1

   • تم تمكين التعيين بشكل صحيح

   • تعيين سر العميل - سر العميل - من الخطوة 1

   • تعيين الحد الأقصى لحجم استجابة CI بالبايت 65536

   • قم بتعيين IssuerName <URL>- بالنسبة لعنوان URL، أدخل عنوان URL الخاص بـ IssuerName الذي ينطبق على مجموعة CI الخاصة بك. انظر الجدول التالي.

   • قم بتعيين IssuerUrl <URL>- بالنسبة لعنوان URL، أدخل عنوان URL الذي ينطبق على مجموعة CI الخاصة بك. راجع الجدول التالي.

   • تعيين TokenInfourl <IdPProxy URL>- أدخل عنوان URL الخاص بـ iDP Proxy الذي ينطبق على مجموعة Teams الخاصة بك. انظر الجدول الثاني التالي.

   الجدول 1. تعيين اسم المستخدم وعنوان URL الخاص بالمصدر

   إذا كانت مجموعة CI هي...	قم بتعيين اسم المستخدم وعنوان URL الخاص بالمصدر إلى...
   US-A	https://idbroker.webex.com/idb
   EU	https://idbroker-eu.webex.com/idb
   US-B	https://idbroker-b-us.webex.com/idb
   إذا كنت لا تعرف مجموعة CI الخاصة بك، فيمكنك الحصول على المعلومات من تفاصيل العميل في عرض مكتب المساعدة في Control Hub.

   الجدول 2. قم بتعيين الرمز المميز في أربعة

   إذا كانت مجموعة الفرق هي...	قم بتعيين توكن إنفورل إلى... (عنوان URL للوكيل iDP)
   ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   إذا كنت لا تعرف مجموعة Teams الخاصة بك، فيمكنك الحصول على المعلومات من تفاصيل العميل في عرض مكتب المساعدة في Control Hub. للاختبار، يمكنك التحقق من أن TokenInfourl صالح عن طريق استبدال جزء "idp/authenticate" من عنوان URL بـ "ping».

6. حدد استحقاق Webex الذي يجب أن يكون موجودًا في ملف تعريف المستخدم في Webex عن طريق تشغيل الأمر التالي:

   XSP | ADP_CLI/التطبيقات/خدمة المصادقة/موفرو الهوية/CISCO/النطاقات> تعيين نطاق العمل - الموصل: المستخدم

7. قم بتكوين موفري الهوية لاتحاد Cisco باستخدام الأوامر التالية على كل خادم XSP|ADP:

   XSP | ADP_CLI/التطبيقات/خدمة المصادقة/مزودي الهوية/CISCO/الاتحاد > احصل على

   • قم بتعيين عنوان URL الخاص بـ https://cifls.webex.com/federation

   • حدد فترة التحديث بالدقائق 60

   • تعيين رمز التحديث - رمز التحديث من الخطوة 1

8. قم بتشغيل الأمر التالي للتحقق من أن تكوين FLS الخاص بك يعمل. سيعرض هذا الأمر قائمة موفري الهوية:

   XSP | ADP_CLI/التطبيقات/خدمة التأثيق/مزودي الهوية/CISCO/الاتحاد/خريطة المجموعة> احصل على

9. قم بتكوين إدارة الرموز باستخدام الأوامر التالية على كل خادم XSP|ADP:

   • XSP | ADP_CLI/التطبيقات/خدمة المصادقة/إدارة الرموز >

   • مجموعة عمل مُصدر الرمز المميز

   • مدة الرمز المحدد بالساعات 720

10. قم بإنشاء مفاتيح RSA ومشاركتها. يجب إنشاء مفاتيح على XSP|ADP واحد ثم نسخها إلى جميع XSP|ADP الأخرى. هذا بسبب العوامل التالية:

    • يجب عليك استخدام نفس أزواج المفاتيح العامة/الخاصة لتشفير/فك التشفير عبر جميع مثيلات خدمة المصادقة.

    • يتم إنشاء زوج المفاتيح بواسطة خدمة المصادقة عندما يُطلب إصدار رمز مميز لأول مرة.

    إذا قمت بتدوير المفاتيح أو تغيير طول المفتاح، فأنت بحاجة إلى تكرار التكوين التالي وإعادة تشغيل كافة XSP|ADPs.

    1. حدد XSP|ADP واحدًا لاستخدامه في إنشاء زوج مفاتيح.

    2. استخدم عميلًا لطلب رمز مشفر من XSP|ADP، عن طريق طلب عنوان URL التالي من متصفح العميل:

       https://<XSP|ADP-IPAddress>/authService/token؟ المفتاح = base64 URL (المفتاح العام للعميل)

       (يؤدي هذا إلى إنشاء زوج مفاتيح خاص/عام على XSP|ADP، إذا لم يكن هناك واحد بالفعل)

    3. موقع مخزن المفاتيح غير قابل للتكوين. قم بتصدير المفاتيح:

       XSP | ADP_CLI/التطبيقات/خدمة المصادقة/إدارة المفاتيح > مفاتيح التصدير

    4. انسخ الملف الذي تم تصديره /var/Broadworks/tmp/authservice.keys إلى نفس الموقع على XSP|ADPS الآخر، واستبدل ملف .keys القديم إذا لزم الأمر.

    5. قم باستيراد المفاتيح على كل من XSP|ADPS الأخرى:

       XSP | ADP_CLI/التطبيقات/خدمة المصادقة/إدارة المفاتيح> مفاتيح الاستيراد/var/البرودوركس/TMP/Authservice.keys

11. قم بتوفير عنوان URL الخاص بـ AuthService إلى حاوية الويب. تحتاج حاوية الويب الخاصة بـ XSP|ADP إلى عنوان URL الخاص بـ AuthService حتى تتمكن من التحقق من صحة الرموز المميزة. في كل من XSP|ADPS:

    1. إضافة عنوان URL لخدمة المصادقة كخدمة مصادقة خارجية لأداة BroadWorks Communications Utility:

       XSP | ADP_CLI/الأداة المساعدة للنظام/الاتصالات/الإعدادات الافتراضية/المصادقة الخارجية/خدمة المصادقة > تعيين عنوان url http://127.0.0.1:80/authService

    2. أضف عنوان URL لخدمة المصادقة إلى الحاوية:

       XSP | ADP_CLI/خيارات الصيانة/الحاوية > إضافة عنوان URL لخدمة bw.authservice.auth http://127.0.0.1:80/authService

       يتيح ذلك لـ Webex استخدام خدمة المصادقة للتحقق من الرموز المميزة المقدمة كبيانات اعتماد.

    3. تحقق من المعلمة باستخدام get.

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

إزالة متطلبات مصادقة العميل لخدمة المصادقة (R24 فقط)

إذا تم تكوين خدمة المصادقة باستخدام التحقق من رمز CI على R24، فأنت بحاجة أيضًا إلى إزالة متطلبات مصادقة العميل لخدمة المصادقة. قم بتشغيل أمر CLI التالي:

ADP_CLI/الواجهة/HTTP/SSL/الإعدادات العامة/مصادقة العميل/تطبيقات الويب> تعيين عميل خدمة المصادقة Authreq false <interfaceIp><port>

تكوين TLS والأصفار على واجهات HTTP (لـ XSI وخدمة المصادقة)

تستخدم تطبيقات خدمة المصادقة وXsi-Actions وXsi-Events واجهات خادم HTTP. مستويات تكوين TLS لهذه التطبيقات هي كما يلي:

الأكثر عمومية = النظام > النقل > HTTP > واجهة خادم HTTP = الأكثر تحديدًا

سياقات CLI التي تستخدمها لعرض إعدادات SSL المختلفة أو تعديلها هي:

قراءة تكوين واجهة TLS لخادم HTTP على XSP|ADP

1. قم بتسجيل الدخول إلى XSP|ADP وانتقل إلى XSP|ADP_CLI/الواجهة/HTTP/HttpServer>

2. أدخل أمر get واقرأ النتائج. يجب أن ترى الواجهات (عناوين IP) ولكل منها ما إذا كانت آمنة وما إذا كانت تتطلب مصادقة العميل.

يفرض Apache tomcat شهادة لكل واجهة آمنة؛ يقوم النظام بإنشاء شهادة موقعة ذاتيًا إذا احتاج إلى واحدة.

XSP|ADP_CLI/Interface/Http/HttpServer> get

إضافة بروتوكول TLS 1.2 إلى واجهة خادم HTTP

يجب تكوين واجهة HTTP التي تتفاعل مع Webex Cloud لـ TLSv1.2. لا تتفاوض السحابة مع الإصدارات السابقة من بروتوكول TLS.

لتكوين بروتوكول TLSv1.2 على واجهة خادم HTTP:

1. قم بتسجيل الدخول إلى XSP|ADP وانتقل إلى XSP|ADP_CLI/الواجهة/HTTP/HTTPServer/SSL/إعدادات/بروتوكولات>

2. أدخل الأمر get 443 <interfaceIp>لمعرفة البروتوكولات المستخدمة بالفعل على هذه الواجهة.

3. أدخل الأمر add 443 TLSv1.2 <interfaceIp>للتأكد من أن الواجهة يمكنها استخدام TLS 1.2 عند الاتصال بالسحابة.

تحرير تكوين شفرات TLS على واجهة خادم HTTP

لتكوين الأصفار المطلوبة:

1. قم بتسجيل الدخول إلى XSP|ADP وانتقل إلى XSP|ADP_CLI/الواجهة/HTTP/HTTPServer/SSLSettings/Ciphers>

2. أدخل الأمر get 443 <interfaceIp>لمعرفة الأصفار المستخدمة بالفعل على هذه الواجهة. يجب أن تكون هناك مجموعة واحدة على الأقل من مجموعات Cisco الموصى بها (راجع متطلبات الهوية والأمان لـ XSP|ADP في قسم النظرة العامة).

3. أدخل الأمر add 443 <interfaceIp><cipherName>لإضافة تشفير إلى واجهة خادم HTTP.

   يتطلب XSP|ADP CLI اسم مجموعة التشفير القياسية لـ IANA، وليس اسم مجموعة تشفير OpenSSL. على سبيل المثال، لإضافة تشفير OpenSSL ECDHE-ECDSA-CHACHA20-POLY1305 إلى واجهة خادم HTTP، يمكنك استخدام: XSP|ADP_CLI/الواجهة/HTTP/HTTP SERVER/إعدادات SSL/التشفيرات> إضافة 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

   راجع https://ciphersuite.info/ للعثور على المجموعة بأي من الاسمين.

تكوين إدارة الأجهزة على XSP|ADP وخادم التطبيقات وخادم ملف التعريف

يعد خادم ملف التعريف وXSP|ADP إلزاميين لإدارة الأجهزة. يجب تكوينها وفقًا للتعليمات الواردة في دليل تكوين إدارة أجهزة BroadWorks.