この記事の内容
概要
前提条件

ユニティコネクションのWebex クラウド接続 UC ディレクトリサービスのサポート

list-menuこの記事の内容
list-menuフィードバックがある場合

コントロールハブのインターフェイスを使用して、Webex Common Identity サービスを介して、クラウドディレクトリ(Entra ID)のユーザーを Unity Connection クラスタに同期します。

概要

Webex クラウド接続UCディレクトリサービスを使用して、クラウドActive Directory(Microsoft Entra IDなど)から、(ユニファイドコミュニケーションマネージャー)やCisco Unified Communications Manager(ユニファイドコミュニケーションマネージャー)やCisco Unity Connection(Unity Connection)などのオンプレミスまたはクラウドでホストされているUCインフラストラクチャにユーザーを同期して管理できます。 同期中に、システムは、Webex Common Identity サービスに同期されているEntra ID(または同様のクラウドディレクトリサービス)からユーザーのリストと関連するユーザーデータをインポートします。 同期が必要なUnity Connectionクラスタをコントロールハブから選択し、適切なUnity ConnectionユーザーIDフィールドマッピングを選択してから、同期を実行するために必要な同期アグリーメントを選択する必要があります。

クラウドから Unity Connection へのユーザーの同期と管理を可能にするには、Webex Cloud-Connected UC の各クラスターでディレクトリサービスを有効にする必要があります。

デフォルトでは、ディレクトリサービスはすべてのオンボードクラスターで有効になっていません。
1

Control Hubのカスタマービューから、サービス > コネクテッドUCに移動します。 UC管理カードで、インベントリをクリックします。

クラスターグループのリストが、説明、ステータス、クラスター、 ノードとともに表示されます。

2

ノードが属するクラスターグループの横にある「詳細」をクリックします。

インベントリページが表示され、 選択したクラスターグループに属するクラスターのリストが表示されます。

3

特定の製品ノードが属するクラスターの横にある「詳細」をクリックします。

ノード名とバージョン、製品、ステータスが表示されます。

4

イベント履歴の横にある省略記号アイコンをクリックして、サービス管理を選択します 。

サービス管理ページが開き、サービスのリストが表示されます。

5

トグルボタンを使ってディレクトリサービスを有効にしてください。

6

[送信] をクリックします。

ディレクトリサービス

ディレクトリサービス

ディレクトリサービスカードを使用して、クラウドベースのディレクトリのユーザーをUnity Connectionに同期します。

1

Control Hubのカスタマービューから、サービス > コネクテッドUCに移動します。

2

ディレクトリサービスカードで、「クラスターを表示」をクリックします。 ディレクトリサービスのページが表示されます。

このページでクラスターの詳細のリストを見ることができます。

クラスターの詳細を表示する

クラスターの詳細を表示する

ディレクトリサービスのクラスター選択ページから、ユーザーデータを同期したいクラスターを選択します。

クラスターの選択ページには、クラスターの詳細、プロビジョニングのステータス、最終同期状態、関連製品、障害の理由(ある場合)も表示されます。 ローカルタイムゾーンを選択できます。デフォルトでは、ブラウザのタイムゾーンが選択されています。

クラスターの詳細

説明

クラスター名

クラスターの名前。

ステータス

同期のステータス。

最終同期

最後の同期の日付。

製品

製品の詳細。

Webex クラウド接続 UC ディレクトリサービスの同期により、エンドユーザーデータを Webex Common Identity サービスから Unity Connection データベースにインポートして、エンドユーザー設定ウィンドウに表示できます。

予定されている Webex CloudConnected UC モジュールのアップグレード中は、プロビジョニング操作を行わないようにしてください。

モジュールのアップグレード中にプロビジョニングを実行すると、手順1、2、または3でエラー状態が表示され、しばらくすると再試行ボタンが表示されることがあります。 「再試行」ボタンを選択すると、プロビジョニングを再開できます。 プロビジョニングを再試行する前に、アップグレードが完了するまでクラスターのステータスを確認してください。

1

