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

list-menuОтправить обратную связь?
Узнайте, как настроить интерфейс CTI, аутентификацию MTLS и безопасные подписки на события для Webex и BroadWorks.

Интерфейс CTI и связанная с ним конфигурация

Порядок конфигураций «от самого главного к самому» указан ниже. Соблюдение этого порядка не обязательно.

  1. Настройте сервер приложений для подписок CTI

  2. Настройте xSP|ADPS для подписок CTI, аутентифицированных MTLS

  3. Откройте входящие порты для безопасного интерфейса CTI

  4. Подпишитесь на мероприятия BroadWorks CTI в своей организации Webex

Настройте сервер приложений для подписок CTI

Обновите ClientIdentity на сервере приложений, указав общее имя (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 = Наиболее специфичный

Для просмотра или изменения различных настроек SSL используются следующие контексты интерфейса командной строки:

Специфика

Контекст интерфейса командной строки

Система (глобальная)

(R22 и более поздние версии)

XSP| /Общие настройки системы/SSL/JSSE/шифры > ADP_CLI

XSP | ADP_CLI /Общие настройки системы/SSL/JSSE/Протоколы >

Транспортные протоколы для этой системы

(R22 и более поздние версии)

ADP_CLIXSP|/Общие настройки системы/SSL/OpenSSL/Шифры >

XSP | ADP_CLI /Общие настройки системы/SSL/OpenSSL/Протоколы >

Все интерфейсы CTI в этой системе

(R22 и более поздние версии)

ADP_CLIXSP|/Интерфейс/CTI/SSL Общие настройки/шифры >

ADP_CLIXSP|/Интерфейс/CTI/SSL Общие настройки/протоколы >

Особый интерфейс CTI в этой системе

(R22 и более поздние версии)

ADP_CLIXSP|/интерфейс/сервер CTI/CTI/настройки/шифры SSL>

ADP_CLIXSP|/Интерфейс/CTI/CTI Серверы/Протоколы SL >

При новой установке на системном уровне по умолчанию устанавливаются следующие шифры. Если на уровне интерфейса ничего не настроено (например, в интерфейсе 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 версии 1.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 требуется стандартное имя набора шифров IANA, а не имя набора шифров OpenSSL. Например, чтобы добавить шифр OpenSSL в интерфейс CTI ECDHE-ECDSA-CHACHA20-POLY1305, вы должны использовать: 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|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.

    Контекст интерфейса командной строки зависит от версии BroadWorks. Команда создает самозаверяющий сертификат сервера в интерфейсе и заставляет интерфейс требовать сертификат клиента.

    • В BroadWorks R22 и R23:

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

  2. Замените сертификат и ключ сервера на интерфейсах CTI XSP|ADP. Для этого вам нужен IP-адрес интерфейса CTI; его можно прочитать в следующем контексте:

    • В BroadWorks 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.

Была ли статья полезной?
Была ли статья полезной?