> 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

## Überblick

> **Info**
>
> SCIM ist für **Enterprise**-Workspaces verfügbar. Nur **Workspace-Admins** können diese
> Einstellungen konfigurieren.

## Voraussetzungen

* Ein Enterprise-Workspace von ElevenLabs.
* Workspace-Adminzugriff in ElevenLabs.
* Für Ihren Workspace [konfiguriertes SSO](/docs/de/overview/administration/workspaces/sso). Die meisten Identity
  Provider benötigen eine bestehende SSO-App-Integration, um SCIM-Provisioning daran anzubinden.

## SCIM einrichten

#### SCIM-Einstellungen öffnen

Gehen Sie zu **Workspace settings** > **Security & SSO** > **SCIM**.

#### Token generieren

Klicken Sie auf **Generate Token**. Kopieren Sie **Base URL** und **Bearer token** sofort.

> **Warning**
>
> Das Token wird nur einmal angezeigt. Wenn Sie es verlieren, müssen Sie ein neues generieren. Dadurch wird
> das vorherige Token ungültig und jedes aktuell konfigurierte IdP-Provisioning getrennt.

#### Identity Provider konfigurieren

In der SCIM-/Provisioning-Konfiguration Ihres IdP:

* Setzen Sie die **SCIM Endpoint/Connector URL** auf die aus ElevenLabs kopierte Base URL.
* Setzen Sie den Authentifizierungsmodus auf **HTTP Bearer Token** und fügen Sie Ihr Token ein.

Anbieterspezifische Anleitungen finden Sie unter [Einrichtung nach Identity Provider](#setup-by-identity-provider).

> **Note**
>
> Wenn ein Nutzer in Ihrem IdP entfernt oder deaktiviert wird, wird dessen Workspace-Zugriff auf ElevenLabs widerrufen.
> Die bisherige Aktivität im Workspace bleibt erhalten.

## Funktionen

ElevenLabs unterstützt das SCIM-2.0-Protokoll mit den folgenden Funktionen:

| Funktion                                                     | Unterstützt? | Details                                                         |
| :----------------------------------------------------------- | :----------- | :-------------------------------------------------------------- |
| **Discovery-Endpunkte**                                      | ✅ Ja         | `/ServiceProviderConfig`, `/Schemas`, `/ResourceTypes`          |
| **Nutzer**                                                   | ✅ Ja         | `GET`, `POST`, `PUT`, `PATCH`, `DELETE`                         |
| **Aktualisierung der primären E-Mail-Adresse eines Nutzers** | ❌ Nein       |                                                                 |
| **Gruppen**                                                  | ✅ Ja         | `GET`, `POST`, `PUT`, `PATCH`, `DELETE`                         |
| **Suche**                                                    | ✅ Ja         | `GET` mit `?filter` oder `POST` an `/.search`                   |
| **Seitennummerierung**                                       | ✅ Ja         | Unterstützt `startIndex` und `count`                            |
| **Bulk-Operationen**                                         | ✅ Ja         | `Max. Operationen pro Anfrage: 100`, `Max. Payload-Größe: 1 MB` |
| **Attributfilterung**                                        | ✅ Ja         | Unterstützt `attributes` und `excludedAttributes`               |
| **Sortierung**                                               | ❌ Nein       | `sortBy` und `sortOrder` werden bei Abfragen ignoriert          |

## Unterstützte Attribute

* **Nutzer**: `userName`, `name`, `emails`, `active`, `externalId`
* **Gruppen**: `displayName`, `members`, `externalId`

> **Warning**
>
> Änderungen von E-Mail-Adressen werden über SCIM nicht unterstützt. Das Aktualisieren der primären E-Mail-Adresse eines Nutzers in Ihrem IdP
> kann für diesen Nutzer zu SCIM-Synchronisierungsfehlern führen.

## Einrichtung nach Identity Provider

#### Einrichtung von Microsoft Entra ID

#### Provisioning-Einstellungen öffnen

Wählen Sie im Microsoft Entra Admin Center Ihre
ElevenLabs-App aus und öffnen Sie anschließend **Provisioning**.

#### Provisioning-Modus festlegen

Setzen Sie **Provisioning Mode** auf **Automatic**.

#### SCIM-Anmeldedaten hinzufügen

Unter **Admin Credentials**:

* Setzen Sie **Tenant URL** auf Ihre ElevenLabs-SCIM-Base-URL.
* Setzen Sie **Secret Token** auf Ihr ElevenLabs-Bearer-Token.

#### Provisioning testen und aktivieren

Klicken Sie auf **Test Connection**, speichern Sie die Konfiguration und setzen Sie anschließend **Provisioning Status** auf
**On**, wenn alles bereit ist.

#### Okta-Einrichtung

#### Benutzerdefinierte App-Integration erstellen oder öffnen

Öffnen Sie die ElevenLabs-App, die für die SSO-Anmeldung verwendet wird, und gehen Sie zu **General**.

#### SCIM in der App aktivieren

Klicken Sie unter **App Settings** auf **Edit** und setzen Sie anschließend **Provisioning** auf **SCIM**.

#### SCIM-Verbindung konfigurieren

Unter **Provisioning** > **Settings** > **Integration**:

* Setzen Sie die **SCIM connector base URL** auf Ihre ElevenLabs-SCIM-Base-URL.
* Wählen Sie die Provisioning-Aktionen, die Ihr Workspace benötigt (z. B. neue Nutzer übertragen,
  Profilaktualisierungen übertragen und Gruppen übertragen), führen Sie dann **Test Connector Configuration** aus und speichern Sie.
* Setzen Sie **Authentication Mode** auf **HTTP Header**.
* Fügen Sie Ihr ElevenLabs-Bearer-Token in das Feld **Authorization** ein.
* Klicken Sie auf **Save**

#### OneLogin-Einrichtung

#### App-Einstellungen öffnen

Öffnen Sie in OneLogin Admin Ihre ElevenLabs-App.

#### SCIM-Anmeldedaten in Configuration hinzufügen

Im Tab **Configuration**:

* Setzen Sie **SCIM Base URL** auf Ihre ElevenLabs-SCIM-Base-URL.
* Setzen Sie **SCIM Bearer token** auf Ihr ElevenLabs-Bearer-Token.

#### API-Verbindung aktivieren

Gehen Sie zu **Provisioning** und aktivieren Sie für die App „Enable provisioning“.