Directory Serviceのクラスター選択ページから、同期を有効にするためにプロビジョニングするクラスターを選択します。

2

「プロビジョニングを開始」をクリックします。

3

プロビジョニングを開始したら、フィールドマッピング設定ウィンドウで、Unity Connection User IDフィールドに選択したマッピングがクラスタ内のユーザーを一意に識別することを確認してください。

4

Webex からユーザーを同期するための適切な Unity Connection ユーザー ID フィールドマッピングを選択してください。

  • ユニティコネクションのユーザーIDフィールドは、Webexのユーザーの電子メール IDにマップされます。

  • ユニティコネクションのメールIDフィールドは、WebexのユーザーのメールIDにマップされます。

  • Unity ConnectionのユーザーIDフィールドは、Webexのユーザーのドメイン部分のない電子メール IDにマップされます。

    Unity Connectionの既存のユーザーアカウントのマッピングが正常に行われない場合は、新しいユーザーアカウントが作成されます。 ユーザーのメールID(またはメールIDのID部分)は、新しく作成されたユーザーアカウントの一意の識別子として使用されます。
5

「次へ」をクリックします。

6

新しい同期契約を作成するには、ドロップダウンリストから契約を選択してください。

新しい同期アグリーメントが作成されると、オンプレミスディレクトリを指す既存の同期アグリーメントはすべて削除されます。 新しい同期契約は、作成後に変更できます。

7

同期を開始する前に、契約のプレビューセクションで、契約の詳細(Unity Connectionで利用できる既存の外部LDAPディレクトリの詳細)を確認してください。

次の詳細を表示できます。

  • グループ情報

  • ユニバーサル回線とデバイステンプレートを含む応用機能グループテンプレート

  • 挿入したユーザーの同期された電話番号への回線とマスクの詳細

  • 新しくプロビジョニングされたユーザーとその拡張機能

  • 同期する標準ユーザーフィールドセクション。 次のユーザーフィールドは、Webex 共通アイデンティティサービスから Unity Connection に同期されます。

    ユニティコネクションのユーザーフィールドが同期されましたWebex 共通 ID サービスのユーザーフィールドが同期されました

    ユーザーIDです

    「Unity ConnectionのユーザーIDフィールドがWebexのユーザーの電子メール IDにマップされる」オプションが選択されている場合、ユーザー名は同期されます。

    「ユニティコネクションのメールIDフィールドがWebexのユーザーの電子メール IDにマップされる」オプションを選択した場合に、Webex Common Identity ServiceのメールIDと一致するUnity Connectionデータベースの既存のユーザーID(ユニティコネクションのメールID)。

    「Unity ConnectionのユーザーIDフィールドがWebexのユーザーのドメイン部分のないメールIDにマップされる」オプションが選択されている場合は、ドメイン部分のないメールID。

    ファーストネーム

    名前。指定された名前

    苗字

    名前。苗字

    表示名

    表示名

    電話番号

    電話番号。仕事

    携帯電話番号

    電話番号。モバイル

    メールID

    メールします

    タイトル

    タイトル

  • ディレクトリサーバーのホスト名またはIPアドレス

[次へ] をクリックして、グループフィルターを選択します。

8

「グループを選択」ドロップダウンリストから、同期したい特定のグループを選択します。 すべてのユーザーグループを選択したい場合は、「すべてのグループを選択する」チェックボックスをクリックしてください。

デフォルトでは、すべてのユーザーが同期されます。 グループを選択しないと、すべてのユーザーと関連するユーザーデータが自動的に同期されます。

ディレクトリ内のネストされたグループの場合、デフォルトでは親グループに含まれていないため、ユーザーはプロビジョニング時にサブセットのユーザーグループを選択する必要があります。 プロビジョニング中に必要なユーザーだけが含まれるようにするために、ネストが繰り返されていないか(ある場合)を確認する必要があります。

同期契約への変更(ターゲットのユーザーやグループの削除など)は、定期的な同期中には反映されません。 Control Hubからそのクラスターのディレクトリサービスを無効にしてから、新しい同期アグリーメントまたは変更した同期アグリーメントを使用してクラスターを再プロビジョニングする必要があります。

