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

Порядок конфигураций «от самого главного к самому» указан ниже. Соблюдение этого порядка не обязательно.
-
Настройте сервер приложений для подписок CTI
-
Настройте xSP|ADPS для подписок CTI, аутентифицированных MTLS
-
Откройте входящие порты для безопасного интерфейса CTI
-
Подпишитесь на мероприятия 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
-
Войдите в XSP|ADP и перейдите к
XSP|ADP_CLI/Interface/CTI/CTIServer> Введите
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, выполните следующие действия:
-
Войдите в XSP|ADP и перейдите к
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols> -
Введите команду,
get <interfaceIp>чтобы узнать, какие протоколы уже используются в этом интерфейсе. -
Введите команду
add <interfaceIp> TLSv1.2, чтобы интерфейс мог использовать TLS 1.2 при взаимодействии с облаком.
Редактирование конфигурации шифров TLS в интерфейсе CTI
Чтобы настроить необходимые шифры в интерфейсе CTI, выполните следующие действия:
-
Войдите в XSP|ADP и перейдите к
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> -
Введите
getкоманду, чтобы узнать, какие шифры уже используются в этом интерфейсе. Должен быть хотя бы один из рекомендованных Cisco пакетов (см. Требования к идентификации и безопасности XSP|ADP в разделе «Обзор»). -
Введите команду
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, выполните следующее:
-
Войдите в Центр партнеров.
-
Перейдите в раздел Службы > Дополнительные ссылки и нажмите Загрузить сертификат Webex CA, чтобы загрузить его на локальный компьютер.
CombinedCertChain2023.txtЭти файлы содержат два набора по два сертификата. Перед загрузкой в XSP|ADPS файлы необходимо разделить. Все файлы обязательны для заполнения.
-
Разделите цепочку сертификатов на два сертификата —
combinedcertchain2023.txt-
Откройте
combinedcertchain2023.txtв текстовом редакторе. -
Выделите и вырежьте первый блок текста, включая строки
-----BEGIN CERTIFICATE-----и строки-----END CERTIFICATE-----, и вставьте текстовый блок в новый файл. -
Сохраните новый файл как
root2023.txt. -
Сохраните исходный файл как
issuing2023.txt. Теперь исходный файл должен содержать только один блок текста, окруженный линиями-----BEGIN CERTIFICATE-----и.-----END CERTIFICATE-----
-
-
Скопируйте оба текстовых файла во временное место на защищаемом вами XSP|ADP, например
/var/broadworks/tmp/root2023.txt/var/broadworks/tmp/issuing2023.txt -
Войдите в XSP|ADP и перейдите к
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> -
(Необязательно) Запустите
help updateTrust, чтобы увидеть параметры и формат команды. -
Загрузите файлы сертификатов на новые якоря доверия - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txtВсе псевдонимы должны иметь разные имена.
webexclientroot2023, иwebexclientissuing2023являются примерами псевдонимов для якорей доверия; вы можете использовать свои собственные, если все записи уникальны. -
Убедитесь, что анкоры обновлены:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed] -
Разрешите клиентам аутентифицироваться с помощью сертификатов:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Добавьте интерфейс CTI и включите mTLS
-
Добавьте интерфейс CTI SSL.
Контекст интерфейса командной строки зависит от версии BroadWorks. Команда создает самозаверяющий сертификат сервера в интерфейсе и заставляет интерфейс требовать сертификат клиента.
-
В BroadWorks R22 и R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
-
-
Замените сертификат и ключ сервера на интерфейсах 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>
-
-
Перезапустите XSP|ADP.
Включите доступ к мероприятиям BroadWorks CTI в Webex
При настройке кластеров в Partner Hub необходимо добавить и проверить интерфейс CTI. Подробные инструкции см. в разделе Настройка партнерской организации в Partner Hub.
-
Укажите адрес CTI, по которому Webex может подписаться на мероприятия BroadWorks CTI.
-
Подписки CTI предоставляются для каждого подписчика и устанавливаются и поддерживаются только до тех пор, пока этот подписчик подготовлен к использованию Webex для Cisco BroadWorks.