Cisco Unified Communications Manager 機能およびサービス ガイド Release 7.0(1)

Webdialer サーブレット

Java サーブレットである Webdialer サーブレットを使用すると、特定のクラスタ内の Cisco Unified Communications Manager ユーザが、コールを開始および終了することや、電話機と回線の設定にアクセスすることができます。

アプリケーションは、次の 2 つのインターフェイスを介して Webdialer サーブレットと通信できます。

• SOAP over HTTP インターフェイス：Simple Object Access Protocol（SOAP）に基づくこのインターフェイスは、Microsoft Outlook Add-in や SameTime Client Plug-in などのデスクトップ アプリケーションを開発するために使用されます。開発者は、isClusterUserSoap インターフェイスを使用して、Redirector サーブレットに類似した機能を必要とする複数クラスタ アプリケーションを設計することができます。

• HTML over HTTPS インターフェイス：HTTPS に基づくこのインターフェイスは、Web ベースのアプリケーションを開発するために使用されます。このインターフェイスを使用する開発者は、複数クラスタ アプリケーションの設計に Redirector サーブレットを使用できます。

Redirector サーブレット

Java ベースの Tomcat サーブレットである Redirector サーブレットは、Cisco WebDialer ユーザが行う要求のために Cisco Unified Communications Manager クラスタを検索します。これは、ユーザの Cisco Unified Communications Manager クラスタ内にある特定の Cisco WebDialer サーバに要求を転送します。Redirector サーブレットは、複数クラスタ アプリケーションおよび HTML over HTTPS インターフェイスを使用して開発されたアプリケーションに対してだけ使用できます。

Redirector サーブレットを使用した Cisco WebDialer の例

たとえば、3 つのクラスタがそれぞれサンノゼ（SJ-CM）、ダラス（D-CM）、ニューヨーク（NY-CM）などの都市にあるとします。各クラスタには、Cisco Unified Communications Manager サーバ SJ-CM1、D-CM2、および NY-CM3 用に設定された Webdialer サーブレットを持つ 3 つの Cisco Unified Communications Manager サーバが含まれています。

システム管理者は、 List of WebDialers サービス パラメータで特定の Cisco Unified Communications Manager サーバの IP アドレスを入力することによって、任意の Cisco Unified Communications Manager サーバで Webdialer サーブレットを設定します（「Webdialer サーブレットのサービス パラメータの設定」を参照してください）。Webdialer サーブレットと Redirector サーブレットの設定については、「Webdialer サーブレットの設定」と「Redirector サーブレットの設定（オプション）」を参照してください。

サンノゼにいるユーザが、Cisco WebDialer によって使用可能にされた社内ディレクトリ検索ウィンドウで電話番号をクリックすると、次のアクションが実行されます。

1. ユーザ アプリケーション（クライアント）が初期 makeCall HTTPS 要求を Redirector サーブレットに送信します。

2. この要求が初めて受信された場合、Redirector サーブレットは Cisco WebDialer サーバのクッキーを読み取り、それが空であることを検出します。

2 回目以降の要求の場合、Redirector サーブレットは、前にクライアントに対して使用された Cisco WebDialer サーバの IP アドレスを読み取り、そのサーバにだけ isClusterUser HTTPS 要求を送信します。

3. Redirector サーブレットは情報を求める応答を送信し、それによって認証ダイアログボックスがユーザに表示されます。

4. ユーザは Cisco Unified Communications Manager ユーザ ID とパスワードを入力し、 ［送信］ ボタンをクリックします。

5. Redirector サーブレットは、この情報からユーザ ID だけを読み取り、システム管理者が設定した各 Cisco WebDialer サーバに isClusterUser HTTPS 要求を送信します。

6. Redirector サーブレットは、ユーザからの元の要求を SJ-CM1 に転送します。

追加情報

「関連項目」を参照してください。

インタラクション

Cisco WebDialer には、次のインタラクションがあります。