9

[次へ] をクリックして、同期プロセスを準備します。

10

「同期を有効にする」ウィンドウで、システムがユーザーデータをUnity Connectionの一時ストレージスペースに正常にコピーし、新しい同期アグリーメントが作成されたら、同期を有効にします(下のスクリーンショットの手順1と2の後)。

11

レポートをダウンロードするオプションでは、結果を部分的に表示できます。 ユニティ・コネクション・クラスタの完全なレポートを取得するには、次のCLIコマンドを実行します。file get activelog /cm/trace/CIService/log4j/DryRunResults.csv。 ここで、ユニティ・コネクションのドライラン結果は次のようになっています。

フレッシュエントラIDの導入の場合:

  • 新規ユーザ:ユーザは Unity Connection Cisco Unified CM サーバのデータベースには存在しませんが、Webex アイデンティティサービスには存在します。

  • 一致したユーザ:ユーザは Unity Connection Cisco Unified CM サーバのデータベースと Webex アイデンティティサービスにあります。

  • CUC 一致ユーザ — Webex アイデンティティサービスに存在し、ユニティ接続ノードの「ユニティ接続データベース」にインポートされたユーザ。

  • ユーザーの不一致:ユーザーは Unity Connection Cisco Unified CM サーバのデータベースには存在しますが、Webex ID サービスには存在しません。

オンプレミスADからエントラIDへの移行の場合:

CCUCのディレクトリ同期設定は移行されません。 移行後、 移行先のリージョンでCCUCディレクトリ同期をプロビジョニングする必要があります。

  1. ユニティコネクションのユーザーIDフィールドは、Webexのユーザーの電子メール IDにマップされます。 ドライランレポートのフィールドはすべて、Fresh Entra IDデプロイメントと同じです。

  2. ユニティコネクションのメールIDフィールドは、WebexのユーザーのメールIDにマップされます。 ドライランレポートのフィールドはすべて、Fresh Entra IDデプロイメントと同じです。

  3. Unity ConnectionのユーザーIDフィールドは、Webexのユーザーのドメイン部分のない電子メール IDにマップされます。

    • 新規ユーザー:ドメイン部分のないユーザーIDを持つユーザーは、Unity Cisco Unified CM Connectionサーバーのデータベースには存在しませんが、Webex Identity Serviceには存在します。

    • 一致したユーザ:ドメイン部分のないユーザ ID を持つユーザは、Unity Connection Cisco Unified CM サーバのデータベースと Webex ID サービスにあります。

    • CUC Matched Users —ドメイン部分のないユーザーIDを持つユーザーは、Webex IDサービスに存在し、ユニティコネクションノードの「Unity Connection データベース」にインポートされます。

    • ユーザーの不一致:ドメイン部分のないユーザーIDを持つユーザーは、Unity Cisco Unified CM Connectionサーバーのデータベースには存在しますが、Webex Identity Serviceには存在しません。

レポートを確認して、同じユーザーリストを維持するか、ユーザーを追加または削除するかを決めることができます。 決定に基づいて、プロセスを停止してプロビジョニングの変更を元に戻すことができます。
ディレクトリ同期後にクラウドディレクトリ内のユーザーデータに加えられた更新は、次の同期期間に更新されます。 これは、クラウドディレクトリが1日に1回定期的に同期されるためです。
12

同期合意の確認が終わったら、「Unity Connection でプレビュー」をクリックしてオンプレミスのインフラストラクチャにサインインし、新しく作成した同期契約を変更します。

VPNアクセスが必要です。
13

同期契約がUnity Connectionで確認および検証されるという条件に同意するには、チェックボックスをオンにしてください。

14

同期を続行するには、「同期を有効にする」をクリックしてください。

同期中は、完了するまでアクションを実行できません。 特定のクラスターの同期が完了すると、ディレクトリサービスのページには、そのクラスターが「プロビジョニング済み」状態で表示されます。 この時点で、Entra IDがWebexユーザーをプロビジョニングしてUCインフラストラクチャに同期することを正常に承認し、同期の設定手順を完了しました。

