Cisco BroadWorks 版 Webex でのディレクトリ同期

ディレクトリ同期により、Cisco BroadWorks 版 Webex ユーザーは Webex アプリから Webex ディレクトリを使用して、BroadWorks サーバーから任意の通話エンティティに発信できます。 この機能は、ユーザー プロビジョニングの一部ではない BroadWorks の通話情報を Webex ディレクトリに同期します。

Cisco BroadWorks 版 Webex ユーザーのプロビジョニングは、Cisco BroadWorks 版 Webex ユーザーの通話詳細 (プライマリ電話番号、携帯電話番号、内線) で Webex ディレクトリを更新しますが、外部通話レコードは省略されます。 ただし、ディレクトリ同期がオンの場合、この機能は次の通話レコードを Webex ディレクトリに同期します。

• BroadWorks のみの通話ユーザー (Webex にオンボードされていない)

• ユーザー以外の通話エンティティ (会議室の電話、ファックス機、ハント グループ番号など)

• BroadWorks 電話リストのエントリ

次の表は、BroadWorks の通話レコードを要約し、Webex ディレクトリに追加する方法を示します。

ディレクトリ同期の条件

• パートナー管理者は、パートナーレベルで機能を有効にする必要があります。 パートナー管理者は、一度の操作で複数の顧客組織に対してこの機能をオンまたはオフにできます。

• デフォルトでは、同期を有効にしてから 1 週間後に最初の同期が行われます (同期開始のために選ばれる時間はランダムです)。 ただし、顧客組織は [今すぐ同期] オプションを使用して、1 週間の待機期間をバイパスし、特定の顧客組織の即時同期をトリガーできます。

• デフォルトでは、ディレクトリ同期は各顧客に対して毎週実行されます。 各同期は、最後の同期がスケジュールされたか、または今すぐ同期で手動でトリガーされたかにかかわらず、最後の同期の1週間後に発生します。

• BroadWorks クラスタあたりの同時同期最大数は 2 つです。 1 つのスケジュール済み同期と 1 つのオンデマンド同期 (API または Partner Hub GUI 経由)。 ただし、管理者は同じ BroadWorks から 2 つのオンデマンド同期を同時に実行することはできません。 この制限は、同期が API 経由で開始されたか、Partner Hub の Sync Now オプション経由で開始されたかにかかわらず、存在します。 さらに、Webex は同じ BroadWorks から同時に実行する 2 つのスケジュール済み同期をスケジュールしません。

• 同期に失敗した場合、Webex は次のスケジュールされた同期まで 24 時間ごとに自動的に同期を再試行します。

• 同期は、電話番号を持たないユーザーを無視します。

• Partner Hub では、特定の顧客の同期ステータス情報を確認できます。 さらに、最後の同期の詳細情報を CSV レコードにエクスポートすることもできます。 CSV レコードは、Control Hub の表示よりも詳細を提供し、トラブルシューティング、分析、監査に役立ちます。

• Webex はユーザーの連絡先を暗号化された形式で保存します。 連絡先を所有しているユーザーのみが復号キーにアクセスできます。

• BroadWorks のみの通話ユーザーと非ユーザーの通話エンティティの場合、この機能は BroadWorks から次の電話番号タイプを同期します。

  • 代表電話番号

  • 携帯電話番号

  • Extension

  ただし、プライマリ電話番号または内線番号が存在しない場合、同期は BroadWorks のみの通話ユーザーと非ユーザーの通話エンティティを同期から除外します。

  BroadWorks ユーザーレベルのプライバシー サービスの設定は、ディレクトリ同期の一部としてサポートされていません。

BroadWorks 電話リストと連絡先の最大値

ディレクトリ同期は、BroadWorks 電話リストのエントリを Webex 連絡先にも同期します。 同期されたエントリは、次の連絡先タイプのいずれかに追加されます。

• 組織の連絡先—Webex はこれらの連絡先を組織に対して保存します。 各ユーザーは、組織の組織の連絡先にアクセスできます。 最大連絡先は 30,000 件までです。

• ユーザー連絡先—Webex はこれらの連絡先をユーザーに対して保存します。 連絡先を所有しているユーザーのみが連絡先エントリにアクセスできます。 最大 2000 件の連絡先 (同期された連絡先 1500 件 + 手動入力連絡先 500 件) です。

次の表は、Webex の連絡先タイプを連絡先ソースにマッピングします (BroadWorks の電話リストから同期されるか、手動で追加されます)。

ディレクトリ同期で連絡先の最大数を処理する際には、次の条件が適用されます。

• 組織が、同期で許可される最大連絡先数 (組織連絡先数 30,000 または 1 グループあたり共通の連絡先数 30,000) を超える場合、ディレクトリ同期は最大しきい値を超えるエントリを除外します。 同期された連絡先または省略された連絡先には特定の順序が適用されません。

• 顧客の 1 人がいずれかのカテゴリの最大許容連絡先数を超える場合、その組織をディレクトリ同期から除外するように Cisco にケースを提起することを推奨します。

• 手動連絡先は、ユーザーが Webex アプリに手動で追加する連絡先です。 ユーザーは手動連絡先を最大 500 件追加できます。 手動連絡先は、Webex の大きなユーザー連絡先カテゴリに含まれますが、同期には含まれません。

