> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SCIM Users

> SCIM を使用して、Connect AI への個別ユーザーのアクセス付与および削除のプロセスを標準化します。

System for Cross-domain Identity Management (SCIM) は、クラウドベースのアプリケーションにおけるユーザーのプロビジョニング、更新、削除を管理するための標準です。Okta や Entra ID などの自社の ID プロバイダーを使用して、Connect AI 内のユーザーを安全にプロビジョニング、更新、削除できます。

## 前提条件

* SCIM Users を有効にする前に、Connect AI アカウントで **SSO** が設定されている必要があります。
* アカウントで **SCIM Users** が有効になっていること。SCIM Users の有効化については、[CData サポート](https://jp.cdata.com/support/) にお問い合わせください。
* **Microsoft Entra ID ライセンス要件** *（Entra ID のみ）*：自動 SCIM プロビジョニングには Microsoft Entra ID Premium P1 または P2（Microsoft 365 E3/E5 に含まれる）が必要です。Entra ID の無料プランでは自動プロビジョニングを構成できません。

Connect AI は、以下の ID プロバイダーでの SCIM プロビジョニングをサポートしています：

* Microsoft Entra ID
* Okta Workforce Identity Cloud
* カスタム IdP（SAML または OpenID Connect 経由で構成）

以下の SCIM プロバイダーは **サポートされていません**：

* PingFederate
* Google Workspace
* Active Directory Federation Services (ADFS)
* Active Directory/LDAP

## ID プロバイダーで SCIM ユーザープロビジョニングを設定する

CData サポートがアカウントで SCIM を有効にすると、一意の SCIM エンドポイント URL と Bearer トークンを提供します。これらの認証情報を使用して、ID プロバイダーを Connect AI に接続します。

以下の手順では、Microsoft Entra ID および Okta Workforce Identity Cloud での SCIM ユーザーの全体的な設定を説明します。

<Tabs>
  <Tab title="Entra ID">
    <Note>
      **Connect AI は Entra アプリケーションギャラリーには表示されません。** ギャラリーから新しいアプリケーションを作成してください。
    </Note>

    <Steps>
      <Step>
        [Microsoft Entra 管理センター](https://entra.microsoft.com) から、**エンタープライズ アプリケーション** > **+ 新しいアプリケーション** に移動します。**独自のアプリケーションの作成** をクリックし、アプリケーションの名前を入力して（例：*Connect AI SCIM*）、**ギャラリーに見つからないその他のアプリケーションを統合します（ギャラリー以外）** を選択し、**作成** をクリックします。
      </Step>

      <Step>
        ナビゲーションメニューの **管理** で **プロパティ** を選択します。**割り当てが必要** を **はい** に設定し、**保存** をクリックします。
      </Step>

      <Step>
        ナビゲーションメニューの **管理** で **ユーザーとグループ** を選択します。Connect AI にプロビジョニングするユーザーとグループを割り当てます。グループを割り当てると、そのグループのユーザーが自動的にプロビジョニングされます。
      </Step>

      <Step>
        ナビゲーションメニューの **管理** で **プロビジョニング** を選択し、**開始する** をクリックします。
      </Step>

      <Step>
        **プロビジョニング モード** を **自動** に設定します。
      </Step>

      <Step>
        **管理** で **Connectivity** を選択し、以下のパラメータを設定します：

        * **テナント URL**—CData サポートから提供された SCIM エンドポイント URL を入力し、URL の末尾に `?aadOptscim062020` を追加します。これは、既知の SCIM 2.0 の問題に対する Microsoft の推奨回避策です。
        * **シークレット トークン**—CData サポートから提供された Bearer トークンを入力します。

        **テスト接続** をクリックします。
      </Step>

      <Step>
        **管理** で **属性マッピング** を選択し、**ユーザー** タブを選択します。`mail` と `emails[type eq "work"].value` を含む行で鉛筆アイコンをクリックし、以下を設定します：

        * **この属性を使用してオブジェクトを一致させる** を **はい** に設定します。
        * **一致の優先順位** を **2** に設定します。

        **適用** をクリックして保存し、属性マッピングページで **保存** をクリックします。

        <Note>組織内のユーザーに Entra ID で `mail` 属性が設定されていない場合は、同じ行を編集し、**ソース属性** を `userPrincipalName` に変更して、プロビジョニング中に E メールフィールドが常に入力されるようにしてください。</Note>
      </Step>

      <Step>
        メインのエンタープライズアプリケーションページで、**オンデマンドでプロビジョニング** を選択します。割り当てたユーザーを検索して選択し、**プロビジョニング** をクリックします。ユーザーが Connect AI に表示されることを確認します。
      </Step>

      <Step>
        **プロビジョニング** で **プロビジョニングの状態** を **オン** に設定して、割り当てられたすべてのユーザーとグループのプロビジョニングを開始します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="Okta">
    <Steps>
      <Step>
        Okta 管理コンソールで、**Applications** > **Browse App Catalog** に移動します。**(OAuth Bearer Token) Governance with SCIM 2.0** を検索して **Add Integration** を選択します。**Application label** を設定し、**Display application icon to users** と **Browser plugin auto-submit** のチェックを外して、**Next**、**Done** の順に選択します。
      </Step>

      <Step>
        アプリケーション設定ページから **Provisioning** タブを選択し、**Configure API Integration** をクリックします。**Enable API Integration** を選択します。CData サポートから提供された以下の値を入力します：

        * **SCIM 2.0 Base URL** — SCIM エンドポイント URL（末尾のスラッシュを削除）
        * **OAuth Bearer Token** — Bearer トークン

        オプションで **Test API Credentials** を選択して接続を検証し、**Save** を選択します。
      </Step>

      <Step>
        **Provisioning to App** の横にある **Edit** を選択します。以下の機能を有効にします：

        * **Create Users**
        * **Update User Attributes**
        * **Deactivate Users**

        **Set password when creating new users** のチェックを外し、**Save** を選択します。
      </Step>

      <Step>
        **Attribute Mappings** で、**X** ボタンを使用して以下の行を削除します。これらは更新時に問題を引き起こす可能性があります：

        * **Primary email type**
        * **Primary phone type**
        * **Address type**
      </Step>

      <Step>
        **Assignments** タブを選択します。**Assign** をクリックし、Connect AI にプロビジョニングするユーザーを選択します。

        <Note>Okta では、SCIM アプリケーションと SSO アプリケーションの両方に同じユーザーを割り当てる必要があります。</Note>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## API を介した直接プロビジョニング、更新、およびデプロビジョニング

IdP ベースのプロビジョニングに加えて、SCIM API を介してユーザーを直接管理できます。CData サポートが次の形式の一意のベース URL を提供します：`https://{your-domain.com}/scim/v2`。この URL エンドポイントには、必要なユーザーメタデータが含まれます。すべての SCIM エンドポイントでは、`Bearer` トークンを含む `Authorization` ヘッダーが必要です。

新規ユーザーをプロビジョニングするには、一意の SCIM エンドポイントに `POST` リクエストを送信します。システムが Connect AI でユーザーをプロビジョニングします。ユーザーが E メールで確認する必要はありません。新規ユーザーのデフォルトシステムロールは Query ユーザーです。システムロールの詳細については、[Roles](/ja/Identities/Roles) を参照してください。新規ユーザーは、ユーザー定義の認証情報が有効になっているコネクションにのみアクセスできます。

SCIM ユーザーの名前と E メールを更新するには、SCIM エンドポイントに `PATCH` リクエストを使用します。SCIM の更新ユーザーリクエストを受け取ると、システムが Connect AI 内の情報を更新します。

ユーザーを削除するには、一意の SCIM エンドポイントに `DELETE` リクエストを使用します。SCIM の削除イベントが削除エンドポイントを呼び出します。完全にデプロビジョニングするには、Management API から `DELETE /users/{id}` も呼び出して、PAT とすべての直接のロール割り当ておよび権限付与を取り消します。

Connect AI の [監査ログ](/ja/Logs#audit-log) には、SCIM のユーザーのプロビジョニング、更新、削除が表示されます。

## ロールと権限

Connect AI におけるユーザーのアクセスは、グループ由来のロール（SCIM グループの割り当てから）、直接のロール割り当て、および直接のリソース権限の組み合わせです。Management API（ベースパス `/api/v1/`）を使用して、直接の割り当てを管理し、ユーザーを完全にデプロビジョニングできます：

| メソッド | パス | 説明 |
| - | - | - |
| `GET` | `/users` | すべてのユーザーを一覧表示します。 |
| `GET` | `/users/{id}` | 単一のユーザーとその直接権限を含めて取得します。 |
| `PATCH` | `/users/{id}` | ユーザー属性を更新します。 |
| `DELETE` | `/users/{id}` | デプロビジョニング：すべての PAT を取り消し、すべての直接のロール割り当ておよび権限付与を削除します。 |
| `POST` | `/users/{id}/roles` | ユーザーにロールを直接割り当てます。 |
| `GET` | `/users/{id}/roles` | ユーザーに割り当てられたすべてのロールを一覧表示し、それぞれが直接割り当てられたか、グループから継承されたかを示します。 |
| `DELETE` | `/users/{id}/roles/{role_id}` | 直接のロール割り当てを削除します。 |
| `POST` | `/users/{id}/permissions` | ユーザーにリソース権限を直接割り当てます。 |
| `GET` | `/users/{id}/permissions` | ユーザーに割り当てられた直接の権限を一覧表示します。 |
| `DELETE` | `/users/{id}/permissions/{permission_id}` | 直接の権限を削除します。 |

システムロールおよびアクセスロールの詳細については、[Roles](/ja/Identities/Roles) を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.