次の方法で共有

Microsoft Entra ID を使用した自動ユーザー プロビジョニング用に Genesys Cloud for Azure を構成する

この記事では、自動ユーザー プロビジョニングを構成するために Genesys Cloud for Azure と Microsoft Entra ID の両方で実行する必要がある手順について説明します。 構成すると、Microsoft Entra ID で、Microsoft Entra プロビジョニング サービスを使って、Genesys Cloud for Azure に対するユーザーとグループのプロビジョニングおよびプロビジョニング解除が自動的に行われます。 このサービスの機能、しくみ、よく寄せられる質問の重要な詳細については、「Microsoft Entra IDを使用して SaaS アプリケーションへのユーザー プロビジョニングとプロビジョニング解除を自動化する」を参照してください。

サポートされている機能

  • Genesys Cloud for Azure でユーザーを作成する
  • アクセスが不要になった場合に Genesys Cloud for Azure のユーザーを削除する
  • Microsoft Entra ID と Genesys Cloud for Azure の間でユーザー属性の同期を維持します。
  • Genesys Cloud for Azure でグループとグループ メンバーシップをプロビジョニングする
  • Genesys Cloud for Azure へのシングル サインオン (推奨)

[前提条件]

この記事で説明するシナリオでは、次の前提条件が既にあることを前提としています。

注

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

手順 1: プロビジョニングデプロイメントを計画する

  1. プロビジョニング サービスのしくみを確認します。
  2. プロビジョニングの対象範囲にいるユーザーを決定します。
  3. Microsoft Entra ID と Genesys Cloud for Azure の間でマップするデータを決定します。

手順 2: Microsoft Entra ID を使ったプロビジョニングをサポートするように Genesys Cloud for Azure を構成する

  1. PureCloud 組織内に構成される OAuth クライアントを作成します。
  2. OAuth クライアントを使用してトークンを生成します。
  3. PureCloud 内でグループ メンバーシップを自動的にプロビジョニングする場合は、Microsoft Entra ID のグループと同じ名前で PureCloud にグループを 作成 する必要があります。

Microsoft Entra アプリケーション ギャラリーから Genesys Cloud for Azure を追加して、Genesys Cloud for Azure へのプロビジョニングの管理を開始します。 Genesys Cloud for Azure への SSO を以前に設定している場合は、その同じアプリケーションを使用できます。 ただし、最初に統合をテストするときは、別のアプリを作成することをお勧めします。 ギャラリー からアプリケーションを追加する方法の詳細については、を参照してください。

手順 4: プロビジョニングのスコープに含まれるユーザーを定義する

Microsoft Entra プロビジョニング サービスを使用すると、アプリケーションへの割り当てに基づいて、またはユーザーまたはグループの属性に基づいてプロビジョニングされるユーザーをスコープできます。 割り当てに基づいてアプリにプロビジョニングされるユーザーのスコープを設定する場合は、 手順を使用してユーザーとグループをアプリケーションに割り当てることができます。 ユーザーまたはグループの属性のみに基づいてプロビジョニングする対象を決定する場合、スコープフィルターを使用できます。

  • 小規模から始めます。 すべてのユーザーとグループにロールアウトする前に、少数のユーザーとグループでテストします。 プロビジョニングのスコープが割り当てられたユーザーとグループに設定されている場合は、1 つまたは 2 つのユーザーまたはグループをアプリに割り当てることで、これを制御できます。 スコープがすべてのユーザーとグループに設定されている場合は、 属性ベースのスコープ フィルターを指定できます。

  • 追加のロールが必要な場合は、 アプリケーション マニフェストを更新 して新しいロールを追加できます。

手順 5: Genesys Cloud for Azure への自動ユーザー プロビジョニングを構成する

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

