チュートリアル: 自動ユーザー プロビジョニングに対応するように Bonusly を構成する

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

Note

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

前提条件

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

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

Note

Microsoft Entra プロビジョニング統合は、Bonusly REST API に依存しています。これは Bonusly 開発者から入手できます。

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

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

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

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

  3. 検索ボックスに「Bonusly」と入力し、結果ウィンドウで Bonusly を選び、 [追加] をクリックして、アプリケーションを追加します。

    Bonusly in the results list

Bonusly へのユーザーの割り当て

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

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

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

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

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

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

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

ヒント

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

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

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

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

    Enterprise applications blade

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

    The Bonusly link in the Applications list

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

    Screenshot of the Bonusly - Provisioning tab. Under Manage, Provisioning is highlighted.

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

    Screenshot showing a Provisioning Mode list box, with Automatic selected and highlighted.

  6. [管理者資格情報] セクションで、手順 6 で説明する Bonusly アカウントの [シークレット トークン] を入力します。

    Screenshot of the Admin credentials section. The Secret token box is empty, but the box is highlighted.

  7. Bonusly アカウントのシークレット トークンは、[管理者] > [会社] > [統合] に配置されています。 [コーディングするもの] セクションで、[API] > [新しい API アクセストークンの作成] をクリックして、新しいシークレット トークンを作成します。

    Screenshot of the Bonusly menu. Under Admin, Company is highlighted. Under Company, Integrations is highlighted.

    Screenshot of the If you want to code section of the Bonusly site, with A P I highlighted.

    Screenshot of the Bonusly site. The Services tab is open. Under Your A P I access tokens, Create new A P I access token is highlighted.

  8. 次の画面で、用意されたテキスト ボックスに、アクセス トークンの名前を入力し、 [Create Api Key](API キーの作成) をクリックします。 数秒後にポップアップ内に新しいアクセス トークンが表示されます。

    Screenshot of the New access token page of the Bonusly site. An unlabeled box contains My Token, and the Create A P I key button is highlighted.

    Screenshot of the Bonusly site. A notification is visible that displays New access token created, followed by an indecipherable token.

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

    Screenshot of the Admin Credentials section. The Text connection button is highlighted.

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

    Screenshot showing an empty Notification email box. An option is visible that is labeled Send an email notification when a failure occurs.

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

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

    Screenshot of the Mappings section. Under Name, Synchronize Microsoft Entra users to Bonusly is highlighted.

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

    Screenshot of the Attribute Mappings page. A table lists Microsoft Entra attributes, corresponding Bonusly attributes, and the matching status.

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

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

    Screenshot of the Settings section. The Provisioning status toggle is set to Off.

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

    Screenshot showing the Scope list box. Sync only assigned users and groups is selected in the box.

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

    Screenshot of the Bonusly - Provisioning page, with the Save button highlighted.

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

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

その他のリソース

次のステップ