تكوين واجهة CTI لتكامل Webex

list-menuهل لديك ملاحظات؟
تعلم كيفية تكوين واجهة CTI ومصادقة mTLS واشتراكات الأحداث الآمنة لـ Webex وBroadWorks.

واجهة CTI والتكوين ذي الصلة

يتم سرد ترتيب التكوين «من الداخل إلى أقصى حد» أدناه. اتباع هذا الطلب ليس إلزاميًا.

  1. تكوين خادم التطبيقات لاشتراكات CTI

  2. تكوين XSP|ADPS لاشتراكات CTI المصادق عليها من MTL

  3. افتح المنافذ الواردة لواجهة CTI الآمنة

  4. اشترك في منظمة Webex الخاصة بك في أحداث BroadWorks CTI

تكوين خادم التطبيقات لاشتراكات CTI

قم بتحديث هوية العميل على خادم التطبيقات باستخدام الاسم الشائع (CN) لشهادة عميل Webex لـ Cisco BroadWorks CTI.

بالنسبة لكل خادم تطبيق تستخدمه مع Webex، أضف هوية الشهادة إلى ClientIdentity كما يلي:

AS_CLI/System/ClientIdentity> add bwcticlient.webex.com

الاسم الشائع لشهادة عميل Webex لـ Cisco BroadWorks هو. bwcticlient.webex.com

تكوين TLS والأصفار على واجهة CTI

مستويات التكوين لواجهة XSP|ADP CTI هي كما يلي:

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

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

الخصوصية

سياق CLI

نظام (عالمي)

(R22 والإصدارات الأحدث)

XSP| ADP_CLI /النظام/SSLالإعدادات العامة/JSSE/الأصفار >

XSP| ADP_CLI /النظام/SSLالإعدادات العامة/JSSE/البروتوكولات >

بروتوكولات النقل لهذا النظام

(R22 والإصدارات الأحدث)

XSP| ADP_CLI /النظام/SSL > الإعدادات الشائعة\ فتح SSL\ التشفير >

XSP| ADP_CLI /النظام/SSLالإعدادات العامة/OpenSSL/البروتوكولات >

جميع واجهات CTI على هذا النظام

(R22 والإصدارات الأحدث)

XSP| ADP_CLI /الواجهة/CTI/SSLالإعدادات العامة/التشفير >

XSP| ADP_CLI /الواجهة/CTI/SSL الإعدادات/البروتوكولات الشائعة >

واجهة CTI محددة على هذا النظام

(R22 والإصدارات الأحدث)

XSP| ADP_CLI /الواجهة/CTI/خادم CTI/CTI/إعدادات SSL/التشفير >

XSP| ADP_CLI /الواجهة/CTI/CTI/CTI/CTI/إعدادات بروتوكولات SSL >

عند التثبيت الجديد، يتم تثبيت الأصفار التالية افتراضيًا على مستوى النظام. إذا لم يتم تكوين أي شيء على مستوى الواجهة (على سبيل المثال، في واجهة CTI أو واجهة HTTP)، يتم تطبيق قائمة التشفير هذه. لاحظ أن هذه القائمة قد تتغير بمرور الوقت:

  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256

  • TLS_DHE_DSS_WITH_AES_128_GCM_SHA256

  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_DHE_DSS_WITH_AES_128_CBC_SHA256

  • TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256

  • TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256

قراءة تكوين واجهة CTI TLS على XSP|ADP

  1. قم بتسجيل الدخول إلى XSP|ADP وانتقل إلى XSP|ADP_CLI/Interface/CTI/CTIServer>

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

    XSP|ADP_CLI/Interface/CTI/CTIServer> get
      Interface IP  Port  Secure  Server Certificate  Client Auth Req
    =================================================================
      10.155.6.175  8012    true                true             true
    

إضافة بروتوكول TLS 1.2 إلى واجهة CTI

يجب تكوين واجهة XSP|ADP CTI التي تتفاعل مع سحابة Webex لـ TLS v1.2. لا تتفاوض السحابة مع الإصدارات السابقة من بروتوكول TLS.

لتكوين بروتوكول TLSv1.2 على واجهة CTI:

  1. قم بتسجيل الدخول إلى XSP|ADP وانتقل إلى XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

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

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

تحرير تكوين شفرات TLS على واجهة CTI

لتكوين الأصفار المطلوبة على واجهة CTI:

  1. قم بتسجيل الدخول إلى XSP|ADP وانتقل إلى XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

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

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

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

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

