チュートリアル:自動的にユーザーをプロビジョニングするための Cisco Webex の構成

  • [アーティクル]

このチュートリアルの目的は、Cisco Webex に対するユーザーまたはグループのプロビジョニングまたはプロビジョニング解除を自動的に実行するように Microsoft Entra ID を構成するために、Cisco Webex と Microsoft Entra ID で実行される手順を示すことです。

Note

このチュートリアルでは、Microsoft Entra ユーザー プロビジョニング サービスの上に構築されるコネクタについて説明します。 このサービスが実行する内容、しくみ、よく寄せられる質問の重要な詳細については、「Microsoft Entra ID による SaaS アプリへのユーザー プロビジョニングとプロビジョニング解除の自動化」を参照してください。

このコネクタは、現在プレビューの段階です。 プレビューの詳細については、オンライン サービスのユニバーサル ライセンス条項に関するページを参照してください。

前提条件

このチュートリアルで説明するシナリオでは、次の前提条件目があることを前提としています。

  • Microsoft Entra テナント。
  • Cisco Webex テナント。
  • Admin アクセス許可がある Cisco Webex のユーザー アカウント。

Note

この統合は、Microsoft Entra 米国政府クラウド環境から利用することもできます。 このアプリケーションは、Microsoft Entra 米国政府クラウドのアプリケーション ギャラリーにあり、パブリック クラウドの場合と同じように構成できます。

Microsoft Entra ID で自動ユーザー プロビジョニング用に Cisco Webex を構成する前に、Cisco Webex を Microsoft Entra アプリケーション ギャラリーから管理対象の SaaS アプリケーションのリストに追加する必要があります。

Microsoft Entra アプリケーション ギャラリーから Cisco Webex を追加するには、以下の手順を行います。

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。

  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[新しいアプリケーション] を参照します。

  3. [ギャラリーから追加する] セクションに「Cisco Webex」と入力し、結果パネルの [Cisco Webex] を選んでから、[追加] ボタンをクリックしてアプリケーションを追加します。

    Screenshot shows the Cisco Webex in the results list.

Cisco Webex へのユーザーの割り当て

Microsoft Entra ID では、選択されたアプリへのアクセスを付与するユーザーを決定する際に "割り当て" という概念が使用されます。 自動ユーザー プロビジョニングのコンテキストでは、Microsoft Entra ID 内のアプリケーションに "割り当て済み" のユーザーやグループのみが同期されます。

自動ユーザー プロビジョニングを構成して有効にする前に、Cisco Webex へのアクセスが必要な Microsoft Entra ID のユーザーを決定しておく必要があります。 決定し終えたら、次の手順でこれらのユーザーを Cisco Webex に割り当てることができます。

ユーザーを Cisco Webex に割り当てる際の重要なヒント

  • 1 人の Microsoft Entra ユーザーを Cisco Webex に割り当て、自動ユーザー プロビジョニングの構成をテストすることをお勧めします。 後で追加のユーザーを割り当てられます。

  • Cisco Webex にユーザーを割り当てるときは、有効なアプリケーション固有ロール (使用可能な場合) を割り当てダイアログで選択する必要があります。 既定のアクセス ロールのユーザーは、プロビジョニングから除外されます。

Cisco Webex への自動ユーザー プロビジョニングの構成

このセクションでは、Microsoft Entra プロビジョニング サービスが、Microsoft Entra ID でのユーザー割り当てに基づいて、Cisco Webex でのユーザーの作成、更新、無効化を行うように構成する手順について説明します。