• Client Matter Codes（CMC）を使用する場合、ユーザはトーンが聞こえたら正しいコードを入力する必要があります。入力しないと IP Phone が切断され、リオーダー音が聞こえます。

• Forced Authorization Codes（FAC）を使用する場合、ユーザはトーンが聞こえたら正しいコードを入力する必要があります。入力しないと IP Phone が切断され、リオーダー音が聞こえます。

• Cisco WebDialer は、ApplicationDialRule データベース テーブルの変更通知を使用して、更新されたダイヤル ルールを追跡および使用します。

制限事項

Cisco WebDialer は、Cisco Computer Telephony Integration（CTI）がサポートする Skinny Client Control Protocol（SCCP）および Session Initiation Protocol（SIP）を実行する電話機だけをサポートしています。

（注） Cisco WebDialer は、SIP を実行する IP Phone モデル 7970/71 と 7961/41 だけをサポートしています。

追加情報

「関連項目」を参照してください。

Cisco WebDialer の設定チェックリスト

表14-1 に、Cisco WebDialer の設定チェックリストを示します。詳細については、「関連項目」を参照してください。

Webdialer サーブレットの設定

Webdialer サーブレットを設定するには、次の手順を実行します。

• Cisco WebDialer サービスをアクティブ化します。「Cisco WebDialer のインストールとアクティブ化」を参照してください。

• トレースを設定します（オプション）。「トレース設定（オプション）」を参照してください。

• Cisco WebDialer サービス パラメータを設定します。「Webdialer サーブレットのサービス パラメータの設定」を参照してください。

• アプリケーション ユーザを設定します。

追加情報

「関連項目」を参照してください。

Webdialer サーブレットのサービス パラメータの設定

Cisco Unified Communications Manager には、Webdialer サーブレット用に次のサービス パラメータがあります。

• CAPF Profile Instance ID for Secure Connection to CTIManager：このパラメータは、Cisco WebDialer サーバが CTI Manager へのセキュアな接続を確立するために使用する Application User WDSecureSysUser の Application CAPF プロファイルのインスタンス ID を指定します。

• List of WebDialers：このパラメータは、会社内のすべての Cisco WebDialer の IP アドレスを示します。新しい値を入力するには、Cisco Unified Communications Manager サーバの IP アドレスと、Cisco WebDialer が有効になっているポート番号を入力します。

（注） Cisco Unified Communications Manager の管理機能 5.0 以降のバージョンでは、たとえば「8443」をポート番号として「172.19.253.97:8443」のようにポート番号を指定する必要があります。

IP アドレスがそれぞれスペースで区切られ、有効な Webdialer サーブレットがクラスタごとに 1 つだけであることを確認します。クラスタごとに複数の Webdialer サーブレットが有効になっている場合は、ユーザが通話相手の電話番号をクリックしたときに、コンピュータにドロップダウン メニューが表示されます。

このドロップダウン メニューには、発信側（電話をかけるエンドユーザ）がいる場所とは別の場所が含まれています。エンドユーザは適切な場所を選択し、電話をかける手順を続行します。

• Primary Cisco CTIManager：プライマリ Cisco CTIManager の IP アドレスを入力します。

Cisco CTI Manager のデフォルトの IP アドレスは 127.0.0.1 です。これは、Cisco WebDialer をセットアップするために使用されるローカル ホスト サーバです。

最大長は 15 桁です。

• Backup Cisco CTIManager：バックアップ Cisco CTIManager の IP アドレスを入力します。最大長は 15 桁です。IP アドレスを入力しない場合は、バックアップ Cisco CTIManager が存在しないことになります。

• User Session Expiry（時間）：ユーザのログイン セッションが有効である期間を時間単位で入力します。

デフォルト値の 0 は、Cisco WebDialer Web Service が次に再起動されるまで、ログイン セッションの有効期間が無限であることを示します。

最短期間は 0 時間、最長期間は 168 時間です。

• Duration of End Call Dialog（秒）：コールを終了するダイアログを表示する時間を秒単位で入力します。このダイアログは、ユーザがエラーでダイヤルアウトした場合にコールを終了する必要があることをユーザに示します。