15

初期プロビジョニングが完了すると、24時間ごとに定期的な同期が行われます。 クラウドディレクトリに加えられた変更は、この期間中にクラスターに反映されます。

新しい契約が作成されてから20時間以内に同期を有効にする必要があります。 LDAPで同期されたユーザーは、24時間使用しないと非アクティブになり、削除されます。 ユーザーはログインして Unity Connection サービスを使用することはできません。

特定のクラスタのEntra IDのプロビジョニングが完了すると、新しい同期アグリーメントを作成したり、グループ設定以外の同じクラスタの構成設定を変更したりすることはできません。 同じクラスターに新しい同期アグリーメントを作成する場合は、サービス管理ページに移動して、ディレクトリサービスを無効にする必要があります。 その後、プロビジョニング用の新しい契約を作成できます。

何らかの理由で同期が失敗した場合は、最新のプロビジョニング変更が翌日の次の同期期間に反映されます。

  • プロビジョニングが成功した後、SSO認証中にEntra ID IdPを使用する場合は、Entra ID IdPで正しいクレームを設定してください。 たとえば、プロビジョニング中にユーザーIDマッピングにオプション1を選択した場合は、user.userprincipalnameが「その他の要求」セクションのUIDとして設定されていることを確認してください。

  • 次の属性は、Webex 共通アイデンティティサービスからユニティコネクションに同期されます。

    ユニティコネクションのユーザーフィールドが同期されましたWebex 共通 ID サービスのユーザーフィールドが同期されました

    ユーザーIDです

    「Unity ConnectionのユーザーIDフィールドがWebexのユーザーの電子メール IDにマップされる」オプションが選択されている場合、ユーザー名は同期されます。

    「ユニティコネクションのメールIDフィールドがWebexのユーザーの電子メール IDにマップされる」オプションを選択した場合に、Webex Common Identity ServiceのメールIDと一致するUnity Connectionデータベースの既存のユーザーID(ユニティコネクションのメールID)。

    「Unity ConnectionのユーザーIDフィールドがWebexのユーザーのドメイン部分のないメールIDにマップされる」オプションが選択されている場合は、ドメイン部分のないメールID。

    ファーストネーム

    名前。指定された名前

    苗字

    名前。苗字

    表示名

    表示名

    電話番号

    電話番号。仕事

    携帯電話番号

    電話番号。モバイル

    メールID

    メールします

    タイトル

    タイトル

  • ディレクトリ同期後にクラウドディレクトリ内のユーザーデータに加えられた更新は、次の同期期間に更新されます。 これは、クラウドディレクトリが1日に1回定期的に同期されるためです。

  • ログインにはシングルサインオン(SSO)を使用する必要があります。 このドキュメントでは、シングルサインオン(SSO)統合のみを取り上げています。

  • 再プロビジョニング後に、不一致ユーザーとしてマークされたユーザーが新規ユーザー(同じメールIDを共有しているユーザー)と同じであることがわかった場合は、同期の変更が反映されるまで最大48時間待つことをお勧めします。

    1. Control Hubのサービス管理ページからディレクトリサービスを無効にしてください。

    2. LDAPシステムの「LDAPサーバーからの同期を有効にする」チェックボックスを無効にしてください。

    3. Control Hubのサービス管理ページからディレクトリサービスを有効にします。

プロビジョニングステータス

プロビジョニングステータス

ディレクトリサービスのダッシュボードでは、クラスターの状態を表示および追跡したり、エラーを確認したりできます。

次の表は、提供状況、説明、および対応するアクションを示しています。

テーブル 1.プロビジョニングステータス

プロビジョニングステータス

説明

処理中

プロビジョニングは進行中です。

アクションが必要です

特定のクラスターに手動による介入が必要な場合は、必要な措置を講じてください。 例えば、

  • ドライラン後に同期を続けたり中止したりする場合。

  • 新しい契約が作成されたら、通知を確認して、必要に応じて必要な措置を講じてください。

