内容

概要

前提条件

要件

使用するコンポーネント

背景説明

設定

検証

CUCM

アプリケーション/TSP

確認

トラブルシュート

TSPからのトレース例

概要

このドキュメントでは、Cisco Unified Communications Manager(CUCM)とセキュリティテレフォニーサービスプロバイダ(TSP)の統合について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

- CUCM バージョン 11.5 以上

- TSPプラグイン

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

- Cisco Call Managerバージョン11.5

- TSPプラグイン

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

Cisco TSPのコンポーネントは次のとおりです。

- CiscoTSP dll:CiscoTSPによって提供されるTAPIサービスの実装

- CTIQBE over TCP/IP：デバイスと回線の監視と制御に使用されるシスコプロトコル

- CTI Manager Service:CTIリソースとデバイスへの接続を管理します。Cisco TSPまたはJTAPI APIを介してサードパーティアプリケーションに公開

1. セキュアな接続中に、CiscoTSPは証明書信頼リスト(CTL)ファイルを取得するために、TFTP接続を実行します。

2. スタンドアロンクラスタのCTLファイルは、ITL回復、コールマネージャ、およびCertificate Authority Proxy Function(CAPF)証明書で構成されます。次に、CiscoTSPは、CiscoTSP設定で指定されたインスタンスIDと認証文字列を使用して、CAPFハンドシェイクを実行します。

3. ハンドシェイクが成功すると、CiscoTSPはエンドユーザのCAPFインスタンスの情報を含むQBE証明書を作成します。

注：Cisco TSPはオフラインCAでは動作しません。

設定

検証

- Cisco CTLクライアントのインストールと設定に必要な作業をすべて実行したことを確認します。[エンタープライズパラメータ設定(Enterprise Parameters Configuration)]ウィンドウの[クラスタセキュリティモード(Cluster Security Mode)]が1（混合モード）であることを確認します。

- CAPFを使用するには、最初のノードでCisco CAPFサービスをアクティブにする必要があります。

- 多数の証明書を同時に生成するとコール処理の中断が発生する可能性があるため、スケジュールされたメンテナンス時間帯にCAPFを使用することを強く推奨します。

- 証明書操作全体で、最初のノードが機能し、実行されていることを確認します。

- 証明書操作全体でCTI/JTAPI/TAPIアプリケーションが機能していることを確認します。

CUCM

1. アプリケーションユーザの作成：

- アプリケーションまたはエンドユーザが[Standard CTI Enabled]グループに存在することを確認します

- アプリケーションユーザまたはエンドユーザをStandard CTI Secure Connectionユーザグループに追加するには、[Standard CTI Secure Connection]リンクをクリックします

- アプリケーションユーザまたはエンドユーザを[Standard CTI Allow Reception of SRTP Key Material]ユーザグループに追加するには、図に示すように[Standard CTI Allow Reception of SRTP Key Material]リンクをクリックします。

2. 図に示すように、アプリケーションユーザのCAPFプロファイルを作成します。

3. ステップ1.で作成したユーザを選択します(tapi)。

4. インスタンスIDとして任意の番号を指定します。

5. 証明書[Operation in install upgrade]を選択します。

アプリケーション/TSP

1. TAPIプラグインをCUCMからダウンロードしてインストールします([アプリケーション] > [プラグイン]に移動します)。

2. 図に示すように、CUCMで設定されているアプリケーションユーザの詳細を追加します。

3. 図に示すように、CTIマネージャの詳細を入力します。

4. 図に示すように、CUCMと同じ認可文字列を入力し、証明書をダウンロードする必要があるため1回[Fetch Certificate]をクリックします。

確認

ここでは、設定が正常に機能しているかどうかを確認します。

- アプリケーションユーザのCAPFプロファイルでは、Locally Significant Certificate(LSC)が正しくインストールされている必要があります。図に示すように、証明書操作のステータスは操作を保留にしないでください。

- CUCMからのすべての証明書がWindowsマシンにダウンロードされます。Path: C:\ProgramData\Cisco\certificates\ciscotsp001 と、図に示すように。

- また、Windows内蔵の電話ダイヤラを使用して、CTI統合が正常に動作しているかどうかを確認することもできます。CTI統合が成功すると、図に示すように、ユーザが制御する電話機の内線番号を確認できます。