デフォルト値は 15 秒、最大値は 60 秒、最小値は 10 秒です。

Duration of End Call Dialog サービス パラメータを無効にするには、ユーザ オプション ウィンドウで［Disable Auto-Close］ チェックボックスをオンにします。［Disable Auto-Close］ チェックボックスをオンにした場合、［End Call］ ダイアログは自動的には閉じません。［Hangup］ ボタンを押すと、［Make Call］ ウィンドウに戻ります。

• Apply Application Dial Rules on Dial：デフォルトは［True］ に設定されています。Cisco WebDialer でアプリケーション ダイヤル ルールを使用する必要がない場合は、この設定を［False］ に変更します。

• CTI Manager Connection Security Flag：このクラスタ全体のパラメータは、Cisco WebDialer サービスの CTI Manager 接続のセキュリティを無効にするか、クラスタのセキュリティ モードに準拠するかを指定します。セキュリティが有効になっていると、Cisco WebDialer は、Application CAPF Profile InstanceID for Secure Connection to CTI Manager パラメータで設定される Application CAPF プロファイルを使用して、CTI Manager へのセキュアな接続を確立します。

（注） 変更を行った場合は、Cisco WebDialer サービスを再起動し、変更を有効にする必要があります。

Webdialer サーブレットの初期設定または既存のサービス パラメータの変更を行うには、次の手順を実行します。

手順

ステップ 1 ［システム（System）］ > ［サービスパラメータ（Service Parameters）］ を選択します。

ステップ 2 ［サーバ（Server）］ ドロップダウン リスト ボックスから、Cisco WebDialer サービス パラメータを設定する Cisco Unified Communications Manager サーバを選択します。

ステップ 3 ［サービス（Service）］ ドロップダウン リスト ボックスから、［Cisco WebDialer Web Service］ を選択します。

Primary Cisco CTIManager、Duration of End Call Dialog、User Session Expiry（時間）、および Apply Application Dial Rules on Dial（True）の各パラメータにはデフォルト値があります。アプリケーションでの必要に応じて新しい値を入力します。

Backup Cisco CTIManager パラメータにはデフォルト値は割り当てられていません。アプリケーションにバックアップ Cisco CTIManager が必要な場合は、このパラメータに値を入力します。

ステップ 4 新規パラメータ値を有効にするには、Cisco WebDialer Web Service を再起動します。

追加情報

「関連項目」を参照してください。

アプリケーション ユーザの設定

WebDialer では、コールの発信と着信のために CTI 接続が必要です。WebDialer は、CTI プロバイダーの作成に必要なアプリケーション ユーザとパスワードを使用します（この値は、アプリケーション ユーザとしてデータベースに保存され、システムによってこのデータベースから取得されます）。CTI への TLS 接続をセキュアにするには、「CTI へのセキュアな TLS 接続」を参照してください。

CTI へのセキュアな TLS 接続

Cisco WebDialer は、CTI へのセキュアな（TLS）接続をサポートしています。セキュアな接続を確立するには、「WDSecureSysUser」アプリケーション ユーザを使用します。

（注） Cisco Unified Communications Manager の管理ページの［アプリケーションユーザCAPFプロファイルの設定（Application User CAPF Profile Configuration）］ ウィンドウで、CAPF プロファイルを設定する必要があります。これは、セキュアな接続を確立するための、アプリケーション ユーザ WDSecureSysUser のインスタンス ID 用として設定します。サービス パラメータ ウィンドウからセキュリティを有効にした場合、Cisco WebDialer は、Application CAPF プロファイルを使用して CTI Manager へのセキュアな接続を確立します。セキュアな接続を行うには、「CTI Manager Connection Security Flag」と「CAPF Profile Instance ID for Secure Connection to CTI Manager」の両方のサービス パラメータを設定する必要があります。『Cisco Unified Communications Manager アドミニストレーション ガイド』の「アプリケーションユーザ CAPF プロファイルの設定」および「サービス パラメータの設定」を参照してください。

