用於 Webex 整合的 CTI 介面組態

list-menu意見回饋?
了解如何為 Webex 和 BroadWorks 設定 CTI 介面、MTL 驗證以及安全事件訂閱。

CTI 介面及相關配置

下面列出了「最內到最外」的組態順序。 遵循此訂單不是強制性的。

  1. 設定 CTI 訂閱的應用程式伺服器

  2. 針對 MTL 驗證 CTI 訂閱設定 XSP | ADP

  3. 開啟輸入連接埠,以實現安全 CTI 介面

  4. 將您的 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 介面組態

  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 介面

必須針對 TLS v1.2 設定與 Webex 雲端互動的 XSP | ADP CTI 介面。 雲端不會談判舊版 TLS 通訊協定 。

若要在 CTI 介面上設定 TLSv1.2 通訊協定:

  1. 登入 XSP|ADP 並導覽至 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. 輸入指令以get <interfaceIp>查看此介面上已使用哪些通訊協定。

  3. 輸入指令add <interfaceIp> TLSv1.2以確保介面可以在與雲端通訊時使用 TLS 1.2。

在 CTI 介面上編輯 TLS 加密組態

若要在 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-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,請執行下列操作:

  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 介面並啟用 MTL

  1. 新增 CTI SSL 介面。

    CLI 前後關聯取決於您的廣播公司版本。 該命令會在介面上建立自簽的伺服器憑證,並強制介面需要用戶端憑證。

    • 在廣域工廠 R22 和 R23 上:

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

  2. 取代 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>

  3. 重新啟動 XSP | ADP。

啟用對 Webex 上廣域工廠 CTI 事件的存取

在 Partner Hub 中設定叢集時,您需要新增和驗證 CTI 介面。 如需詳細說明,請參閱在合作夥伴中心中設定合 作夥伴組織。

  • 指定 Webex 可用來訂閱廣域工廠 CTI 事件的 CTI 位址。

  • CTI 訂閱以每位訂戶為基礎,只有在該訂戶為 Cisco BroadWorks 的 Webex 佈建時,才會建立和維護。

本文是否有幫助?
本文是否有幫助?