チュートリアル:Peakon を構成し、自動ユーザー プロビジョニングに対応させる

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

Note

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

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

前提条件

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

  • Microsoft Entra テナント。
  • Peakon テナント
  • 管理者アクセス許可がある Peakon のユーザー アカウント。

Note

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

Peakon にユーザーを割り当てる

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

自動ユーザー プロビジョニングを構成して有効にする前に、Peakon へのアクセスが必要な Microsoft Entra ID のユーザーやグループを決定しておく必要があります。 特定した後、次の手順に従い、これらのユーザー、グループ、またはその両方を Peakon に割り当てることができます。

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

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

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

プロビジョニングのために Peakon を設定する

  1. Peakon 管理コンソールにサインインします。 [Configuration](構成) をクリックします。

    Peakon Admin Console

  2. 統合 を選択します。

    Screenshot of the Configuration options with the Integrations option called out.

  3. [Employee Provisioning](従業員のプロビジョニング) を有効にします。

    Screenshot of the Employee Provisioning section with the Enable option called out.

  4. [SCIM 2.0 URL] および [OAuth Bearer Token](OAuth ベアラー トークン) の値をコピーします。 これらの値を、Peakon アプリケーションの [プロビジョニング] タブの [テナント URL] および [シークレット トークン] フィールドに入力します。

    Peakon Create Token

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

  1. クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[新しいアプリケーション] に移動します。
  3. [ギャラリーから追加する] セクションで、検索ボックスに「Peakon」と入力して [Peakon] を選びます。
  4. 結果パネルから Peakon を選択し、アプリを追加します。 お使いのテナントにアプリが追加されるのを数秒待機します。 Peakon in the results list

Peakon への自動ユーザー プロビジョニングを構成する

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

ヒント

Peakon では SAML ベースのシングル サインオンを有効にすることもできます。これを行うには、Peakon シングル サインオンのチュートリアルで説明されている手順に従ってください。 シングル サインオンは自動ユーザー プロビジョニングとは別に構成できますが、これらの 2 つの機能は相補的な関係にあります。

Microsoft Entra ID で Peakon の自動ユーザー プロビジョニングを構成するには、次の操作を行います。

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

  2. [ID]>[アプリケーション]>[エンタープライズ アプリケーション] の順に移動します

    Enterprise applications blade

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

    The Peakon link in the Applications list

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

    Screenshot of the Manage options with the Provisioning option called out.

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

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

  6. [管理者資格情報] セクションの [テナント URL] および [シークレット トークン] に、先ほど取得した [SCIM 2.0 URL] および [OAuth Bearer Token](OAuth ベアラー トークン) の値をそれぞれ入力します。 [接続テスト] をクリックして、Microsoft Entra ID で Peakon に接続できることを確かめます。 接続できない場合は、使用中の Peakon アカウントに管理者アクセス許可があることを確認してから、もう一度試します。

    Tenant URL + Token

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

    Notification Email

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

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

    Peakon User Mappings

  10. [属性マッピング] セクションで、Microsoft Entra ID から Peakon に同期されるユーザー属性を確認します。 [Matching](照合) プロパティとして選択されている属性は、更新処理で Peakon のユーザー アカウントとの照合に使用されます。 [保存] ボタンをクリックして変更をコミットします。

    Peakon User Attributes

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

    Provisioning Scope

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

    Saving Provisioning Configuration

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

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

コネクタの制限事項

  • Peakon のすべてのカスタム ユーザー属性は、Peakon の urn:ietf:params:scim:schemas:extension:peakon:2.0:User のカスタム SCIM ユーザー拡張から拡張する必要があります。

その他のリソース

次のステップ