トラブルシュート

ここでは、設定のトラブルシューティングに使用できる情報を示します。

- 図に示すように、アプリケーション(TSP)側からトレースをdetailedに設定し、デフォルトのトレースの場所をC:\Tempに設定する必要があります。

- CUCM側からは、次のトレースが必要です（CUCM側ではトレースが必要です）。

- TVSトレース

- TFTPトレース

- CAPFトレース

TSPからのトレース例

- まず、TSPはCTLファイルを取得するためにTFTPサーバに接続します。

16:31:04.075 |   CSSLHelper::GetCTLFromTFTP CTLFileName = CTLCAPFA6A63C5.tlv

16:31:04.075 |-->TftpClient::TftpClient()

16:31:04.075 |   TftpClient::TftpClient() [] TftpClient instantiated successfully

- スタンドアロンクラスタのCTLファイルは、ITLrecovery、call manager、およびCAPF証明書で構成されます。次に、CiscoTSPは、CiscoTSP設定で指定されたインスタンスIDと認証文字列を使用して、CAPFハンドシェイクを実行します。ハンドシェイクが成功すると、CiscoTSPはエンドユーザのCAPFインスタンスの情報を含むQBE証明書を作成します。

16:31:04.151 |   CSSLHelper::GetCTLFromTFTP fullname = C:\ProgramData\Cisco\certificates\ciscotsp001/., fileName = .

16:31:04.151 |   CSSLHelper::GetCTLFromTFTP fullname = C:\ProgramData\Cisco\certificates\ciscotsp001/.., fileName = ..

16:31:04.151 |   CSSLHelper::GetCTLFromTFTP fullname = C:\ProgramData\Cisco\certificates\ciscotsp001/417b2018.0, fileName = 417b2018.0

16:31:04.154 |   CSSLHelper::GetCTLFromTFTP CERT SUBJECTNAME = /C=IN/O=cisco/OU=tac/CN=ITLRECOVERY_cucm11-pub/ST=Karnataka/L=BGL

16:31:04.154 |   CSSLHelper::GetCTLFromTFTP fullname = C:\ProgramData\Cisco\certificates\ciscotsp001/f6bd2fd0.0, fileName = f6bd2fd0.0

16:31:04.156 |   CSSLHelper::GetCTLFromTFTP CERT SUBJECTNAME = /C=IN/O=cisco/OU=tac/CN=cucm11-pub/ST=Karnataka/L=BGL

16:31:04.156 |   CSSLHelper::GetCTLFromTFTP fullname = C:\ProgramData\Cisco\certificates\ciscotsp001/fed232f9.0, fileName = fed232f9.0

16:31:04.158 |   CSSLHelper::GetCTLFromTFTP CERT SUBJECTNAME = /C=IN/O=cisco/OU=tac/CN=CAPF-c5d37298/ST=Karnataka/L=BGL

- CAPFを使用したセキュリティ・ソケット層(SSL)ハンドシェイクが成功しました：

16:31:04.177 |   CSSLHelper::startSSLConnectThread() SSLConnect thread created: threadHandle=1184 threadId=12504

16:31:04.177 |<--CSSLHelper::startSSLConnectThread()

16:31:04.183 |-->CSSLHelper::SSLConnectThreadEntry()

16:31:04.232 |   CSSLHelper::SSLConnectThreadEntry() Handshake: Finished

16:31:04.232 |   CSSLHelper::SSLConnectThreadEntry() SSL connection using AES128-SHA

16:31:04.232 |   CSSLHelper::SSLConnectThreadEntry() SSLConnect thread exiting ...

- アプリケーションユーザの詳細で作成されたQBEクライアント証明書：

16:31:05.295 |   CAPFclient::openFile() CAPF client: open file C:\ProgramData\Cisco\certificates\ciscotsp001/QBEClient.cer mode w+b

16:31:05.295 |<--CAPFclient::openFile()

16:31:05.296 |-->CAPFclient::openFile()

16:31:05.299 |   CAPFclient::openFile() CAPF client: open file C:\ProgramData\Cisco\certificates\ciscotsp001/QBEClient.pem mode w+b