エラー

「同期を有効にする」ウィザードで必要なアクションがある場合は、それらを確認し、必要に応じて必要なアクションを実行してください。

プロビジョニングのどの段階でもエラーが発生した場合、管理者はDirectory Serviceというサービスのイベント履歴ページを監査する必要があります。Cisco Webex Control Hub これは、発生する可能性のある問題を切り分け、デバッグし、トラブルシューティングするのに役立ちます。 イベントにアクセスするには、「ハイブリッドサービスのイベント履歴へのアクセス」を参照してください。

さまざまなイベントの種類とその詳細については、下の「イベントと解決方法」の表を参照してください。

プロビジョニング済みです

クラスターのプロビジョニングが完了しました。

プロビジョニングされていません

クラスターのプロビジョニングはまだ開始されていません。

テーブル 2.イベントと決議

イベント

アクションが必要です

定期同期が失敗しました

必ず翌日の定期同期が完了するまでお待ちください。 同期が正常に完了したことを確認してください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

データコピー失敗

データ転送を続けるには、[再試行] ボタンをクリックしてください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

同期契約の失敗

同期契約の作成をやり直すには、[再試行] ボタンをクリックしてください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

定期同期をスキップします

アクションは必要ありません。

データ転送が失敗しました

データ転送を続けるには、[再試行] ボタンをクリックしてください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

ユーザー同期が一致しません

Unity Connectionのディレクトリ同期ログでユーザー同期のエラーを確認するか、Cisco TACサポートに連絡してさらにサポートを受けてください。

ユーザーは正常にプロビジョニングされました

アクションは必要ありません。

定期同期データ転送が成功しました

アクションは必要ありません。

Webex Common Identity から選択したグループの一部のユーザー詳細を取得できませんでした。

ダッシュボードに移動してクラスターを選択し、表示されたダウンロードリンクをクリックして失敗したグループの詳細を取得します。 ユーザーが Webex Common Identity に存在するかどうかを確認し、[再試行] をクリックします。 Cisco TACさらにサポートが必要な場合は、サポートに連絡してください。

Webex Common Identity から選択したすべてのグループのユーザー詳細を取得できませんでした。

データ転送を続けるには、[再試行] ボタンをクリックしてください。 問題が解決しない場合は、Cisco TACサポートに連絡して支援を求めてください。

Control Cisco Unity Connection Hubからクラスターのプロビジョニングを行った後、「ユーザーのインポート」からEntra IDユーザーを手動でインポートできます。

ユーザーをインポートする2つの方法は次のとおりです。

1

「Cisco Unity Connection管理」で、「ユーザー」を展開して「ユーザーをインポート」を選択します。

2

「ユーザーのインポート」ページで、Entra IDのユーザーアカウントをインポートして、Unity Connectionユーザーを作成します。

  1. 「エンドユーザーの検索」フィールドで「LDAPディレクトリ」を選択します。

  2. 新しいユーザーのベースとなるテンプレートを選択してください。

  3. インポートしたいEntra IDユーザーアカウントのエイリアス、名、苗字を指定してください。

  4. インポートしたいユーザーアカウントのチェックボックスをチェックして、「選択したものをインポート」を選択します。

1

「Cisco Unity Connection管理」で、「ツール」を展開して「一括管理ツール」を選択します。

2

Unity Connection ユーザーを追加するには、一括管理ツールページで次の手順を実行してください。

  1. 「操作の選択」から、「エクスポート」を選択します。

  2. 「オブジェクトタイプの選択」から、LDAPディレクトリのユーザーを選択します。

  3. すべての必須フィールドに値を入力してください。

  4. [送信] を選択します。

    これにより、Entra IDのユーザーデータを含むCSVファイルが作成されます。 CSVファイルをスプレッドシートアプリケーションまたはテキストエディターで開き、必要に応じてデータを編集します。 次に、CSVファイルからデータをインポートします。

  5. 「操作の選択」から、「作成」を選択します。

  6. 「オブジェクトタイプの選択」から、「メールボックスを持つユーザー」を選択します。

  7. すべての必須フィールドに値を入力してください。

  8. [送信] を選択します。