مرتكزات الثقة لواجهة CTI (R22 والإصدارات الأحدث)

يفترض هذا الإجراء أن XSP|ADPs إما تواجه الإنترنت أو تواجه الإنترنت عبر وكيل تمريري. يختلف تكوين الشهادة بالنسبة للوكيل التجسير (راجع متطلبات شهادة TLS لـ TLS-bridge Proxy).

بالنسبة لكل XSP|ADP في بنيتك الأساسية التي تنشر أحداث CTI على Webex، قم بما يلي:

  1. قم بتسجيل الدخول إلى Partner Hub.

  2. انتقل إلى الخدمات > روابط إضافية وانقر فوق تنزيل شهادة Webex CA للحصول CombinedCertChain2023.txtعلى جهاز الكمبيوتر المحلي الخاص بك.

    تحتوي هذه الملفات على مجموعتين من شهادتين. يجب تقسيم الملفات قبل تحميلها إلى XSP|ADPS. جميع الملفات مطلوبة.

  3. قسّم سلسلة الشهادات إلى شهادتين - combinedcertchain2023.txt

    1. افتح combinedcertchain2023.txtفي محرر نصوص.

    2. حدد الكتلة الأولى من النص وقم بقصها، بما في ذلك الأسطر -----BEGIN CERTIFICATE----------END CERTIFICATE-----، ثم قم بلصق الكتلة النصية في ملف جديد.

    3. احفظ الملف الجديد باسم root2023.txt.

    4. احفظ الملف الأصلي باسم issuing2023.txt. يجب أن يحتوي الملف الأصلي الآن على كتلة نصية واحدة فقط، محاطة بالأسطر -----BEGIN CERTIFICATE-----و -----END CERTIFICATE-----.

  4. انسخ كلا الملفين النصين إلى موقع مؤقت على XSP|ADP الذي تقوم بتأمينه، على سبيل المثال و /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

  5. قم بتسجيل الدخول إلى XSP|ADP وانتقل إلى /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (اختياري) قم help updateTrustبالتشغيل لرؤية المعلمات وتنسيق الأوامر.

  7. قم بتحميل ملفات الشهادات إلى مراكز الثقة الجديدة - 2023

    XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt

    XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt

    يجب أن تحتوي جميع الأسماء المستعارة على اسم مختلف. webexclientroot2023، webexclientissuing2023وهي أمثلة على الأسماء المستعارة لمراسي الثقة؛ يمكنك استخدام الاسم الخاص بك طالما أن جميع الإدخالات فريدة.

  8. تأكد من تحديث المراسي:

    XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get

      Alias   Owner                                   Issuer
    =============================================================================
    webexclientissuing2023       Internal Private TLS SubCA      Internal Private Root
    webexclientroot2023       Internal Private Root      Internal Private Root[self-signed]
  9. السماح للعملاء بالمصادقة باستخدام الشهادات:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

إضافة واجهة CTI وتمكين mTLS

  1. أضف واجهة CTI SSL.

    يعتمد سياق CLI على إصدار BroadWorks الخاص بك. يقوم الأمر بإنشاء شهادة خادم موقعة ذاتيًا على الواجهة، ويفرض على الواجهة طلب شهادة عميل.

    • في برودووركس R22 وR23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true

  2. استبدل شهادة الخادم والمفتاح على واجهات CTI الخاصة بـ XSP|ADP. تحتاج إلى عنوان IP الخاص بواجهة CTI لهذا الغرض؛ يمكنك قراءته من السياق التالي:

    • في برودووركس R22 وR23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      ثم قم بتشغيل الأوامر التالية لاستبدال الشهادة الموقعة ذاتيًا للواجهة بالشهادة الخاصة بك والمفتاح الخاص:

      XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>

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

تمكين الوصول إلى أحداث BroadWorks CTI على Webex

تحتاج إلى إضافة واجهة CTI والتحقق من صحتها عند تكوين المجموعات الخاصة بك في Partner Hub. راجع تكوين المؤسسة الشريكة في Partner Hub للحصول على تعليمات مفصلة.

  • حدد عنوان CTI الذي يمكن لـ Webex من خلاله الاشتراك في أحداث BroadWorks CTI.

  • تتم اشتراكات CTI على أساس كل مشترك ويتم إنشاؤها وصيانتها فقط أثناء توفير هذا المشترك لـ Webex لـ Cisco BroadWorks.

هل كان هذا المقال مفيدًا؟
هل كان هذا المقال مفيدًا؟