Microsoft Entra ID で Genesys Cloud for Azure の自動ユーザー プロビジョニングを構成するには、次のようにします。

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

  2. Entra ID>企業向けアプリケーションを参照する

    エンタープライズ アプリケーション ブレード

  3. アプリケーションの一覧で [Genesys Cloud for Azure] を選択します。

    アプリケーションの一覧の [Genesys Cloud for Azure] リンク

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

    [プロビジョニング] オプションが強調表示されている [管理] オプションのスクリーンショット。

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

    [自動] オプションが強調表示された [プロビジョニング モード] ドロップダウン リストのスクリーンショット。

  6. [管理者資格情報] セクションの [テナントの URL] と [シークレット トークン] のフィールドに、それぞれ Genesys Cloud for Azure API の URL と OAuth トークンを入力します。 API URL は、{{API Url}}/api/v2/scim/v2の PureCloud リージョンの API URL を使用して、として構成されます。 [ テスト接続] を選択して、Microsoft Entra ID が Genesys Cloud for Azure に接続できることを確認します。 接続できない場合は、この Genesys Cloud for Azure アカウントに管理者アクセス許可があることを確認してから、もう一度試します。

    スクリーンショットには、[管理者資格情報] ダイアログ ボックスが表示され、テナント U R L とシークレット トークンを入力できます。

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

    通知メール

  8. 保存 を選択します。

  9. [マッピング] セクションで、[Synchronize Microsoft Entra users to Genesys Cloud for Azure] (Microsoft Entra ユーザーを Genesys Cloud for Azure に同期する) を選びます。

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

    特性 タイプ フィルター処理でサポートされます Genesys Cloud for Azure で必要
    ユーザー名 糸 ✓ ✓
    活動中 ボーリアン ✓
    ディスプレイ名 糸 ✓
    emails[type eq "仕事"].value 糸
    タイトル 糸
    電話番号[タイプ eq "携帯"].値 糸
    phoneNumbers[タイプが "職場" の場合].値 糸
    phoneNumbers[type eq "work2"].value 糸
    phoneNumbers[type eq "work3"].value 糸
    フォンナンバー[タイプは "work4" に等しい].値 糸
    電話番号[タイプ eq "home"].値 糸
    phoneNumbers[type eq "microsoftteams"].value 糸
    役割 糸
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:部門 糸
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:ユーザー:マネージャー リファレンス
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:従業員番号 (employeeNumber) 糸
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division 糸
    urn:ietf:params:scim:schemas:extension:genesys:purecloud:2.0:User:externalIds[authority eq 'microsoftteams'].value 糸
    urn:ietf:params:scim:schemas:extension:genesys:purecloud:2.0:User:externalIds[authority eq 'ringcentral'].value 糸
    urn:ietf:params:scim:schemas:extension:genesys:purecloud:2.0:User:externalIds[authority eq 'zoomphone].value 糸

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

  12. [属性マッピング] セクションで、Microsoft Entra ID から Genesys Cloud for Azure に同期されるグループ属性を確認します。 "照合" プロパティとして選択されている属性は、更新処理で Genesys Cloud for Azure のグループとの照合に使用されます。 [保存] ボタンをクリックして変更をコミットします。 Genesys Cloud for Azure では、グループの作成や削除はサポートされておらず、グループの更新のみがサポートされています。

    特性 タイプ フィルター処理でサポートされます Genesys Cloud for Azure で必要
    ディスプレイ名 糸 ✓ ✓
    エクスターナルID 糸
    メンバー リファレンス

  13. スコープ フィルターを構成するには、スコープ フィルターに関する記事に記載されている次の手順 を参照してください。

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

    プロビジョニング状態をオンに切り替えました

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

    プロビジョニングスコープ

  16. プロビジョニングの準備ができたら、 [保存] を選択します。

    プロビジョニング構成の保存

この操作により、[設定] セクションの [スコープ] で定義されているすべてのユーザーとグループの初期同期サイクルが開始されます。 最初のサイクルは、Microsoft Entra プロビジョニング サービスが実行されている限り、約 40 分ごとに発生する後続のサイクルよりも実行に時間がかかります。

手順 6: デプロイを監視する

プロビジョニングを構成したら、次のリソースを使用してデプロイを監視します。

  1. プロビジョニング ログを使用して、どのユーザーが正常にプロビジョニングされたか、または正常にプロビジョニングされなかったかを判断する
  2. 進行状況バーを確認して、プロビジョニング サイクルの状態と完了までの近さを確認します
  3. プロビジョニング構成が異常な状態にあると思われる場合、アプリケーションは検疫に入ります。 検疫状態についての詳細は、アプリケーションプロビジョニングの隔離状態に関する記事をご覧ください。

変更ログ

  • 09/10/2020 - エンタープライズ属性 employeeNumber のサポートが追加されました。
  • 05/18/2021 - コア属性 phoneNumbers[type eq "work2"] 、phoneNumbers[type eq "work3"] 、phoneNumbers[type eq "work4"] 、phoneNumbers[type eq "home"] 、phoneNumbers[type eq "microsoftteams"] およびロールのサポートが追加されました。 また、カスタム拡張属性 urn:ietf:params:scim:schemas:extension:genesys:purecloud:2.0:User:externalIds[authority eq ‘microsoftteams’] 、urn:ietf:params:scim:schemas:extension:genesys:purecloud:2.0:User:externalIds[authority eq ‘zoomphone] 、urn:ietf:params:scim:schemas:extension:genesys:purecloud:2.0:User:externalIds[authority eq ‘ringcentral’] のサポートが追加されました。

その他のリソース

関連コンテンツ