Microsoft Entra を使用した SCIM プロビジョニングの構成

このガイドでは、Microsoft Entra から Zilliz Cloud への SCIM プロビジョニングを構成する方法について説明します。SCIM プロビジョニングを使用すると、Microsoft Entra から Zilliz Cloud 組織へユーザーをプロビジョニングできます。

組織で既に SSO に Microsoft Entra を使用している場合は、ユーザーサインイン用の既存の SSO アプリケーションをそのまま使用してください。SCIM プロビジョニングは、専用のエンタープライズアプリケーションで別途構成します。SSO、SCIM、同期グループ、アクセス制御の連携についての概要は、SCIM プロビジョニングを参照してください。

次の図は、Zilliz Cloud と Microsoft Entra 間のセットアップフローを示しています。

事前準備

• Zilliz Cloud 組織の SSO が構成および検証済みであること。

• SCIM プロビジョニングを構成する Zilliz Cloud 組織の Organization Owner であること。

• Microsoft Entra でエンタープライズアプリケーションとそのプロビジョニング設定を作成または管理できる権限があること。

手順 1: Zilliz Cloud で SCIM ベース URL と API トークンを取得する

Zilliz Cloud の SCIM プロビジョニング設定には、Microsoft Entra が Zilliz Cloud SCIM API を呼び出すために必要な接続情報が含まれています。

1

左側のナビゲーションペインで Settings をクリックします。

2

System for Cross-domain Identity Management (SCIM) までスクロールし、Enable をクリックします。

3

Enable SCIM ダイアログで Enable をクリックします。

4

SCIM Base URL と SCIM API Token をコピーします。

これらの値は、Microsoft Entra でプロビジョニングを構成する際に使用します。SCIM API トークンはシークレットとして厳重に管理してください。

手順 2: Microsoft Entra で SCIM アプリを作成する

SCIM プロビジョニング用の非ギャラリーエンタープライズアプリケーションを作成します。組織に専用の Zilliz Cloud SCIM エンタープライズアプリケーションが既に存在する場合は、新規作成せずにそのアプリケーションを選択してください。Microsoft の一般的な非ギャラリー SCIM ワークフローについては、SCIM エンドポイントのプロビジョニングの開発と計画を参照してください。

1

Microsoft Entra 管理センターで、Entra ID > Enterprise apps に移動します。

2

+ New application をクリックし、+ Create your own application をクリックします。

3

アプリケーションの名前を入力します。

4

Integrate any other application you don't find in the gallery を選択し、Create をクリックします。

手順 3: Microsoft Entra で SCIM プロビジョニングを構成する

Zilliz Cloud の SCIM 資格情報を使用してエンタープライズアプリケーションを構成します。Microsoft のドキュメントでは、非ギャラリー SCIM プロビジョニングにおける Tenant URL、Secret Token、Test Connection について説明されています。ワークフロー全体の詳細については、自動ユーザープロビジョニングの構成を参照してください。

1

エンタープライズアプリケーションで Provisioning を開き、+ New configuration をクリックします。

2

Tenant URL に、Zilliz Cloud の SCIM Base URL を入力します。

3

Secret Token に、Zilliz Cloud の SCIM API Token を入力します。

4

Test Connection をクリックします。

5

接続テストが成功したら、Create をクリックします。

SCIM API トークンはベアラートークンとして使用されます。プロビジョニングを開始する前に、デフォルトのマッピングとプロビジョニングスコープを確認してください。他の SCIM 統合との類似性のみを根拠に属性を追加または再マッピングしないでください。マッピングの概念については、アプリケーション属性のカスタマイズを参照してください。

手順 4: Microsoft Entra からユーザーとグループをプロビジョニングする

プロビジョニング対象のユーザーまたはグループを割り当ててから、プロビジョニングを有効にします。以下の手順ではグループを例に説明しますが、プロビジョニングの要件に応じて対象グループまたは個別のユーザーを選択してください。Microsoft の割り当てワークフローとライセンス要件については、アプリケーションへのユーザーとグループの割り当てを参照してください。

1

エンタープライズアプリケーションで Users and groups を開きます。

2

Add user/group, をクリックしてメンバーセレクターを開きます。

3

Groups タブを開いて対象グループを選択し、Select をクリックしてから Assign をクリックします。

4

Provisioning に戻り、Provisioning Status を On に設定します。

5

Save をクリックします。

プロビジョニングを有効にした後、必要に応じて Provisioning logs を開き、操作の監視や障害のトラブルシューティングを行ってください。グループベースのアプリケーション割り当てには Microsoft Entra ID P1 または P2 が必要です。プロビジョニングサイクル、スコープ、ログの詳細については、アプリケーションプロビジョニングの仕組みを理解するを参照してください。

手順 5: Zilliz Cloud でプロビジョニングを検証する

Microsoft Entra でプロビジョニングジョブが実行された後、Zilliz Cloud で期待通りのユーザーまたは同期グループが反映されているか確認します。以下の手順では同期グループを例に説明します。

1

Zilliz Cloud 組織で Access Control をクリックし、Groups タブを開きます。

2

同期されたグループを選択し、詳細を確認します。

SCIM は ID データのみを同期します。組織ロールとプロジェクトロールは Zilliz Cloud で別途割り当ててください。グループではなく個別のユーザーを割り当てた場合は、組織メンバービューで確認してください。ここでの確認例はプロビジョニングされたグループが Zilliz Cloud に表示されることを示すものであり、その後のすべてのグループライフサイクル操作を保証するものではありません。

トラブルシューティング

問題	確認事項
接続テストが失敗する	Tenant URL に完全な Zilliz SCIM Base URL が、Secret Token に最新の SCIM API Token が正しく入力されているか確認してください。両方の値を Zilliz Cloud から再度コピーしてください。
割り当てたユーザーまたは同期グループが Zilliz Cloud に表示されない	割り当て、プロビジョニングスコープ、マッピング、ジョブステータス、および Provisioning logs 内の該当ユーザーまたはグループの操作結果を確認してください。
プロビジョニングでマッピング、スコープ、またはステータスのエラーが報告される	デフォルトのマッピング、一致プロパティ、選択されたスコープ、ジョブステータスを確認してください。設定を変更する前に、Microsoft のプロビジョニングおよび属性マッピングに関するドキュメントをご確認ください。
グループを割り当てられない	テナントが Microsoft Entra ID P1 または P2 ライセンスを保有しているか確認してください。個別ユーザーの割り当ては別途テスト可能です。
グループ割り当ては成功するが同期グループが表示されない	Provisioning logs でグループおよびメンバーシップ操作を確認し、割り当てとプロビジョニングスコープが正しいか、Provisioning Status が On になっているかを確認してください。