アプリケーション ユーザを設定するには、次の手順を実行します。

手順

ステップ 1 ［ユーザ管理（User Management）］ >［アプリケーションユーザ（Application User）］ を選択します。

［アプリケーションユーザの検索と一覧表示（Find and List Application Users）］ ウィンドウが表示されます。

ステップ 2 ［検索（Find）］ をクリックします。

ステップ 3 ［アプリケーションユーザの検索と一覧表示（Find and List Application Users）］ ウィンドウで、 ［WDSysUser］ または ［WDSecureSysUser］ をクリックします。

（注） CAPF プロファイルを設定するには、『Cisco Unified Communications Manager アドミニストレーション ガイド』の「アプリケーションユーザ CAPF プロファイルの設定」を参照してください。

（注） WDSysUser に関連付けられたパスワードを変更できます。アプリケーションはデータベースから新しいパスワードを取得します。

追加情報

「関連項目」を参照してください。

WebDialer の言語の設定

Cisco Unified Communications Manager は、Microsoft Internet Explorer などのクライアント ブラウザで設定された言語を優先します（図14-1 を参照）。クライアントに表示される言語を変更するには、（Cisco Unified CM ユーザ オプション メニューの［ユーザロケール（User Locale）］ フィールドではなく）ブラウザの設定を使用します。逆に、Cisco WebDialer は、Cisco Unified CM ユーザ オプション メニューで設定されたロケールを優先します。Cisco WebDialer は、次の方法でロケールにアクセスします。

• Cisco Unified CM ユーザ オプション メニューで Cisco WebDialer ユーザのロケールを、たとえば日本語などに設定できます。そのユーザが WebDialer にログインしたときに、WebDialer の設定ウィンドウは日本語で表示されます。ユーザは、たとえば Microsoft Internet Explorer を使用して、言語をブラウザの言語に変更できます。Cisco WebDialer は、ll_CC の形式だけでブラウザの言語を認識します。たとえば、日本語のロケールは ja_JP と定義されます。

• Cisco WebDialer ユーザは、ロケールなしで設定できます（Cisco Unified CM ユーザ オプション メニューで［ユーザロケール（User Locale）］ フィールドは［None］ に設定されます）。そのユーザが WebDialer にログインすると、WebDialer の設定ウィンドウは英語で表示されます。ブラウザの言語を変更するには、ブラウザにユーザ定義のロケール（ll_CC の形式を使用）を追加する必要があります。たとえば、日本語のロケールは ja_JP と定義されます。

図14-1 Microsoft Internet Explorer のロケール設定

ユーザ定義のロケールを変更する方法については、ブラウザのマニュアルを参照してください。Cisco Unified CM ユーザ オプション メニューでロケールを設定する方法については、『 Web での Cisco Unified IP Phone のカスタマイズ 』を参照してください。

追加情報

「関連項目」を参照してください。

パーティションのサポート

Cisco WebDialer には、回線情報に加えて、JTAPI から提供されるパーティション情報が含まれます。次のリストに、利用可能なさまざまな設定を示します。

• DN が同じ複数の回線：Cisco WebDialer は、異なるパーティションを異なる回線として処理します。

• DN が同じ複数の回線：Cisco WebDialer は、同じパーティションと異なるデバイスをシェアドラインとして処理します。

• DN が同じ複数の回線：Cisco WebDialer は、同じデバイスの同じパーティションをサポートしません。

追加情報

「関連項目」を参照してください。

Redirector サーブレットの設定（オプション）

Redirector サーブレットを設定するのは、アプリケーションに複数のクラスタが必要な場合だけです。Redirector サーブレットを設定するには、次の手順を実行します。

手順

ステップ 1 ［システム（System）］ >［サービスパラメータ（Service Parameters）］ を選択します。

ステップ 2 ［サーバ（Server）］ ドロップダウン リスト ボックスから、Redirector サーブレットを設定する Cisco Unified Communications Manager サーバを選択します。

