用於 Webex 整合的 CTI 介面組態
CTI 介面及相關配置

下面列出了「最內到最外」的組態順序。 遵循此訂單不是強制性的。
-
設定 CTI 訂閱的應用程式伺服器
-
針對 MTL 驗證 CTI 訂閱設定 XSP | ADP
-
開啟輸入連接埠,以實現安全 CTI 介面
-
將您的 Webex 組織訂閱廣播工程 CTI 活動
設定 CTI 訂閱的應用程式伺服器
使用適用於思科廣域工程 CTI 用戶端憑證的通用名稱 (CN) 更新應用程式伺服器上的用戶端身分。
針對您與 Webex 搭配使用的每個應用程式伺服器,將憑證識別新增至 ClientIdentity,如下所示:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
適用於思科廣域工程的 Webex 用戶端憑證的通用名稱為。bwcticlient.webex.com
在 CTI 介面上設定 TLS 和加密
XSP|ADP CTI 介面的可配置性等級如下:
最一般 = 系統 > 傳輸 > CTI 接口 > CTI 接口 = 最具體
您用來檢視或 修改不同 SSL 設定的 CLI 前後關聯如下:
|
特定性 |
CLI 前後關聯 |
|---|---|
|
系統 (全球) (R22 及更高版本) |
XSP| ADP_CLI /系統/SSL 共用設定/JSS/加密 > XSP| ADP_CLI /系統/SSL 共用設定/JSS/協定 > |
|
此系統 的傳輸協議 (R22 及更高版本) |
XSP| ADP_CLI /系統/SSL 共用設定/開放軟體 SL/加密 > XSP| ADP_CLI /系統/SSL 共用設定/OpenSSL/通訊協定 > |
|
此系統上的所有 CTI 介面 (R22 及更高版本) |
XSP|ADP_CLI/介面/CTI/SSL 共用設定/密碼 > XSP|ADP_CLI/介面/CTI/SSL 共用設定/通訊協定 > |
|
此系統上的特定 CTI 介面 (R22 及更高版本) |
XSP|ADP_CLI/介面/CTI/CTI 伺服器/SSL 設定/密碼 > 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
在 XSP | ADP 上讀取 CTI TLS 介面組態
-
登入 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 介面
必須針對 TLS v1.2 設定與 Webex 雲端互動的 XSP | ADP CTI 介面。 雲端不會談判舊版 TLS 通訊協定 。
若要在 CTI 介面上設定 TLSv1.2 通訊協定:
-
登入 XSP|ADP 並導覽至
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols> -
輸入指令以
get <interfaceIp>查看此介面上已使用哪些通訊協定。 -
輸入指令
add <interfaceIp> TLSv1.2以確保介面可以在與雲端通訊時使用 TLS 1.2。
在 CTI 介面上編輯 TLS 加密組態
若要在 CTI 介面上設定所需的密碼,請執行下列步驟:
-
登入 XSP|ADP 並導覽至
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> -
輸入
get指令以查看此介面上已使用哪些 密碼。 Cisco 推薦套件中至少必須有一 個 (請參閱「概觀」段落中的 XSP|ADP 身分與安全 性需求)。 -
輸入指令
add <interfaceIp> <cipherName>以將密碼加入至 CTI 介面。XSP | ADP CLI 需要 IANA 標準加密套件名稱,而不是 OpenSSL 加密套件名稱。 例如,若要將 OpenSSL 密碼新增至
ECDHE-ECDSA-CHACHA20-POLY1305CTI 介面,您可以 使用: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 憑證需求)。
對於基礎架構中發佈 CTI 事件到 Webex 的每個 XSP|ADP,請執行下列操作:
-
登入 Partner Hub。
-
前往服務 > 其他連結,然後按一下下載 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 介面並啟用 MTL
-
新增 CTI SSL 介面。
CLI 前後關聯取決於您的廣播公司版本。 該命令會在介面上建立自簽的伺服器憑證,並強制介面需要用戶端憑證。
-
在廣域工廠 R22 和 R23 上:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
-
-
取代 XSP|ADP 的 CTI 介面上的伺服器憑證和金鑰。 為此 ,您需要 CTI 介面的 IP 位址;您可以從以 下內容中讀取它:
-
在廣域工廠 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。
啟用對 Webex 上廣域工廠 CTI 事件的存取
在 Partner Hub 中設定叢集時,您需要新增和驗證 CTI 介面。 如需詳細說明,請參閱在合作夥伴中心中設定合 作夥伴組織。
-
指定 Webex 可用來訂閱廣域工廠 CTI 事件的 CTI 位址。
-
CTI 訂閱以每位訂戶為基礎,只有在該訂戶為 Cisco BroadWorks 的 Webex 佈建時,才會建立和維護。