チュートリアル: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 を設定する
Peakon 管理コンソールにサインインします。 [Configuration](構成) をクリックします。
[Integrations](統合) を選択します。
[Employee Provisioning](従業員のプロビジョニング) を有効にします。
[SCIM 2.0 URL] および [OAuth Bearer Token](OAuth ベアラー トークン) の値をコピーします。 これらの値を、Peakon アプリケーションの [プロビジョニング] タブの [テナント URL] および [シークレット トークン] フィールドに入力します。
ギャラリーから Peakon を追加する
Microsoft Entra ID で自動ユーザー プロビジョニング用に Peakon を構成するには、Peakon を Microsoft Entra アプリケーション ギャラリーから管理対象の SaaS アプリケーションの一覧に追加する必要があります。
- クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
- [ID]>[アプリケーション]>[エンタープライズ アプリケーション]>[新しいアプリケーション] に移動します。
- [ギャラリーから追加する] セクションで、検索ボックスに「Peakon」と入力して [Peakon] を選びます。
- 結果パネルから Peakon を選択し、アプリを追加します。 お使いのテナントにアプリが追加されるのを数秒待機します。
Peakon への自動ユーザー プロビジョニングを構成する
このセクションでは、Microsoft Entra ID でのユーザー割り当てやグループ割り当てに基づいて、Peakon でユーザーが作成、更新、無効化されるように Microsoft Entra プロビジョニング サービスを構成する手順について説明します。
ヒント
Peakon では SAML ベースのシングル サインオンを有効にすることもできます。これを行うには、Peakon シングル サインオンのチュートリアルで説明されている手順に従ってください。 シングル サインオンは自動ユーザー プロビジョニングとは別に構成できますが、これらの 2 つの機能は相補的な関係にあります。
Microsoft Entra ID で Peakon の自動ユーザー プロビジョニングを構成するには、次の操作を行います。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
[ID]>[アプリケーション]>[エンタープライズ アプリケーション] の順に移動します
アプリケーションの一覧で [Peakon] を選択します。
[プロビジョニング] タブを選択します。
[プロビジョニング モード] を [自動] に設定します。
[管理者資格情報] セクションの [テナント URL] および [シークレット トークン] に、先ほど取得した [SCIM 2.0 URL] および [OAuth Bearer Token](OAuth ベアラー トークン) の値をそれぞれ入力します。 [接続テスト] をクリックして、Microsoft Entra ID で Peakon に接続できることを確かめます。 接続できない場合は、使用中の Peakon アカウントに管理者アクセス許可があることを確認してから、もう一度試します。
[通知用メール] フィールドに、プロビジョニングのエラー通知を受け取るユーザーまたはグループの電子メール アドレスを入力して、 [エラーが発生したときにメール通知を送信します] チェック ボックスをオンにします。
[保存] をクリックします。
[マッピング] セクションで、[Microsoft Entra ユーザーを Peakon に同期する] を選択します。
[属性マッピング] セクションで、Microsoft Entra ID から Peakon に同期されるユーザー属性を確認します。 [Matching](照合) プロパティとして選択されている属性は、更新処理で Peakon のユーザー アカウントとの照合に使用されます。 [保存] ボタンをクリックして変更をコミットします。
スコープ フィルターを構成するには、スコープ フィルターのチュートリアルの次の手順を参照してください。
プロビジョニングの準備ができたら、 [保存] をクリックします。
これにより、 [設定] セクションの [スコープ] で 定義したユーザーやグループの初期同期が開始されます。 初期同期は後続の同期よりも実行に時間がかかります。後続の同期は、Microsoft Entra プロビジョニング サービスが実行されている限り約 40 分ごとに実行されます。 [同期の詳細] セクションを使うと、進行状況を監視できるほか、リンクをクリックしてプロビジョニング アクティビティ レポートを取得できます。このレポートには、Microsoft Entra プロビジョニング サービスによって Peakon に対して実行されたすべてのアクションが記載されています。
Microsoft Entra プロビジョニング ログの読み方について詳しくは、「自動ユーザー アカウント プロビジョニングについてのレポート」をご覧ください。
コネクタの制限事項
- Peakon のすべてのカスタム ユーザー属性は、Peakon の
urn:ietf:params:scim:schemas:extension:peakon:2.0:User
のカスタム SCIM ユーザー拡張から拡張する必要があります。