ステップ 3 ［サービス（Service）］ ドロップダウン リスト ボックスから、［Cisco WebDialer Web Service］ を選択します。

ステップ 4 List of WebDialers パラメータに対しては、アプリケーションでの必要に応じて新しい値を入力します。このサービス パラメータについては、「Webdialer サーブレットのサービス パラメータの設定」を参照してください。

追加情報

「関連項目」を参照してください。

アプリケーションのダイヤル ルールの設定（オプション）

アプリケーションのダイヤル ルールは、Cisco WebDialer の複数クラスタのアプリケーションに対して設定します。

これらのアプリケーションのダイヤル ルールの設定については、『 Cisco Unified Communications Manager アドミニストレーション ガイド 』の「アプリケーションのダイヤル ルール設定」で、ダイヤル ルールの設計とエラー チェックを参照してください。

（注） Cisco WebDialer は、再起動なしでダイヤル ルールの変更を取得する必要があります。

追加情報

「関連項目」を参照してください。

Cisco Unified Communications Manager の標準エンド ユーザ グループへのユーザの追加

ユーザが Cisco Unified Communications Manager のユーザ ディレクトリ ウィンドウで［Cisco WebDialer］ リンクを使用するには、Cisco Unified Communications Manager の標準エンド ユーザ グループに各ユーザを追加する必要があります。次の手順では、このグループにユーザを追加する方法を説明します。

手順

ステップ 1 ［ユーザ管理（User Management）］ >［ユーザグループ（User Group）］ を選択します。

［ユーザグループの検索と一覧表示（Find and List User Groups）］ ウィンドウが表示されます。

［検索（Find）］ をクリックします。

ステップ 2 ［Standard CCM End Users］ リンクをクリックします。

ステップ 3 ［ユーザグループの設定（User Group Configuration）］ ウィンドウが表示されます。

ステップ 4 ［グループにエンドユーザを追加（Add End Users to Group）］ をクリックします。

［ユーザの検索と一覧表示（Find and List Users）］ ウィンドウが表示されます。

ステップ 5 ［検索（Find）］ をクリックします。ユーザごとに条件を入力できます。

ステップ 6 ユーザ グループに追加するユーザの横にあるチェックボックスをオンにして、 ［選択項目の追加（Add Selected）］ をクリックします。

（注） ユーザのリストにあるすべてのユーザを追加する場合は、［すべてを選択（Select All）］ をクリックし、［選択項目の追加（Add Selected）］ をクリックします。

［ユーザグループの設定（User Group Configuration）］ ウィンドウの［グループ内のユーザ（Users in Group）］ 表に、そのユーザが表示されます。

追加情報

「関連項目」を参照してください。

プロキシ ユーザの作成（オプション）

makeCallProxy HTML over HTTP インターフェイスを使用して Cisco WebDialer 用のアプリケーションを開発している場合は、プロキシ ユーザを作成します。makeCallProxy インターフェイスについては、『 Cisco WebDialer API Reference Guide 』の「makeCallProxy」の項を参照してください。

既存のユーザまたは新規ユーザ用に認証プロキシの権限を有効にすることができます。

既存のユーザ用の認証プロキシの権限

既存のユーザ用に認証プロキシの権限を有効にするには、次の手順を実行します。

手順

ステップ 1 ［ユーザ管理（User Management）］ > ［ユーザグループ（User Group）］ を選択します。

［ユーザグループの検索と一覧表示（Find and List User Groups）］ ウィンドウが表示されます。

［検索（Find）］ をクリックします。

ステップ 2 ［Standard EM Authentication Proxy Rights］ リンクをクリックします。

［ユーザグループの設定（User Group Configuration）］ ウィンドウが表示されます。

ステップ 3 ［グループにエンドユーザを追加（Add End Users to Group）］ をクリックします。

［ユーザの検索と一覧表示（Find and List Users）］ ウィンドウが表示されます。

［検索（Find）］ をクリックします。ユーザごとに条件を追加することもできます。

