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

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

• BroadWorks 限定通話ユーザー (Webex がオンボーディングされていないユーザー)

• 非ユーザーの通話エンティティ (例会議室電話、fax マシン、ハント グループ)

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

以下の表は、BroadWorks コール記録を要約し、Webex ディレクトリに追加する方法を示します。

ディレクトリ同期の条件

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

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

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

• BroadWorks クラスターごとの同時同期の最大数は 2 つです。1 回のスケジュールされた同期と 1 つのオンデマンド同期 (API またはパートナーハブ GUI 経由) しかし、管理者は同じ BroadWorks から 2 つのオンデマンド同期を同時に実行できない。この制限は、同期が API 経由で開始されたか、パートナーハブの [今すぐ同期] オプションを使用して開始されたかどうかに関係なく存在します。さらに、Webex は同じ BroadWorks から同時に実行される 2 つのスケジュールされた同期をスケジュールする必要があります。

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

• 同期は電話番号を持つユーザーを無視します。

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

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

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

  • 代表電話番号

  • 携帯電話番号

  • Extension

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

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

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

ディレクトリ同期はまた、BroadWorks の電話リストエントリも Webex 連絡先に同期します。同期されたエントリは、以下の連絡先の種類の 1 つに追加されます。

• 組織連絡先—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 Enterprises の下 でグループ化されます。

• List BroadWorks Enterprises—この API メソッドを使用して、指定されたサービス プロバイダーと各エンタープライズの ID の下のエンタープライズのリストを取得します。プロビジョニングで割り当てられているように spEnterpriseId を入力する必要があります。

• BroadWorks Enterprise のディレクトリ同期を更新する—エンタープライズ id を入力して、その企業のディレクトリ syc ステータスを更新し、ディレクトリ同期を有効または無効にします。

• エンタープライズのディレクトリ同期をトリガー: 指定されたエンタープライズ ID の即時同期をトリガーする場合は、この API メソッドを使用します。syncStatus の場合、SYNC_NOW コマンドを入力します。

• エンタープライズのディレクトリ同期ステータスを取得する—エンタープライズ id を入力して実行し、最新の同期のステータスと trackingId を取得します。trackingID を使用して、Kibana や Grafana などのツールを使用して追加の分析を実行できます。

さらに、管理者は単一ユーザー API のトリガー ディレクトリ同期を使用して、単一ユーザーのオンデマンド ディレクトリ同期をトリガできます。

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

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

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

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