ディレクトリ同期により、Cisco BroadWorks 向け Webex ユーザーは Webex アプリの Webex ディレクトリを使用して、BroadWorks サーバーのすべての発信エンティティを呼び出すことができます。 この機能は、ユーザープロビジョニングに含まれていなかったBroadWorksの通話情報をWebexディレクトリに同期します。

Cisco BroadWorks 向け Webex のユーザープロビジョニングは、Webex ディレクトリを Cisco BroadWorks ユーザー向け Webex の通話詳細（主電話番号、携帯電話番号、内線番号）で更新しますが、外部の通話記録は省略します。 ただし、ディレクトリ同期がオンの場合、この機能は次の通話記録もWebexディレクトリに同期します。

• Broadworks専用の通話ユーザー（Webexにオンボーディングしていないユーザー）

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

• ブロードワークスの電話リストのエントリ

次の表は、BroadWorksの通話記録をまとめ、それらがどのようにWebexディレクトリに追加されるかを示しています。

ディレクトリ同期条件

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

• デフォルトでは、最初の同期は同期を有効にしてから1週間後に行われます（同期を開始する時間はランダムです）。 ただし、顧客組織は「今すぐ同期」オプションを使用すると、1週間の待機期間を回避して、特定の顧客組織の即時同期を開始できます。

• デフォルトでは、ディレクトリ同期は顧客ごとに毎週実行されます。 最後の同期がスケジュールされたか、Sync Nowで手動でトリガーされたかに関係なく、各同期は最後の同期の1週間後に行われます。

• BroadWorksクラスタあたりの同時同期の最大数は、定期同期とオンデマンド同期（APIまたはパートナーハブGUI経由）の2つです。 ただし、管理者は同じ BroadWorks から 2 つのオンデマンド同期を同時に実行することはできません。 この制限は、同期がAPIを介して開始されたか、パートナーハブのSync Nowオプションを介して開始されたかに関係なく存在します。 さらに、Webex は、同じ BroadWorks から 2 つの定期同期を同時に実行するようにスケジュールしません。

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

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

• Partner Hubでは、特定の顧客の同期ステータス情報を表示できます。 さらに、前回の同期に関する詳細情報をCSVレコードにエクスポートできます。 CSVレコードはコントロールハブの表示よりも詳細で、トラブルシューティング、分析、監査に役立ちます。

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

• Broadworks専用の通話ユーザーとユーザー以外の通話事業者の場合、この機能はBroadWorksの次の電話番号タイプを同期します。

  • メインの電話番号

  • 携帯電話番号

  • 拡張

  ただし、同期では、主電話番号も内線番号も存在しない場合、Broadworksのみの発信ユーザーと非ユーザー通話エンティティは同期から除外されます。

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

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

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

• 組織の連絡先 — Webex はこれらの連絡先を組織と関連付けて保存します。 各ユーザーは、自分の組織の組織の連絡先にアクセスできます。 連絡先の最大数は30000です。

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

次の表は、Webexの連絡先タイプと連絡先ソース（BroadWorksの電話リストから同期されたか、手動で追加されたもの）を比較したものです。

Directory Syncが連絡先の最大数を処理する方法には、次の条件が適用されます。

• 組織が、同期で許可されている連絡先の最大数（グループあたり30000人の組織連絡先または30000のグループ共通連絡先）を超えると、ディレクトリ同期では最大しきい値を超えるエントリが除外されます。 同期された連絡先や除外された連絡先には特定の順序は適用されません。

• いずれかの顧客が、いずれかのカテゴリで許可されている連絡先の最大数を超えている場合は、シスコに問い合わせて、その組織をディレクトリ同期から除外してもらうことをお勧めします。

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

• 組織の連絡先（3万人）とグループの連絡先（グループあたり3万人）の合計制限は20万人です。

アップデート

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

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

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

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

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

• 更新がBroadWorksの電話リストのエントリに対するものであれば：

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

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

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

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

• レート制限値-以下のオーバーロードコントロールシステムプロパティ（XSP_CLI/Applications/XSI-Actions/オーバーロードコントロール）を設定します。

  • ユーザーディレクトリのトランザクション制限—null値に設定されています。

  • グローバルディレクトリのトランザクション制限 — NULL値に設定されています。

  ユーザーディレクトリのトランザクション制限とグローバルディレクトリのトランザクション制限はnull値に設定することをお勧めします。 ただし、値を割り当てる場合は、それぞれがTransactionLimitPeriodSecondsの値の少なくとも5倍に設定する必要があります（1でなければなりません）。

• トランザクション制限-次の値を設定します（XSP_CLI/システム/通信ユーティリティ/デフォルト設定）。

  • ユーザートランザクション制限 — 少なくとも100に設定してください。

  • トランザクション制限期間 (秒) — 1に設定します。

• ページング値—ページングシステムのプロパティを設定します（XSP_CLI/アプリケーション/XSI-Actions/ページング）：

  • デフォルトのページサイズ — 50に設定

  • 利用可能なユーザーの最大制限 — 100に設定

• CTIインターフェイス—WebexのCA証明書をCTIインターフェイスのトラストストアにアップロードし、CTIインターフェイスでクライアント認証を有効にしてください。

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

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

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

• R24の場合：パッチは必要ありません

パートナー管理者は、新しいテンプレートを作成するときに、顧客テンプレートのディレクトリ同期を有効にできます。 そのテンプレートに割り当てられた新しい顧客組織では、ディレクトリの同期が有効になります。 詳細については、Cisco BroadWorks 用 Webex ソリューションガイドの「パートナーハブでパートナー組織を設定する」の「オンボーディングテンプレートを設定する」を参照してください。

次にすべきこと

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

developer.webex.comには、パートナー管理者が管理する顧客組織のディレクトリ同期設定を更新したり、即時同期を開始したり、同期ステータス情報を取得したりできるパブリックAPIがあります。 ディレクトリの同期方法は、BroadWorks Enterprisesにグループ化されています。

• BroadWorks Enterprisesのリスト — このAPIメソッドを使用すると、特定のサービスプロバイダの企業のリストと各企業のIDを取得できます。 プロビジョニング時に割り当てられたSpEnterpriseIDを入力する必要があります。

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

• 企業向けのディレクトリ同期のトリガー — 特定の企業IDの即時同期をトリガーしたい場合は、このAPIメソッドを使用してください。 同期ステータスには、SYNC_NOWコマンドを入力してください。

• 企業のディレクトリ同期ステータスの取得-企業IDを入力して実行すると、最新の同期のステータスとトラッキングIDを取得できます。 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 仕様を読むにはサインインする必要があります。

次のエラーコードはディレクトリ同期に適用されます。

次の表は、この記事の更新をまとめたものです。