この記事では、自動ユーザー プロビジョニングを構成するために Jostle と Microsoft Entra ID の両方で実行する必要がある手順について説明します。 設定された場合、Microsoft Entra ID は Microsoft Entra プロビジョニング サービスを使用して、ユーザーとグループを Jostle に自動的にプロビジョニングおよび解除します。 このサービスの機能、しくみ、よく寄せられる質問の詳細については、「 Microsoft Entra ID を使用した SaaS アプリケーションへの自動ユーザー プロビジョニングとプロビジョニング解除」を参照してください。
サポートされる機能
- Jostle でユーザーを作成する
- アクセスが不要になった場合に Jostle のユーザーを削除する
- Microsoft Entra IDと Jostle の間でユーザー属性の同期を維持する
- Jostle へのシングル サインオン (推奨)
- 有効期間が長いベアラー トークン認証がサポートされています。
前提条件
この記事で説明するシナリオでは、次の前提条件が既にあることを前提としています。
-
- アクティブなサブスクリプションを持つMicrosoft Entra ユーザー アカウント。 まだアカウントがない場合は、無料でアカウントを作成することができます。
- 次のいずれかのロール:
- Jostle テナント。
- 管理者アクセス許可がある Jostle のユーザー アカウント。
手順 1:プロビジョニングのデプロイを計画する
- プロビジョニング サービスのしくみを確認します。
- プロビジョニングのスコープに含めるユーザーを決定します。
- Microsoft Entra IDとJostleの間でマップするデータを決定する。
手順 2: Microsoft Entra IDでのプロビジョニングをサポートするように Jostle を構成する
Automation アカウント
開始する前に、Jostle イントラネットで Automation ユーザーを作成する必要があります。 これは、Azureで構成するために使用するアカウントです。 Automation ユーザーは、管理の [設定] > [ユーザー アカウントとデータ] > [Automation ユーザーの管理] で作成できます。
Automation ユーザーとその作成方法の詳細については、こちらの記事を参照してください。
作成後、Automation ユーザー アカウントは、(つまり、イントラネットに少なくとも 1 回ログインして) アクティブ化されてからでないと、Azure の構成に使用できません。
ユーザー プロビジョニングを管理する
開始する前に、アカウントのサブスクリプションに SSO/ユーザープロビジョニング機能が含まれていることを確認してください。 含まれていない場合は、カスタマー サクセス マネージャーsuccess@jostle.me にご連絡いただければ、アカウントへの追加を支援いたします。
次のステップでは、Jostle から API URL と API キーを取得します。
メイン ナビゲーションに移動し 、[管理者設定] を選択します。
[ 他のシステム間のユーザー データ ] で、[ ユーザー プロビジョニングの管理 ] を選択します。ここに [ユーザー プロビジョニングの管理] が表示されない場合に、アカウントに SSO/ユーザー プロビジョニングが含まれていることを確認した場合は、サポート support@jostle.me に問い合わせて、管理設定でこのページを有効にしてください)。
[User Provisioning API details]\(ユーザー プロビジョニング API の詳細\) セクションで、[ベース URL] フィールドに移動し、[コピー] ボタンを選択し、後で簡単にアクセスできる場所に URL を保存します。
次に、[ 新しいキーの追加]を選択します。..ボタン
次の画面で、 [Automation User](Automation ユーザー) フィールドに移動し、ドロップダウン メニューを使用して Automation ユーザー アカウントを選択します。
プロビジョニング API キーの説明 フィールドにキーに名前 (
Azureなど) を指定し、Add ボタンを選択します。キーが生成されたら、 すぐにコピー し、URL を保存した場所に保存してください (キーが表示されるのは唯一の時間であるため)。
手順 3: Microsoft Entra アプリケーション ギャラリーから Jostle を追加する
Microsoft Entra アプリケーション ギャラリーから Jostle を追加して、Jostle へのプロビジョニングの管理を開始します。 以前に SSO 用の Jostle を設定している場合は、同じアプリケーションを使用できます。 ただし、統合を初めてテストするときは、別のアプリを作成することをお勧めします。 ギャラリーからアプリケーションを追加する方法の詳細については、こちらを参照してください。
手順 4: プロビジョニングのスコープに含まれるユーザーを定義する
Microsoft Entra プロビジョニング サービスを使用すると、アプリケーションへの割り当てに基づいて、またはユーザーまたはグループの属性に基づいてプロビジョニングされたユーザーをスコープできます。 割り当てに基づいてアプリにプロビジョニングされるユーザーのスコープを設定する場合は、 手順を使用してユーザーとグループをアプリケーションに割り当てることができます。 ユーザーまたはグループの属性のみに基づいてプロビジョニングする対象を決定する場合、スコープフィルターを使用できます。
小さいところから始めましょう。 全員にロールアウトする前に、少数のユーザーとグループでテストします。 プロビジョニングのスコープが割り当て済みユーザーとグループに設定される場合、これを制御するには、1 つまたは 2 つのユーザーまたはグループをアプリに割り当てます。 スコープがすべてのユーザーとグループに設定されている場合は、属性ベースのスコープ フィルターを指定できます。
追加のロールが必要な場合は、 アプリケーション マニフェストを更新 して新しいロールを追加できます。
ステップ 5: Jostle への自動ユーザー プロビジョニングを構成する
このセクションでは、Microsoft Entra IDのユーザーとグループの割り当てに基づいて Jostle アプリでユーザーとグループを作成、更新、無効化するように Microsoft Entra プロビジョニング サービスを構成する手順について説明します。
注
Jostle への自動ユーザー プロビジョニングの詳細については、「User-Provisioning-Azure-Integrationを参照してください。
Microsoft Entra IDで Jostle の自動ユーザー プロビジョニングを構成するには:
Microsoft Entra 管理センターに少なくとも Cloud アプリケーション管理者としてサインインします。
Entra ID>Enterprise appsを参照してください
![[エンタープライズ アプリケーション] ブレードのスクリーンショット。](common/enterprise-applications.png)
アプリケーションの一覧で [Jostle] を選択します。
[プロビジョニング] タブ を 選択し、[ 作業の開始] を選択します。
![[プロビジョニング] タブのスクリーンショット。](common/provisioning.png)
[ + 新しい構成] を選択します。
![[プロビジョニング] タブの [自動] のスクリーンショット。](common/application-provisioning.png)
[ テナント URL ] フィールドに、Jostle テナント URL とシークレット トークンを入力します。 [Test Connection を選択して、Microsoft Entra IDが Jostle に接続できることを確認します。 接続に失敗した場合は、Jostle アカウントに必要な管理者アクセス許可があることを確認してから、もう一度やり直してください。
[ 作成] を選択して構成を作成します。
[概要] ページで [プロパティ] を選択します。
[ 通知メール ] フィールドに、プロビジョニング エラー通知を受け取るユーザーのメール アドレスを入力し、[ エラーが発生したときに電子メール通知を送信 する] チェック ボックスをオンにします。
左側のパネルで [属性マッピング ] を選択し、ユーザーを選択 します。
Attribute-Mapping セクションで、Microsoft Entra IDから Jostle に同期されるユーザー属性を確認します。 照合プロパティとして選択された属性は、更新の操作を行う場合に Jostle のユーザー アカウントを照合する際に使用されます。 一致するターゲット属性を変更する場合は、Jostle API がその属性に基づくユーザーのフィルター処理をサポートしていることを確認する必要があります。 [保存] ボタンをクリックして変更をコミットします。
属性 タイプ フィルター処理のサポート ユーザー名 糸 ✓ 活動中 ブール値 name.givenName 糸 name.familyName 糸 emails[type eq "work"].value 糸 emails[type eq "personal"].value 糸 emails[type eq "alternate1"].value 糸 emails[type eq "alternate2"].value 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:alternateEmail1Label 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:alternateEmail2Label 糸 DisplayName 糸 外部識別子 糸 Title 糸 ニックネーム 糸 ユーザー種別 糸 生年月日 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:CustomBadge 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:CustomFilterCategory 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:CustomProfile 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:JoinDate 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Locations 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:LoginType 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:PersonalPronouns 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1Country 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1Locality 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1PostalCode 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1StreetAddress 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address1Region 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2Country 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2Locality 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2PostalCode 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2StreetAddress 糸 urn:ietf:params:scim:schemas:extension:jostle:2.0:User:Address2Region 糸 phoneNumbers[type eq "workofficephone"].value 糸 phoneNumbers[type eq "homephone"].value 糸 phoneNumbers[type eq "workmobilephone"].value 糸 phoneNumbers[type eq "personalmobilephone"].value 糸 スコープ フィルターを構成するには、スコープ フィルターに関する記事に記載されている手順 を参照してください。
オンデマンド プロビジョニングを使用して、少数のユーザーとの同期を検証してから、組織内でより広範にデプロイします。
プロビジョニングの準備ができたら、[概要] ページから [プロビジョニングの開始] を選択します。
手順 6:デプロイを監視する
プロビジョニングを構成したら、次のリソースを使用してデプロイを監視します。
- プロビジョニング ログを使用して、どのユーザーが正常にプロビジョニングされたか、または正常にプロビジョニングされなかったかを判断する
- 進行状況バーを確認して、プロビジョニング サイクルの状態と完了までの近さを確認します
- プロビジョニング構成が異常な状態にあると思われる場合、アプリケーションは検疫に入ります。 検疫状態についての詳細は、アプリケーションプロビジョニングの隔離状態に関する記事をご覧ください。