> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# SCIM

## 概要

> **Info**
>
> SCIMは**エンタープライズ**ワークスペースで利用できます。これらの設定を構成できるのは**ワークスペース管理者**のみです。

## 前提条件

* エンタープライズのElevenLabsワークスペース。
* ElevenLabsでのワークスペース管理者アクセス。
* ワークスペース用に[設定済みのSSO](/docs/ja/overview/administration/workspaces/sso)。ほとんどのアイデンティティ
  プロバイダーでは、SCIMプロビジョニングを接続するために既存のSSOアプリ統合が必要です。

## SCIMを設定する

#### SCIM設定を開く

**ワークスペース設定** > **セキュリティ＆SSO** > **SCIM**に移動します。

#### トークンを生成する

**Generate Token**をクリックします。**Base URL**と**Bearer token**をすぐにコピーしてください。

> **Warning**
>
> トークンは一度しか表示されません。紛失した場合は新しいトークンを生成する必要があり、以前のトークンは
> 無効になり、現在設定されているIdPプロビジョニングはすべて切断されます。

#### アイデンティティプロバイダーを構成する

IdPのSCIM／プロビジョニング設定で、次を行います。

* **SCIM Endpoint/Connector URL**をElevenLabsからコピーしたBase URLに設定します。
* 認証モードを**HTTP Bearer Token**に設定し、トークンを貼り付けます。

プロバイダー固有の手順については、[アイデンティティプロバイダー別の設定](#setup-by-identity-provider)を参照してください。

> **Note**
>
> IdPでユーザーを削除または無効化すると、そのユーザーのElevenLabsワークスペースへのアクセスは取り消されます。
> ワークスペースでの過去のアクティビティは保持されます。

## 機能

ElevenLabsは、次の機能を備えたSCIM 2.0プロトコルに対応しています。

| 機能                      | 対応状況  | 詳細                                                   |
| :---------------------- | :---- | :--------------------------------------------------- |
| **検出エンドポイント**           | ✅ はい  | `/ServiceProviderConfig`、`/Schemas`、`/ResourceTypes` |
| **ユーザー**                | ✅ はい  | `GET`、`POST`、`PUT`、`PATCH`、`DELETE`                  |
| **ユーザーのプライマリメールアドレス更新** | ❌ いいえ |                                                      |
| **グループ**                | ✅ はい  | `GET`、`POST`、`PUT`、`PATCH`、`DELETE`                  |
| **検索**                  | ✅ はい  | `?filter`を使用した`GET`または`/.search`への`POST`             |
| **ページネーション**            | ✅ はい  | `startIndex`と`count`に対応                              |
| **一括操作**                | ✅ はい  | `リクエストあたりの最大操作数：100`、`最大ペイロードサイズ：1MB`                |
| **属性フィルタリング**           | ✅ はい  | `attributes`と`excludedAttributes`に対応                 |
| **ソート**                 | ❌ いいえ | クエリ時に`sortBy`と`sortOrder`は無視されます                     |

## 対応属性

* **ユーザー**：`userName`、`name`、`emails`、`active`、`externalId`
* **グループ**：`displayName`、`members`、`externalId`

> **Warning**
>
> SCIMによるメールアドレスの変更には対応していません。IdPでユーザーのプライマリメールアドレスを更新すると、
> そのユーザーのSCIM同期が失敗する可能性があります。

## アイデンティティプロバイダー別の設定

#### Microsoft Entra IDの設定

#### プロビジョニング設定を開く

Microsoft Entra管理センターで、ElevenLabsアプリを選択し、
**Provisioning**を開きます。

#### プロビジョニングモードを設定する

**Provisioning Mode**を**Automatic**に設定します。

#### SCIM認証情報を追加する

**Admin Credentials**で、次を設定します。

* **Tenant URL**をElevenLabsのSCIM Base URLに設定します。
* **Secret Token**をElevenLabsのBearerトークンに設定します。

#### プロビジョニングをテストして有効化する

**Test Connection**をクリックして設定を保存し、準備ができたら**Provisioning Status**を
**On**に設定します。

#### Oktaの設定

#### カスタムアプリ統合を作成または開く

SSOサインインに使用しているElevenLabsアプリを開き、**General**に移動します。

#### アプリでSCIMを有効にする

**App Settings**の**Edit**をクリックし、**Provisioning**を**SCIM**に設定します。

#### SCIM接続を構成する

**Provisioning** > **Settings** > **Integration**で、次を設定します。

* **SCIM connector base URL**をElevenLabsのSCIM Base URLに設定します。
* ワークスペースに必要なプロビジョニング操作（例：新規ユーザーのプッシュ、プロファイル更新のプッシュ、
  グループのプッシュ）を選択し、**Test Connector Configuration**を実行して保存します。
* **Authentication Mode**を**HTTP Header**に設定します。
* **Authorization**フィールドにElevenLabsのBearerトークンを貼り付けます。
* **Save**をクリックします。

#### OneLoginの設定

#### アプリ設定を開く

OneLogin Adminで、ElevenLabsアプリを開きます。

#### ConfigurationでSCIM認証情報を追加する

**Configuration**タブで、次を設定します。

* **SCIM Base URL**をElevenLabsのSCIM Base URLに設定します。
* **SCIM Bearer token**をElevenLabsのBearerトークンに設定します。

#### API接続を有効にする

**Provisioning**に移動し、アプリの「Enable provisioning」をオンにします。