• 組織連絡先（30000）とグループ連絡先（1グループあたり30000）の合計制限は200000です。

更新情報

Webex ディレクトリにおける更新の処理方法は次のとおりです。

• BroadWorks で連絡先名が変更されると、既存の連絡先が Webex ディレクトリから削除され、新しい連絡先が作成されます。

• BroadWorks で連絡先番号が変更された場合、Webex は Webex ディレクトリ内の既存の連絡先を新しい番号で更新します。

管理者が BroadWorks の連絡先を更新した後、更新がユーザーの Webex アプリに表示される場合、次の条件の概要が表示されます。

• 更新が BroadWorks のみの通話ユーザーまたは非ユーザー通話エンティティである場合、更新はその後のディレクトリ同期の直後にユーザーの Webex アプリに表示されます。

• 更新が BroadWorks 電話リスト エントリの場合:

  • ユーザー連絡先の場合:更新は、後続のディレクトリ同期の直後にユーザーの Webex アプリに表示されます。

  • グループ連絡先の場合 - 更新は、後続のディレクトリ同期直後にユーザーの Webex アプリに表示されます。

  • 組織の連絡先の場合 - Webex ディレクトリはその後のディレクトリ同期で更新されますが、ユーザーは Webex アプリを再起動するか、ローカル 72 時間のキャッシュ タイマーが期限切れになるまで、Webex アプリで変更が表示されません。

次の設定を使用することをおすすめします。

• レート制限値 - 次の OverloadControl システム プロパティ (XSP_CLI/Applications/Xsi-Actions/OverloadControl) を設定します。

  • userDirectoryTransactionLimit - null 値に設定します。

  • globalDirectoryTransactionLimit - null 値に設定します。

  userDirectoryTransactionLimit および globalDirectoryTransactionLimit は null 値に設定することをおすすめします。 しかし、値を割り当てる場合は、それぞれを transactionLimitPeriodSeconds の値(1 のはずです) の少なくとも 5 倍に設定する必要があります。

• トランザクション制限 - 次の値 (XSP_CLI/System/CommunicationUtility/DefaultSettings) を設定します。

  • userTransactionLimits-少なくとも 100 に設定します。

  • transactionLimitPeriodSeconds-1 に設定します。

• ページング値 - Paging システム プロパティ (XSP_CLI/Applications/Xsi-Actions/Paging) を設定します。

  • defaultPageSize - 50 に設定します

  • availableUserMaxLimit - 100 に設定します

• CTI インターフェイス - Webex CA 証明書を CTI インターフェイス信頼ストアにアップロードし、CTI インターフェイスでクライアント認証を有効にすることを確認してください。

また、お使いの BroadWorks のリリースによっては、この機能を有効にする前に BroadWorks 展開に以下のシステム パッチを適用することをおすすめします。

• R22 の場合: AP.as.22.0.1123.ap368517

• R23 の場合: AP.as.23.0.1075.ap368517

• R24 の場合: パッチ不要

パートナー管理者は、新しいテンプレートの作成中に顧客テンプレートのディレクトリ同期を有効にできます。 このテンプレートに割り当てられた新しい顧客組織ではディレクトリ同期が有効になります。 詳細については、「Partner Hub でパートナー組織を構成する」(『Cisco BroadWorks 版 Webex ソリューション ガイド』) にある「顧客テンプレートを設定する」を参照してください。

次に行うこと

Webex アプリでこの機能を有効にするには、Webex アプリの [連絡先] タブを少なくとも 1 回クリックする必要があることをユーザーに周知する必要があります。 これは 1 回だけ完了する必要があります。

developer.webex.com にある公開 API を利用すると、パートナー管理者は管理している顧客組織のディレクトリ同期設定を更新し、即時同期をトリガーしたり、同期ステータス情報を取得したりできます。 ディレクトリ同期メソッドは、BroadWorks エンタープライズの下にグループ化されます。

• List BroadWorks Enterprises - この API メソッドを使用すると、指定されたサービス プロバイダー傘下の企業と各企業の id です。 プロビジョニングで割り当てられた spEnterpriseId を入力する必要があります。

• Update Directory Sync for a BroadWorks Enterprise - エンタープライズ id を入力すると、そのenterpriseのディレクトリ同期のステータスを更新し、ディレクトリ同期を有効または無効にします。

• Trigger Directory Sync for an Enterprise - 特定のエンタープライズ id です。 次のために: syncStatus については、 SYNC_NOW します。

• Get Directory Sync Status for an Enterprise - エンタープライズ id を入力して実行すると、ステータスと最新の同期の trackingId を取得できます。 また、 trackingID を使用して、Kibana や Grafana などのツールで追加の分析ができます。

さらに、管理者はTrigger Directory Sync for a Single User APIを使用して、1 人のユーザーのオンデマンドディレクトリ同期をトリガーできます。

API の詳細なドキュメントについては、https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide を参照してください。

https://developer.webex.com/docs/api/v1/broadworks-subscribers の API 仕様を読むには、サインインが必要です。

ディレクトリ同期には次のエラー コードがあります。

次の表は、この記事の更新情報の要約です。