> ## 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.

# SAML SSO

> Konfigurieren Sie SAML 2.0 Single Sign-On für Ihre Organisation.

Truthlocks unterstützt natives SAML 2.0 Single Sign-On, damit Ihr Team sich über Ihren bestehenden Identitätsanbieter (IdP) authentifizieren kann. Wenn SAML konfiguriert ist, werden Benutzer während des Logins automatisch zu Ihrem IdP weitergeleitet.

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

## Funktionsweise

**1. Konfigurieren Sie Ihren IdP**

Registrieren Sie Truthlocks als Dienstanbieter (SP) in Ihrem Identitätsanbieter.
Sie benötigen die SP-Entitäts-ID und die Assertion Consumer Service (ACS)-URL von der
Einrichtungsbildschirm.

**2. Verbindung in Truthlocks hinzufügen**

Gehen Sie in der Konsole zu **Einstellungen > SSO** und erstellen Sie eine neue SAML-Verbindung.
Geben Sie Ihre IdP-Metadaten-URL ein oder geben Sie die IdP-Entitäts-ID, die SSO-URL manuell an.
und Signaturzertifikat.

**3. Benutzer melden sich über IdP an**

Sobald aktiv, werden Benutzer, die die Konsolen-Anmeldeseite besuchen, zu Ihrem
IdP. Nach der Authentifizierung werden sie mit einer Sitzung zu Truthlocks zurückgeleitet.

## Details zum Dienstanbieter

Geben Sie diese Werte Ihrem IdP bei der Registrierung von Truthlocks an:

| Feld | Wert |
| - | - |
| SP Entitäts-ID | `urn:truthlocks:TENANT_ID` |
| ACS URL | `https://console.truthlocks.com/api/auth/saml/acs` |
| NameID-Format | `urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress` |
| Bindung | HTTP-POST |

## IdP-Konfigurationsfelder

Beim Erstellen einer SAML-Verbindung in der Konsole können Sie Ihren IdP auf zwei Arten konfigurieren:

### Option A: Metadaten-URL

Geben Sie Ihre IdP-Metadaten-URL an, und Truthlocks ruft automatisch die Entitäts-ID, die SSO-URL und das Signaturzertifikat ab.

### Option B: Manuelle Konfiguration

| Feld | Beschreibung |
| - | - |
| IdP-Entitäts-ID | Die eindeutige Kennung Ihres Identitätsanbieters |
| IdP SSO-URL | Die URL, an die Truthlocks SAML-Authentifizierungsanfragen sendet |
| IdP-Zertifikat | Das X.509-Signaturzertifikat Ihres IdP (PEM-Format) |

## Eine Verbindung über die API erstellen

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_type": "SAML",
    "idp_metadata_url": "https://idp.example.com/metadata",
    "role_mapping_mode": "GROUPS"
  }'
```

Wenn Sie eine manuelle Konfiguration bevorzugen, lassen Sie `idp_metadata_url` weg und geben Sie stattdessen `idp_entity_id`, `idp_sso_url` und `idp_certificate` an.

## Rollenzuordnung

Truthlocks ordnet IdP-Gruppenbehauptungen während der Anmeldung internen Rollen zu. Es stehen zwei Modi zur Verfügung:

| Modus | Verhalten |
| - | - |
| `STATIC` | Alle SAML-Benutzer erhalten eine feste Standardrolle (z.B. `viewer`) |
| `GROUPS` | IdP-Gruppennamen werden automatisch Truthlocks-Rollen (`admin`, `editor`, `auditor`) zugeordnet |

Legen Sie den Modus beim Erstellen oder Aktualisieren der SSO-Verbindung fest.

## Benutzerbereitstellung

Wenn sich ein Benutzer zum ersten Mal über SAML authentifiziert, erstellt Truthlocks automatisch sein Konto unter Verwendung von Attributen aus der SAML-Assertion (E-Mail, Vorname, Nachname). Dies wird als Just-in-Time (JIT)-Bereitstellung bezeichnet.

Für die Massensynchronisierung und -deprovisionierung von Benutzern verwenden Sie [SCIM-Bereitstellung](https://docs.truthlocks.com/de/security/scim.md).

## Sitzungsdetails

* Sitzungen dauern **12 Stunden** nach der SAML-Anmeldung.
* Sitzungscookies sind `HttpOnly` und `SameSite=Lax`.
* Bei der Validierung von SAML-Assertionen wird eine Toleranz von 2 Minuten für die Zeitverschiebung angewendet.

## Eine Verbindung testen

Nachdem Sie eine SAML-Verbindung erstellt haben, testen Sie diese, bevor Sie sie für alle Benutzer aktivieren:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/test \
  -H "Authorization: Bearer <admin_token>"
```

Dies bestätigt, dass Truthlocks Ihren IdP erreichen und die Metadaten korrekt parsen kann.

## SSO deaktivieren

Zurück zur Standard-E-Mail-/Passwort-Authentifizierung:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/disable \
  -H "Authorization: Bearer <admin_token>"
```

## Verwandt

* [SCIM-Bereitstellung](https://docs.truthlocks.com/de/security/scim.md) – Automatisieren Sie die Benutzer- und Gruppensynchronisierung von Ihrem IdP.
* [RBAC & Berechtigungen](https://docs.truthlocks.com/de/security/rbac.md) – Verstehen Sie die Rollen, denen SAML-Benutzer zugeordnet sind.
* [Authentifizierung](https://docs.truthlocks.com/de/security/auth.md) – API-Schlüssel- und JWT-Authentifizierungsmethoden.


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