Microsoft Entra ID で Cisco Webex の自動ユーザー プロビジョニングを構成するには:

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。

  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[Cisco Webex] を参照します。

    Screenshot shows the Enterprise applications blade.

  3. アプリケーションの一覧で [Cisco Webex] を選択します。

    Screenshot shows the Cisco Webex link in the Applications list.

  4. [プロビジョニング] タブを選択します。

    Screenshot of a menu. Under Manage, Provisioning is highlighted.

  5. [プロビジョニング モード] を [自動] に設定します。

    Screenshot of the Provisioning mode list box, with Automatic highlighted.

  6. [管理者資格情報] セクションで、Cisco Webex のアカウントの [テナントの URL] と [シークレット トークン] を入力します。

    Screenshot of the Admin Credentials section. The Tenant U R L and Secret token boxes are highlighted but are empty.

  7. [テナントの URL] フィールドに https://api.ciscospark.com/v1/scim/[OrgId] という形式で値を入力します。 [OrgId] を取得するには、Cisco Webex Control Hub にサインインします。 左下にある組織名をクリックし、 [組織 ID] の値をコピーします。

    • [シークレット トークン] の値を取得するには、この [URL] に移動します。 表示される webex サインイン ページから、組織の完全な Cisco Webex 管理者アカウントでサインインします。 サイトに到達できないというエラー ページが表示されますが、これは正常です。

      Screenshot of a webpage displaying an error message. The message says that the site cannot be reached and includes a few troubleshooting tips.

    • 次に示すように、生成されたベアラー トークンの値を URL からコピーします。 このトークンは 365 日間有効です。

      Screenshot showing a long U R L. Part of the address is indecipherable but is highlighted and labeled Bearer token.

  8. 手順 5 の各フィールドに値を入力したら、[テスト接続] をクリックして、Microsoft Entra ID が Cisco Webex に接続できることを確認します。 接続できない場合は、使用中の Cisco Webex アカウントに管理者アクセス許可があることを確認してから、もう一度試します。

    Screenshot shows the Tenant URL and Token.

  9. [通知用メール] フィールドに、プロビジョニングのエラー通知を受け取るユーザーまたはグループの電子メール アドレスを入力して、 [エラーが発生したときにメール通知を送信します] チェック ボックスをオンにします。

    Screenshot shows the Notification Email.

  10. [保存] をクリックします。

  11. [マッピング] セクションで、[Microsoft Entra ユーザーを Cisco Webex に同期する] を選択します。

  12. [属性マッピング] セクションで、Microsoft Entra ID から Cisco Webex に同期されるユーザー属性を確認します。 [Matching](照合) プロパティとして選択されている属性は、更新処理で Cisco Webex のユーザー アカウントとの照合に使用されます。 照合対象の属性を変更する場合、その属性に基づいたユーザーのフィルター処理を Cisco Webex API がサポートしているか確認する必要があります。 [保存] ボタンをクリックして変更をコミットします。

    属性 Type フィルター処理のサポート Cisco Webex で必須
    userName String ✓ ✓
    name.givenName String
    name.familyName String
    active Boolean
    displayName String
    externalId String

  13. [マッピング] セクションで、[Synchronize Microsoft Entra groups to Cisco Webex] (Microsoft Entra グループを Cisco Webex に同期する) を選びます。

  14. [属性マッピング] セクションで、Microsoft Entra ID から Cisco Webex に同期されるグループ属性を確認します。 [照合] プロパティとして選択されている属性は、更新処理で Cisco Webex のグループとの照合に使われます。 [保存] ボタンをクリックして変更をコミットします。

    属性 Type フィルター処理のサポート Cisco Webex で必須
    displayName String ✓ ✓
    members リファレンス
    externalId String

  15. スコープ フィルターを構成するには、スコープ フィルターのチュートリアルの次の手順を参照してください。

  16. Cisco Webex に対して Microsoft Entra プロビジョニング サービスを有効にするには、[設定] セクションで [プロビジョニングの状態] を [オン] に変更します。

    Screenshot shows the Provisioning Status Toggled On.

  17. [設定] セクションの [スコープ] で目的の値を選択して、Cisco Webex にプロビジョニングするユーザーやグループを定義します。

    Screenshot shows the Provisioning Scope.

  18. プロビジョニングの準備ができたら、 [保存] をクリックします。

    Screenshot shows to Save Provisioning Configuration.

これにより、 [設定] セクションの [スコープ] で 定義したユーザーやグループの初期同期が開始されます。 初期同期は、Microsoft Entra のプロビジョニング サービスが実行されている限り約 40 分ごとに実行される後続の同期よりも実行に時間がかかります。 [同期の詳細] セクションを使用すると、進行状況を監視できるほか、リンクをクリックしてプロビジョニング アクティビティ レポートを取得できます。このレポートには、Microsoft Entra プロビジョニング サービスによって Cisco Webex に対して実行されたすべてのアクションが記載されています。

Microsoft Entra プロビジョニング ログの読み方について詳しくは、「自動ユーザー アカウント プロビジョニングについてのレポート」をご覧ください。

コネクタの制限事項

  • 現在、Cisco Webex は Cisco において初期フィールド テスト (EFT) が行われています。 詳しくは、Cisco サポート チームにお問い合わせください。
  • Cisco Webex の構成の詳細については、Cisco のドキュメントのこちらを参照してください。

ログの変更

  • 2023 年 2 月 7 日 - グループ プロビジョニングのサポートを追加しました。

その他のリソース

次のステップ