Webexインテグレーション用のCTIインターフェイス構成
CTIインターフェイスと関連する設定

「最も大きいものから最も大きいものへ」の設定順序は以下のとおりです。 この順序に従うことは必須ではありません。
-
CTIサブスクリプション用のアプリケーションサーバーを設定します
-
mTLS 認証済み CTI サブスクリプション用の XSP|ADP を設定してください
-
安全なCTIインターフェイス用のオープンインバウンドポート
-
Webex 組織をブロードワークス CTI イベントに登録してください
CTIサブスクリプション用のアプリケーションサーバーを設定します
アプリケーションサーバーのクライアントIDを、Cisco BroadWorks CTIクライアント証明書用Webexのコモンネーム(CN)で更新してください。
Webexで使用している各アプリケーションサーバーについて、次のように証明書IDを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共通設定/JSSE/暗号 > XSP| ADP_CLI /システム/SSL共通設定/JSSE/プロトコル > |
|
このシステムのトランスポートプロトコル (R22以降) |
XSP| ADP_CLI /システム/SSL共通設定/オープンSSL/暗号 > XSP| ADP_CLI /システム/SSL共通設定/オープンSSL/プロトコル > |
|
このシステムのすべての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サーバー SSL設定/プロトコル > |
新規インストールでは、次の暗号がシステムレベルでデフォルトでインストールされます。 インターフェイスレベル(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
CTI インターフェイスに TLS 1.2 プロトコルを追加する
Webex クラウドとやり取りしている XSP|ADP CTI インターフェイスは TLS v1.2 用に設定する必要があります。 クラウドは以前のバージョンの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コマンドを入力して、 どの暗号がこのインターフェイスですでに使用されているかを確認してください。 シスコが推奨するスイートが少なくとも1つ必要です(「概要」セクションの「XSP|ADP IDおよびセキュリティ要件」を参照)。 -
add <interfaceIp> <cipherName>CTIインターフェイスに暗号を追加するコマンドを入力してください。XSP|ADP CLIには、OpenSSL暗号スイート名ではなく、IANA標準の暗号スイート名が必要です。 たとえば、
ECDHE-ECDSA-CHACHA20-POLY1305OpenSSL暗号を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証明書要件を参照)。
CTI イベントを Webex に公開しているインフラストラクチャ内の XSP|ADP ごとに、次の操作を行います。
-
パートナーハブにサインインしてください。
-
[サービス] > [その他のリンク] に移動し、[Webex CA証明書をダウンロード]
CombinedCertChain2023.txtをクリックしてローカルコンピューターにアクセスしてください。これらのファイルには、2つの証明書が2セット含まれています。 XSP|ADPSにアップロードする前に、ファイルを分割する必要があります。 すべてのファイルが必要です。
-
証明書チェーンを2つの証明書に分割します-
combinedcertchain2023.txt-
combinedcertchain2023.txtテキストエディターで開きます。 -
-----BEGIN CERTIFICATE-----とを含むテキストの最初のブロックを選択して切り取り-----END CERTIFICATE-----、そのテキストブロックを新しいファイルに貼り付けます。 -
root2023.txt新しいファイルに名前を付けて保存してください。 -
issuing2023.txt元のファイルに名前を付けて保存してください。 これで、元のファイルには、-----BEGIN CERTIFICATE-----とという行で囲まれたテキストブロックが1つだけになるはずです-----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インターフェイスを追加してください。
CLIコンテキストは、お使いのBroadWorksのバージョンによって異なります。 このコマンドは、インターフェイス上に自己署名サーバー証明書を作成し、インターフェイスにクライアント証明書を要求させます。
-
ブロードワークス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インターフェイスを追加して検証する必要があります。 詳細な手順については、「Partner Hub でのパートナー組織の設定」を参照してください。
-
Webex が BroadWorks CTI イベントに登録できる CTI アドレスを指定してください。
-
CTIサブスクリプションはサブスクライバーごとであり、そのサブスクライバーがCisco BroadWorks用Webexにプロビジョニングされている間のみ確立および維持されます。