Конфігурація інтерфейсу CTI для інтеграції Webex

list-menuНадіслати відгук?
Дізнайтеся, як налаштовувати інтерфейс CTI, автентифікацію MTLS та захищені підписки на події для Webex та BroadWorks.

Інтерфейс CTI та відповідна конфігурація

Порядок конфігурації «від самого до самого крайнього» наведено нижче. Дотримання цього замовлення не є обов'язковим.

  1. Налаштування сервера додатків для підписки CTI

  2. Налаштування XSP|ADP для автентифікованих MTL передплат CTI

  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| /Система/SSLЗагальні Налаштування/JSSE/Шифри > ADP_CLI

XSP| /Система/SSLЗагальні Налаштування/JSSE/Протоколи > ADP_CLI

Транспор тні протоколи для цієї системи

(R22 і пізніші версії)

XSP| /Система/SSLЗагальні Налаштування/OpenSSL/Шифри > ADP_CLI

XSP| /Система/SSLЗагальні Налаштування/OpenSSL/Протоколи > ADP_CLI

Всі інтерфейси CTI в цій системі

(R22 і пізніші версії)

XSP| ADP_CLI /Інтерфейс/CTI/SSLЗагальні Налаштування/Шифри >

XSP| ADP_CLI /Інтерфейс/CTI/SSLЗагальні Налаштування/Протоколи >

Специфічний інтерфейс CTI в цій системі

(R22 і пізніші версії)

XSP| /Інтерфейс/CTI/CTIСервер/Налаштування SSL/Шифри > ADP_CLI

XSP| ADP_CLI /Інтерфейс/CTI/CTIСервериНалаштування/Протоколи >

При свіжій інсталяції на системному рівні за замовчуванням встановлюються наступні шифри. Якщо нічого не налаштовано на рівні інтерфейсу (наприклад, на інтерфейсі 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.

    CLI XSP|ADP вимагає назви стандартного пакету шифрів 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|ADP або звернені до Інтернету, або стикаються з Інтернетом через проксі-сервер. Конфігурація сертифіката відрізняється для мостового проксі- сервера (див. Вимоги до сертифікатів TLS для проксі-сервера TLS-Bridge).

Для кожного XSP|ADP у вашій інфраструктурі, який публікує події CTI у Webex, виконайте такі дії:

  1. Увійдіть у Партнерський центр.

  2. Перейдіть до Слу ж би > Додаткові посилання та натисніть Завантажити сертифікат Webex CA, щоб CombinedCertChain2023.txtперейти на локальний комп'ютер.

    Ці файли містять два набори з двох сертифікатів. Вам потрібно розділити файли, перш ніж завантажувати їх у XSP|ADP. Всі файли обов'язкові.

  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 та увімкніть MTL

  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

Під час налаштування кластерів у Partner Hub потрібно додавати та перевіряти інтерфейс CTI. Докла дні інструкції див. у розділі Налаштування партнерської організації в Partner Hub.

  • Вкажіть адресу CTI, за якою Webex може підписатися на події BroadWorks CTI.

  • Підписки CTI надаються на основі кожного абонента і створюються та підтримуються лише тоді, коли цей абонент забезпечений для Webex для Cisco BroadWorks.

Чи була ця стаття корисною?
Чи була ця стаття корисною?