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

# Google SAML Einrichtung

> Ermögliche es deinen Nutzern, sich mit ihrem Google-Konten über SAML 2.0 bei Langdock anzumelden.

## Überblick

Diese Anleitung führt dich durch die Konfiguration von SAML Single Sign-On mit Google Workspace. Du erstellst eine benutzerdefinierte SAML-App in deiner Google Admin-Konsole, konfigurierst die Authentifizierungseinstellungen und stellst eine sichere Verbindung zwischen deinem Identity Provider und Langdock her.

Nach Abschluss können sich deine Nutzer mit ihren Google Workspace-Anmeldedaten bei Langdock anmelden.

## Setup Checkliste

Stelle sicher, dass du diese Schritte aus der [Setup Checkliste](/de/admin/security/saml/saml#setup-checkliste) abgeschlossen hast:

<Warning>
  * Du hast Zugriff auf ein Administratorkonto in deinem Langdock Workspace
  * "Beitritt per Domain" ist in deinen Langdock Sicherheitseinstellungen aktiviert
  * Deine Domain ist in deinen Langdock Sicherheitseinstellungen hinzugefügt und verifiziert
  * Du hast ein Google Workspace Admin-Konto mit der Berechtigung, Apps zu erstellen und zu verwalten
</Warning>

## Erstellen einer neuen benutzerdefinierten SAML-App

Zunächst musst du eine neue benutzerdefinierte SAML-App in deiner Google Workspace Admin-Konsole erstellen. <br />
Folge dazu diesen Schritten:

1. Navigiere in deiner Admin-Konsole zum Menü und dann zu "Apps" und dann zu "Web and mobile apps".

2. Erstelle eine neue benutzerdefinierte SAML-Anwendung, indem du auf "Add app" und "Add custom SAML app" klickst.

3. Benenne deine Anwendung (z.B. "Langdock") und lade optional ein Symbol hoch.

4. Klicke auf Continue.

<img src="https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-1.png?fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=0cd05d7f100e6f0c1f59d332d6a52277" alt="Navigiere zu Apps > Web- und mobile Apps in deinem Google Admin Center" data-og-width="3024" width="3024" data-og-height="1260" height="1260" data-path="images/google-1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-1.png?w=280&fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=905a271e99d345fcfdbac4407bf7e181 280w, https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-1.png?w=560&fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=12e048a92bf20f35a2de0a3a2982f156 560w, https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-1.png?w=840&fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=30070fc5a2749352b328891263c5fad8 840w, https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-1.png?w=1100&fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=fbda44172a05faec34de6233f92ee4c9 1100w, https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-1.png?w=1650&fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=9f7277c86464bc8a26b45ca22ccfb5b4 1650w, https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-1.png?w=2500&fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=c58b2784ffd0641902759a36069482a9 2500w" />

<img src="https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-2.png?fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=0391876d734f3b37d648f83f9488f1cd" alt="Klicke auf &#x22;App hinzufügen&#x22; und wähle die Option &#x22;Benutzerdefinierte SAML-App hinzufügen&#x22;" width="3024" height="1094" data-path="images/google-2.png" />

<img src="https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-3.png?fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=5fe1464f0ad5cf536142cae6f2808eca" alt="Gib der App einen Namen (Langdock) und füge ein Icon und eine Beschreibung hinzu, wenn du möchtest" width="3024" height="1890" data-path="images/google-3.png" />

## SAML-Konfiguration

Langdock verwendet SAML 2.0 als Standard für die SSO-Authentifizierung. Nach dem Erstellen der Anwendung musst du die SAML-Einstellungen konfigurieren, die es Langdock ermöglichen, Nutzer über SAML zu authentifizieren.

Zunächst musst du Konfigurationswerte aus der Google Workspace Admin-Konsole nach Langdock kopieren.
Navigiere in Langdock zu den [Security settings](https://app.langdock.com/settings/workspace/security) und fülle die folgenden Felder aus:

1. "Audience URI": Setze dies auf eine eindeutige Kennung für deine SAML-App (z.B. `langdock.com`)
2. "Issuer": Verwende denselben Wert wie die Audience URI (z.B. `langdock.com`)
3. "Sign on URL": Der "SSO URL"-Wert aus der Google Workspace Admin-Konsole (z.B. `https://accounts.google.com/o/saml2/idp?idpid=XXXXXXXXX`)
4. "Certificate": Der "Certificate"-Wert aus der Google Workspace Admin-Konsole. Kopiere das gesamte Zertifikat, sodass Anfang und Ende mit dem folgenden Beispiel übereinstimmen:

```
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
```

<img src="https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-4.png?fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=e0a7f7acf4c007668fac2af9df4cce58" alt="Google Workspace Admin-Konsole zeigt SSO-URL und Zertifikat" width="3024" height="1890" data-path="images/google-4.png" />

<img src="https://mintcdn.com/langdock-34/yFkcGlsUCYIpoHgV/images/google-5.png?fit=max&auto=format&n=yFkcGlsUCYIpoHgV&q=85&s=bfd7482bef74ba754f6aaf583642b204" alt="Langdock Sicherheitseinstellungen mit SAML-Konfigurationsfeldern" width="3024" height="1890" data-path="images/google-5.png" />

Sobald alle vier Felder ausgefüllt sind, aktiviere den **"SAML Active"**-Schalter.

Jetzt kannst du in der Google Workspace Admin-Konsole auf "Continue" klicken, um mit der SAML-Konfiguration fortzufahren.

Im Abschnitt "Service provider details" musst du die folgenden Werte eingeben:

1. "ACS URL": Der "Assertion Consumer Service (ACS) URL"-Wert aus Langdock
2. "Entity ID": Der gleiche Wert wie die "Audience URI" / "Issuer" (z.B. `langdock.com`)
3. "Signed response": Stelle sicher, dass dies aktiviert ist

Du kannst die anderen Felder leer lassen oder mit ihren Standardwerten belassen ("Name ID format": `UNSPECIFIED` und "Name ID": `Basic Information > Primary email`). Die benutzerdefinierte Google Workspace SAML App hat kein Feld zum Hochladen des Langdock SP-Zertifikats. Wenn du in Langdock **SAML-Anfragen signieren** aktivierst, behalte diese Felder wie hier angegeben bei und teste den Login aus Langdock. Klicke auf "Continue", um fortzufahren.

<img src="https://mintcdn.com/langdock-34/yFkcGlsUCYIpoHgV/images/google-6.png?fit=max&auto=format&n=yFkcGlsUCYIpoHgV&q=85&s=41c78d4659247e0506cdb1fdaa91dbde" alt="Service Provider Details-Formular mit ACS URL und Entity ID" width="3024" height="1890" data-path="images/google-6.png" />

Im Abschnitt "Attribute mapping" kannst du die Standardwerte beibehalten oder bei Bedarf zusätzliche Attribute zuordnen. Klicke auf "Finish", um die SAML-Konfiguration abzuschließen.

<img src="https://mintcdn.com/langdock-34/yFkcGlsUCYIpoHgV/images/google-7.png?fit=max&auto=format&n=yFkcGlsUCYIpoHgV&q=85&s=e9c142d213c07dc7b77e015935b96c46" alt="Attribute Mapping-Bildschirm in Google Workspace" width="3024" height="1614" data-path="images/google-7.png" />

Stelle sicher, dass du die Anwendung den Nutzern oder Gruppen in deinem Google Workspace-Konto zuweist, die Zugriff auf Langdock haben sollen.

<img src="https://mintcdn.com/langdock-34/yFkcGlsUCYIpoHgV/images/google-8.png?fit=max&auto=format&n=yFkcGlsUCYIpoHgV&q=85&s=21dd60f67cd4007ecaae1079e91ddb7a" alt="Nutzer-Zuweisungsbildschirm in Google Workspace" width="3024" height="1370" data-path="images/google-8.png" />

## Testen der SAML-Einrichtung

Um die SAML-Einrichtung zu testen, öffne einen separaten Browser oder ein Inkognito-Fenster und navigiere zu [https://app.langdock.com](https://app.langdock.com). <br />
Gib eine E-Mail-Adresse eines Nutzers in deinem Google Workspace-Konto ein und klicke auf "Continue". <br />
Du wirst zur Google-Anmeldeseite weitergeleitet, wo du deine Anmeldedaten eingeben kannst. <br />
Nach erfolgreicher Authentifizierung wirst du zu Langdock zurückgeleitet und angemeldet.

<img src="https://mintcdn.com/langdock-34/yFkcGlsUCYIpoHgV/images/google-9.png?fit=max&auto=format&n=yFkcGlsUCYIpoHgV&q=85&s=bdaaa98520f15af4cee784a822b02098" alt="Langdock-Anmeldeseite mit E-Mail-Eingabefeld" width="3024" height="1816" data-path="images/google-9.png" />

<img src="https://mintcdn.com/langdock-34/n3Mlc6DLTZAKfh4q/images/google-10.png?fit=max&auto=format&n=n3Mlc6DLTZAKfh4q&q=85&s=c572680d60d0dc1c391a87c2006a6a3d" alt="Google-Anmeldeseite für SAML-Authentifizierung" width="3024" height="1814" data-path="images/google-10.png" />

## Fehlerbehebung

Wenn du während der Einrichtung auf Probleme stößt, wende dich bitte an [support@langdock.com](mailto:support@langdock.com) für Unterstützung.