ステップ 4 プロキシの権限を追加するユーザを選択し、 ［選択項目の追加（Add Selected）］ をクリックします。

（注） リストにあるすべてのユーザを追加する場合は、［すべてを選択（Select All）］ をクリックし、［選択項目の追加（Add Selected）］ をクリックします。

［ユーザグループの設定（User Group Configuration）］ ウィンドウの［グループ内のユーザ（Users in Group）］ 表に、そのユーザが表示されます。

新規ユーザ用の認証プロキシの権限

新規ユーザ用に認証プロキシの権限を有効にするには、次の手順を実行します。

手順

ステップ 1 ［ユーザ管理（User Management）］ > ［エンドユーザ（End User）］ を選択します。

ステップ 2 ［新規追加（Add New）］ をクリックします。

ステップ 3 次の必須フィールドに入力します。

［姓（Last Name）］ 、 ［ユーザID（User ID）］ 、 ［パスワード（Password、半角英数字のみ）］ 、 ［パスワードの確認（Confirm Password、半角英数字のみ）］ 、 ［PIN（PIN、半角数字のみ）］ 、および ［PIN の確認（Confirm PIN、半角数字のみ）］

ステップ 4 ［保存（Save）］ をクリックします。

ステップ 5 ［ユーザ管理（User Management）］ > ［ユーザグループ（User Group）］ を選択します。

［ユーザグループの検索と一覧表示（Find and List User Groups）］ ウィンドウが表示されます。

ステップ 6 ［Standard EM Authentication Proxy Rights］ リンクをクリックします。

［ユーザグループの設定（User Group Configuration）］ ウィンドウが表示されます。

ステップ 7 ［グループにエンドユーザを追加（Add End Users to Group）］ をクリックします。

［ユーザの検索と一覧表示（Find and List Users）］ ウィンドウが表示されます。

ステップ 8 ［検索（Find）］ をクリックします。ユーザごとに条件を入力することもできます。

ステップ 9 プロキシの権限を追加するユーザを選択し、 ［選択項目の追加（Add Selected）］ をクリックします。

（注） リストにあるすべてのユーザを追加する場合は、［すべてを選択（Select All）］ をクリックし、［選択項目の追加（Add Selected）］ をクリックします。

［ユーザグループの設定（User Group Configuration）］ ウィンドウの［グループ内のユーザ（Users in Group）］ 表に、そのユーザが表示されます。

追加情報

「関連項目」を参照してください。

トレース設定（オプション）

Cisco Unified Serviceability Administration からトレースを設定できます。トレース ファイルにアクセスするには、次の CLI コマンドを使用します。

file get activelog tomcat/logs/webdialer/log4j

file get activelog tomcat/logs/redirector/log4j

Cisco Unified Real-Time Monitoring Tool（RTMT）を使用してトレースを収集できます。

（注） Cisco WebDialer と Redirector の両方に同じトレース設定が適用されます。

Cisco WebDialer に対してデバッグ トレースを有効にするには、次の手順を実行します。

手順

ステップ 1 Cisco Unified Communications Manager アプリケーションの［ナビゲーション（Navigation）］ ドロップダウン リスト ボックスから、［Cisco Unifiedサービスアビリティ（Cisco Unified Serviceability）］ を選択し、 ［移動（Go）］ をクリックします。

ステップ 2 ［Trace］ >［Configuration］ を選択します。

ステップ 3 ［Server］ ドロップダウン リスト ボックスから、Cisco WebDialer のトレースを有効にするサーバを選択します。

ステップ 4 ［Service］ ドロップダウン リスト ボックスから、［ Cisco WebDialer Web Service ］ を選択します。

ステップ 5 ［Trace Configuration］ ウィンドウで、トラブルシューティングの必要に応じてトレース設定を変更します。トレースの詳細については、『 Cisco Unified Serviceability アドミニストレーション ガイド 』を参照してください。

ステップ 6 ［保存（Save）］ をクリックします。

追加情報

「関連項目」を参照してください。