前提条件
- SCIM Users を有効にする前に、Connect AI アカウントでSSO が設定されている必要があります。
- アカウントでSCIM Users が有効になっていること。SCIM Users の有効化については、CData サポート にお問い合わせください。
- Microsoft Entra ID ライセンス要件 (Entra ID のみ):自動SCIM プロビジョニングにはMicrosoft Entra ID Premium P1 またはP2(Microsoft 365 E3/E5 に含まれる)が必要です。Entra ID の無料プランでは自動プロビジョニングを構成できません。
- Microsoft Entra ID
- Okta Workforce Identity Cloud
- カスタムIdP(SAML またはOpenID Connect 経由で構成)
- PingFederate
- Google Workspace
- Active Directory Federation Services (ADFS)
- Active Directory/LDAP
ID プロバイダーでSCIM ユーザープロビジョニングを設定する
CData サポートがアカウントでSCIM を有効にすると、セルフサービスリンクが送信されます。このリンクを使用して、一意のSCIM エンドポイントURL とBearer トークンを取得し、ID プロバイダーをConnect AI に接続します。リンクを開く前に、SCIM またはSSO 認証情報の取得 を確認してください。 以下の手順では、Microsoft Entra ID およびOkta Workforce Identity Cloud でのSCIM ユーザーの全体的な設定を説明します。- Entra ID
- Okta
Connect AI はEntra アプリケーションギャラリーには表示されません。 ギャラリーから新しいアプリケーションを作成してください。
1
Microsoft Entra 管理センター から、エンタープライズ アプリケーション > + 新しいアプリケーション に移動します。独自のアプリケーションの作成 をクリックし、アプリケーションの名前を入力して(例:Connect AI SCIM)、ギャラリーに見つからないその他のアプリケーションを統合します(ギャラリー以外) を選択し、作成 をクリックします。
2
ナビゲーションメニューの 管理 で プロパティ を選択します。割り当てが必要 を はい に設定し、保存 をクリックします。
3
ナビゲーションメニューの 管理 で ユーザーとグループ を選択します。Connect AI にプロビジョニングするユーザーとグループを割り当てます。グループを割り当てると、そのグループのユーザーが自動的にプロビジョニングされます。
4
ナビゲーションメニューの 管理 で プロビジョニング を選択し、開始する をクリックします。
5
プロビジョニング モード を 自動 に設定します。
6
管理 でConnectivity を選択し、以下のパラメータを設定します:
- テナントURL–セルフサービスセッションで取得したSCIM エンドポイントURL を入力し、URL の末尾に
?aadOptscim062020を追加します。これは、既知のSCIM 2.0 の問題に対するMicrosoft の推奨回避策です。 - シークレット トークン–セルフサービスセッションで取得したBearer トークンを入力します。
7
管理 で 属性マッピング を選択し、ユーザー タブを選択します。
mail と emails[type eq "work"].value を含む行で鉛筆アイコンをクリックし、以下を設定します:- この属性を使用してオブジェクトを一致させる を はい に設定します。
- 一致の優先順位 を 2 に設定します。
組織内のユーザーにEntra ID で
mail 属性が設定されていない場合は、同じ行を編集し、ソース属性 を userPrincipalName に変更して、プロビジョニング中にE メールフィールドが常に入力されるようにしてください。8
メインのエンタープライズアプリケーションページで、オンデマンドでプロビジョニング を選択します。割り当てたユーザーを検索して選択し、プロビジョニング をクリックします。ユーザーがConnect AI に表示されることを確認します。
9
プロビジョニング で プロビジョニングの状態 を オン に設定して、割り当てられたすべてのユーザーとグループのプロビジョニングを開始します。
SCIM またはSSO 認証情報の取得
CData サポートが、1 回限り使用できるセルフサービスリンクを送信します。このリンクを使用して、ID プロバイダー(IdP)に入力する値(SCIM のTenant URL、SCIM のBearer トークン、SSO のコールバックURL など)を受け取ります。リンクを開く前に
リンクを開く前に、次の準備を完了してください:- 組織でIdP の構成に必要な社内IT の承認や変更チケットを取得します。
- IdP(Microsoft Entra ID やOkta など)の管理者アクセス権があることを確認します。
- リンクを開く前に、SSO 用かSCIM 用かをCData サポートに確認します。
- 受け取った値を保管するための、パスワードマネージャーなどの安全な場所を用意します。
- リンクは、プロセスを完了する管理者のみと共有してください。先に開いてしまう可能性のある人には転送しないでください。
有効期限
リンクは、サポートが送信してから一定時間内に開かないと失効します。リンクを開いた後も、一定時間が経過するとセッションが終了します。リンクが失効した場合、または完了前にセッションが終了した場合は、サポートに新しいリンクを依頼してください。新しいリンクを依頼するタイミング
次の場合は、CData サポート に新しいリンクを依頼してください:- リンクが失効した、または準備が整う前にリンクを開いた。
- SCIM のBearer トークンまたはIdP のクライアントシークレットをローテーションする必要がある。
- 受け取った値を紛失した。
- 新しい環境またはIdP アプリケーションを構成する。
API を介した直接プロビジョニング、更新、およびデプロビジョニング
IdP ベースのプロビジョニングに加えて、SCIM API を介してユーザーを直接管理できます。セルフサービスセッションで取得する一意のベースURL は、次の形式です:https://<YOUR_DOMAIN>/scim/v2。このURL エンドポイントには、必要なユーザーメタデータが含まれます。すべてのSCIM エンドポイントでは、Bearer トークンを含む Authorization ヘッダーが必要です。
新規ユーザーをプロビジョニングするには、一意のSCIM エンドポイントに POST リクエストを送信します。システムがConnect AI でユーザーをプロビジョニングします。ユーザーがE メールで確認する必要はありません。新規ユーザーのデフォルトのシステムロールはQuery です。システムロールの詳細については、Roles を参照してください。新規ユーザーは、ユーザー定義の認証情報が有効になっているコネクションにのみアクセスできます。
SCIM ユーザーの名前とE メールを更新するには、SCIM エンドポイントに PATCH リクエストを使用します。SCIM の更新ユーザーリクエストを受け取ると、システムがConnect AI 内の情報を更新します。
ユーザーを削除するには、一意のSCIM エンドポイントに DELETE リクエストを使用します。SCIM の削除イベントが削除エンドポイントを呼び出します。完全にデプロビジョニングするには、Management API から DELETE /users/{id} も呼び出して、パーソナルアクセストークン(PAT)とすべての直接のロール割り当ておよび権限付与を取り消します。
Connect AI の 監査ログ には、SCIM のユーザーのプロビジョニング、更新、削除が表示されます。
ロールと権限
Connect AI におけるユーザーのアクセスは、グループ由来のロール(SCIM グループの割り当てから)、直接のロール割り当て、および直接のリソース権限の組み合わせです。Management API(ベースパス/api/v1/)を使用して、直接の割り当てを管理し、ユーザーを完全にデプロビジョニングできます:
システムロールおよびアクセスロールの詳細については、Roles を参照してください。