3

インポートが完了したら、「Failed Objects Filename」フィールドで指定したファイルを見て、すべてのユーザーが正常に作成されていることを確認します。

このセクションでは、Control Hub から Unity Connection データベースにユーザーを同期するさまざまな段階で発生する可能性のある一般的な問題を解決するために必要な情報と解決策を提供します。

ユーザーが一致しません

ユーザーが一致しない場合は、新しい契約が作成されてから20時間以内に同期を有効にしてください。 既存のユーザーは非アクティブとマークされ、Unified CM 24時間使用しないと削除されます。

エラー-データのコピーが失敗しました。 もう一度試してください

  • クラウドに接続されたUCとWebexクラウドの間の通信が中断されたか、Webexクラウドからユーザーデータを取得できません。

    解決策:正常に接続されているかどうかを確認するにはCisco Cloud、https://status.webex.com/ でこれらのサービスのステータスを確認してください。 「再試行」をクリックします。

  • クラウドに接続されたUCとUnity Connectionの間の通信が中断されたか、ユーザーデータをUnity Connectionデータベースにプッシュできません。

    解決策:クラウド接続UCとUnity Connectionの間のネットワーク接続を確認し、[再試行] をクリックしてください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

エラー-同期契約を作成できませんでした。 もう一度試してください

  • クラウド接続されたUCとUnity Connectionの間の通信が中断されたか、同期合意データをUnity Connectionデータベースにプッシュできません。

    解決策:クラウド接続UCとUnity Connectionの間のネットワーク接続を確認し、[再試行] をクリックしてください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

  • 同期契約は正常に作成されませんでした。

エラー-ディレクトリ同期を有効にできませんでした。 もう一度試してください

  • クラウドに接続されたUCとユニティコネクションの間の通信が中断され、Cisco DirSyncサービスは起動されません。

    解決策:クラウド接続UCとUnity Connectionの間のネットワーク接続を確認し、[再試行] をクリックしてください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

同期契約の詳細を取得できません。 しばらくしてから試してください。

クラウドに接続されたUCとユニティコネクションの間の通信が中断されます。

解決策:クラウド接続UCとUnity Connectionの間のネットワーク接続を確認し、[再試行] をクリックしてください。 問題が解決しない場合は、サポートに連絡してくださいCisco TAC。

選択したグループのユーザーデータを取得できませんでした

初めてのプロビジョニング時に、同期対象として選択した特定のグループからユーザーデータをダウンロードする際に問題が発生することがあります。 エラーメッセージのダウンロードリンクをクリックすると、失敗したグループ情報の詳細が表示されます。

また、の「イベント履歴」ページから、すでにプロビジョニングされているクラスターの障害グループ情報をダウンロードすることもできます。Cisco Webex Control Hub ダッシュボードに移動してクラスターを選択し、表示されたダウンロードリンクをクリックして失敗したグループの詳細を取得します。 ユーザーが Webex Common Identity に存在するかどうかを確認し、[再試行] をクリックします。 Cisco TACさらにサポートが必要な場合は、サポートに連絡してください。

ユニティ・コネクションの既知の問題と制限事項

ユニティ・コネクションの既知の問題と制限事項

この機能で問題が発生した場合は、それがすでにわかっていることであり、推奨される回避策があるかどうかを確認してください。

  • Control Hubからクラスターのディレクトリサービスを無効にしてから、クラスターを再度有効にすることができます。 同期のためにディレクトリサービスを有効にする前に、少なくとも60秒待つことをお勧めします。

  • 削除後、同じ Unity Connection クラスタを組織に再びオンボーディングする場合は、まずディレクトリサービスを無効にしてから、同じクラスタを再プロビジョニングする必要があります。

  • プロビジョニング中、Webex Common Identity Serviceとの同期の問題により、グループの詳細リストが入力されません。 ユーザーは、プロビジョニングを中止して、しばらくしてから再試行することをお勧めします。

この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?