> ## 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 内のユーザーを安全にプロビジョニング、更新、削除できます。

<Note>SCIM Users を有効にする前に、アカウントで SSO が設定されている必要があります。SCIM を有効にするには、[CData サポート](https://jp.cdata.com/support/) にお問い合わせください。</Note>

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

## SCIM ユーザーのプロビジョニング、更新、およびデプロビジョニング

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

新規ユーザーをプロビジョニングするには、一意の SCIM エンドポイントに `POST` リクエストを送信します。システムが Connect AI でユーザーをプロビジョニングします。ユーザーが E メールで確認する必要はありません。新規ユーザーのデフォルトロールは Query ユーザーです。システムロールの詳細については、[Roles](/ja/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/Roles) を参照してください。