> 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/zh/overview/administration/workspaces/sso)。大多数身份
  提供商要求先有现成的 SSO 应用集成，才能关联 SCIM 预配。

## 设置 SCIM

#### 打开 SCIM 设置

前往 **工作区设置** > **安全与 SSO** > **SCIM**。

#### 生成令牌

点击 **Generate Token**。立即复制 **Base URL** 和 **Bearer token**。

> **Warning**
>
> 令牌只会显示一次。如果丢失，必须生成新令牌，这会使之前的令牌失效，并断开当前配置的所有 IdP 预配。

#### 配置身份提供商

在 IdP 的 SCIM/Provisioning 配置中：

* 将 **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 token。

#### 测试并启用预配

点击 **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**。
* 将 ElevenLabs Bearer token 粘贴到 **Authorization** 字段。
* 点击 **Save**

#### OneLogin 设置

#### 打开应用设置

在 OneLogin Admin 中，打开 ElevenLabs 应用。

#### 在 Configuration 中添加 SCIM 凭据

在 **Configuration** 标签页中：

* 将 **SCIM Base URL** 设置为 ElevenLabs SCIM Base URL。
* 将 **SCIM Bearer token** 设置为 ElevenLabs Bearer token。

#### 启用 API 连接

前往 **Provisioning**，并勾选应用的“Enable provisioning”。