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

# SCIM-Bereitstellung

> Automatisieren Sie die Verwaltung des Benutzer- und Gruppenlebenszyklus mit SCIM 2.0.

Truthlocks unterstützt SCIM 2.0 für die automatisierte Benutzerbereitstellung und Gruppenverwaltung. Verbinden Sie Ihren Identitätsanbieter (Okta, Azure AD, OneLogin usw.), um Benutzer in Ihrem Truthlocks-Mandanten automatisch zu erstellen, zu aktualisieren und zu deaktivieren.

> [!NOTE]
>
> SCIM-Bereitstellung ist im **Business**-Plan und höher verfügbar.

## Funktionsweise

**1. SCIM-Token generieren**

Gehen Sie in der Konsole zu **Einstellungen > SCIM** und generieren Sie ein Bearer-Token.
Dieses Token authentifiziert die SCIM-Anfragen Ihres IdP.

**2. Konfigurieren Sie Ihren IdP**

Legen Sie in Ihrem Identitätsanbieter die SCIM-Basis-URL fest auf
`https://api.truthlocks.com/scim/v2` und fügen Sie den Bearer-Token ein.

**3. Benutzer und Gruppen synchronisieren**

Ihr IdP überträgt Benutzererstellungen, -aktualisierungen und -deaktivierungen an Truthlocks
automatisch. Änderungen der Gruppenzugehörigkeit aktualisieren die Rollenzuweisungen.

## SCIM-Basis-URL

```text theme={null}
https://api.truthlocks.com/scim/v2
```

Alle SCIM-Anfragen müssen das Bearer-Token im `Authorization`-Header enthalten:

```bash theme={null}
curl -X GET https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here"
```

## Unterstützte Operationen

### Benutzer

| Operation | Methode | Pfad | Beschreibung |
| - | - | - | - |
| Liste | GET | `/scim/v2/Users` | Benutzer mit optionalem Filter auflisten |
| Erstellen | POST | `/scim/v2/Users` | Einen neuen Benutzer bereitstellen |
| Abrufen | GET | `/scim/v2/Users/{id}` | Einen Benutzer nach SCIM-ID abrufen |
| Ersetzen | PUT | `/scim/v2/Users/{id}` | Vollständiger Benutzerersatz |
| Patch | PATCH | `/scim/v2/Users/{id}` | Teilweise Aktualisierung (z. B. Deaktivierung) |
| Löschen | DELETE | `/scim/v2/Users/{id}` | Benutzer sperren |

### Gruppen

| Operation | Methode | Pfad | Beschreibung |
| - | - | - | - |
| Liste | GET | `/scim/v2/Groups` | Gruppen auflisten |
| Erstellen | POST | `/scim/v2/Groups` | Eine Gruppen-Zuordnung erstellen |
| Abrufen | GET | `/scim/v2/Groups/{id}` | Eine Gruppe nach SCIM-ID abrufen |
| Ersetzen | PUT | `/scim/v2/Groups/{id}` | Gruppe ersetzen (ordnet Rollenbindungen neu zu) |
| Patch | PATCH | `/scim/v2/Groups/{id}` | Mitglieder hinzufügen oder entfernen |
| Löschen | DELETE | `/scim/v2/Groups/{id}` | Gruppen-Zuordnung löschen |

### Entdeckung

| Methode | Pfad | Beschreibung |
| - | - | - |
| GET | `/scim/v2/ServiceProviderConfig` | Unterstützte Funktionen |
| GET | `/scim/v2/Schemas` | Ressourcenschemata |
| GET | `/scim/v2/ResourceTypes` | Verfügbare Ressourcentypen |

## Einen Benutzer erstellen

```bash theme={null}
curl -X POST https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "jane@example.com",
    "name": { "givenName": "Jane", "familyName": "Smith" },
    "emails": [{ "value": "jane@example.com", "primary": true }],
    "active": true
  }'
```

## Einen Benutzer deaktivieren

IdPs wie Okta und Azure AD senden eine PATCH-Anfrage, um Benutzer zu deaktivieren:

```bash theme={null}
curl -X PATCH https://api.truthlocks.com/scim/v2/Users/{id} \
  -H "Authorization: Bearer scim_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
    "Operations": [{ "op": "replace", "path": "active", "value": false }]
  }'
```

Deaktivierte Benutzer verlieren sofort den Zugriff, ihre Daten bleiben jedoch erhalten.

## SCIM-Token verwalten

Tokens über die Management-API generieren und verwalten:

```bash theme={null}
# Generate a new token
curl -X POST https://api.truthlocks.com/v1/scim/tokens \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{ "label": "Okta SCIM" }'

# List tokens
curl -X GET https://api.truthlocks.com/v1/scim/tokens \
  -H "Authorization: Bearer <admin_token>"

# Revoke a token
curl -X DELETE https://api.truthlocks.com/v1/scim/tokens/<token_id> \
  -H "Authorization: Bearer <admin_token>"
```

## Aktivitätsprotokoll

Alle SCIM-Operationen werden in einem Aktivitätsprotokoll aufgezeichnet. Zeigen Sie die letzten Bereitstellungsereignisse an:

```bash theme={null}
curl -X GET https://api.truthlocks.com/v1/scim/activity \
  -H "Authorization: Bearer <admin_token>"
```

Aktivitätstypen umfassen `USER_CREATED`, `USER_DEACTIVATED`, `USER_PATCHED`, `GROUP_CREATED`, `GROUP_UPDATED` und `GROUP_DELETED`.

## Sitzplatzdurchsetzung

Die Benutzererstellung berücksichtigt das Sitzplatzlimit Ihres Plans. Wenn das Limit überschritten würde, gibt der SCIM-Endpunkt HTTP `402` zurück und der Benutzer wird nicht erstellt. Aktualisieren Sie Ihren Plan oder entfernen Sie inaktive Benutzer, um Plätze freizugeben.

## Filterung

Der SCIM `filter` Abfrageparameter ermöglicht es Ihrem Identitätsanbieter, Listenantworten auf bestimmte Benutzer oder Gruppen einzugrenzen. Truthlocks unterstützt das Filtern nach spezifischen SCIM-Attributen unter Verwendung der untenstehenden Operatoren.

### Unterstützte Filterattribute

| Attribut | Ressource | Beschreibung |
| - | - | - |
| `userName` | Benutzer | Die Anmelde-ID des Benutzers (normalerweise eine E-Mail-Adresse) |
| `displayName` | Benutzer, Gruppen | Der Anzeigename des Benutzers oder der Gruppe |
| `externalId` | Benutzer, Gruppen | Die eindeutige Kennung, die von Ihrem Identitätsanbieter zugewiesen wurde |
| `active` | Benutzer | Ob das Benutzerkonto aktiv ist (`true` / `false`) |

### Unterstützte Operatoren

| Operator | Bedeutung | Beispiel |
| - | - | - |
| `eq` | Gleich | `userName eq "jane@example.com"` |
| `ne` | Ungleich | `active ne false` |
| `co` | Enthält | `userName co "example.com"` |
| `sw` | Beginnt mit | `userName sw "jane"` |
| `ew` | Endet mit | `userName ew "@example.com"` |

Kombinieren Sie Operatoren mit `and` / `or` für komplexe Abfragen:

```bash theme={null}
# Find active users whose username contains "example.com"
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=active eq true and userName co "example.com"'

# Find users starting with "jane" or "john"
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=userName sw "jane" or userName sw "john"'

# Look up a user by their IdP-assigned external ID
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=externalId eq "00u1a2b3c4d5e6f7g8h9"'

# Find a user by display name
curl -G https://api.truthlocks.com/scim/v2/Users \
  -H "Authorization: Bearer scim_your_token_here" \
  --data-urlencode 'filter=displayName eq "Jane Smith"'
```

> [!NOTE]
>
> Gefilterte Ergebnisse sind auf 200 Elemente pro Antwort begrenzt. Wenn Ihr IdP mehr als 200 Benutzer oder Gruppen synchronisiert, sollte er die Paginierung mithilfe der Parameter `startIndex` und `count` zusammen mit dem Filter vornehmen.

### Gängige IdP-Filtermuster

Die meisten Identitätsanbieter senden Filter automatisch während der Synchronisierung. Hier sind die Muster, die Truthlocks verarbeitet:

| IdP | Typischerweise gesendeter Filter |
| - | - |
| Okta | `userName eq "user@example.com"` |
| Azure AD | `userName eq "user@example.com"`, `displayName co "Smith"` oder `externalId eq "id"` |
| OneLogin | `userName sw "user"` oder `externalId eq "id"` |

Wenn Ihr IdP einen Filter mit einem der oben aufgeführten unterstützten Attribute und Operatoren sendet, verarbeitet Truthlocks ihn korrekt. Sie müssen auf der Truthlocks-Seite nichts konfigurieren.

## Unterstützte Funktionen

| Fähigkeit | Unterstützt |
| - | - |
| Patch | Ja |
| Bulk | Nein |
| Filter | Ja — `eq`, `ne`, `co`, `sw`, `ew` auf `userName`, `displayName`, `externalId`, `active` mit `and` / `or` (max. 200 Ergebnisse) |
| Sortieren | Nein |
| Passwort ändern | Nein |
| ETag | Nein |

## Verwandt

* [SAML SSO](https://docs.truthlocks.com/de/security/saml-sso.md) – Authentifizieren Sie Benutzer über Ihren IdP.
* [RBAC & Berechtigungen](https://docs.truthlocks.com/de/security/rbac.md) – Rollen, die bereitgestellten Benutzern zugewiesen sind.
* [Audit-Protokolle](https://docs.truthlocks.com/de/security/audit.md) – Verfolgen Sie alle Zugriffs- und Bereitstellungsereignisse.


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