> For the complete documentation index, see [llms.txt](https://help.laiout.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.laiout.co/german/organisationseinstellungen/single-sign-on.md).

# Single Sign-On (SSO)

Mit Single Sign-On kann sich Ihr Team bei laiout mit dem Identitätsanbieter Ihres Unternehmens anmelden (z. B. Okta, Microsoft Entra oder Google). So müssen Sie kein separates Passwort verwalten.

## Erste Schritte

<details>

<summary>Was ist Single Sign-On in laiout?</summary>

Mit Single Sign-On kann sich Ihr Team bei laiout über den Identitätsanbieter Ihres Unternehmens anmelden, zum Beispiel Okta, Microsoft Entra oder Google. Ein separates Passwort ist nicht erforderlich.

</details>

<details>

<summary>Was benötige ich, um SSO einzurichten?</summary>

Sie benötigen Admin- oder Manager-Zugriff auf Ihre Organisation in laiout, Admin-Zugriff auf Ihren Identitätsanbieter (oder Unterstützung durch Ihr IT-Team), Zugriff auf die DNS-Einstellungen Ihrer Domain (oder Unterstützung durch die zuständige Person) und etwa 10 Minuten – zuzüglich der Zeit, die Ihr DNS-Anbieter benötigt, um eine Änderung zu veröffentlichen.

</details>

<details>

<summary>Wo finde ich die SSO-Einstellungen?</summary>

Öffnen Sie Ihre Organisation in laiout und klicken Sie in der linken Seitenleiste auf den Avatar Ihrer Organisation, um das Organisationsfenster zu öffnen. Klicken Sie dann unten auf Ihr Benutzermenü und wählen Sie Single Sign On (SSO).

</details>

## Die App bei Ihrem Identitätsanbieter erstellen

<details>

<summary>Wie erstelle ich eine laiout-App bei meinem Identitätsanbieter?</summary>

Erstellen Sie bei Ihrem Identitätsanbieter eine neue App für laiout und folgen Sie dann dem Abschnitt zum verwendeten Protokoll (SAML oder OIDC). Die benötigten Werte werden auch oben im SSO-Fenster in laiout angezeigt. laiout ordnet Personen anhand ihrer E-Mail-Adresse zu. Deshalb muss die App beim Anmelden die E-Mail-Adresse der Person übermitteln. Anmeldungen ohne E-Mail-Adresse werden abgelehnt. Weisen Sie nach dem Erstellen der App den Personen Zugriff auf laiout zu, die ihn benötigen.

</details>

<details>

<summary>Welche Werte verwende ich für einen SAML-Identitätsanbieter?</summary>

Erstellen Sie die App mit den folgenden Werten:

| Ihr IdP fragt nach     | Wert                                |
| ---------------------- | ----------------------------------- |
| ACS- / Antwort-URL     | <https://laiout.app/api/oauth/saml> |
| Zielgruppe / Entity-ID | <https://saml.laiout.co>            |

Fügen Sie anschließend ein Attribut hinzu, damit die App die E-Mail-Adresse der Person übermittelt. Ihr Identitätsanbieter bezeichnet dies möglicherweise als Attributanweisung, Attributzuordnung oder Claim:

| Attributname | Wert                          |
| ------------ | ----------------------------- |
| email        | Die E-Mail-Adresse der Person |

Alternativ können Sie das Name-ID-Format der App auf EmailAddress setzen, falls das einfacher ist. Optional können Sie auch die Attribute firstName und lastName hinzufügen.

</details>

<details>

<summary>Welche Werte verwende ich für einen OpenID-Connect-Identitätsanbieter (OIDC)?</summary>

Erstellen Sie die App mit den folgenden Werten:

| Ihr IdP fragt nach | Wert                                |
| ------------------ | ----------------------------------- |
| Weiterleitungs-URL | <https://laiout.app/api/oauth/oidc> |

Die App muss eine vertrauliche Web-App sein und den standardmäßigen E-Mail-Claim zurückgeben.

</details>

## E-Mail-Domains verifizieren

<details>

<summary>Warum muss ich meine E-Mail-Domain verifizieren?</summary>

laiout leitet Personen erst dann an Ihren Identitätsanbieter weiter, wenn Sie nachgewiesen haben, dass Ihnen deren E-Mail-Domain gehört. Dazu fügen Sie einen DNS-Eintrag hinzu.

</details>

<details>

<summary>Wie verifiziere ich meine E-Mail-Domain?</summary>

1. Geben Sie im SSO-Fenster von laiout unter E-Mail-Domains die Domain Ihres Unternehmens ein (zum Beispiel acme.com) und klicken Sie auf Domain hinzufügen. Der Status lautet dann Ausstehend.
2. laiout zeigt einen TXT-Eintrag für die Domain an. Klicken Sie auf den Namen oder den Wert, um ihn zu kopieren.
   * **Typ:** TXT.
   * **Name:** \_laiout-verification.acme.com.
   * **Wert:** laiout-verification= gefolgt von Ihrem Code.
3. Fügen Sie den Eintrag bei Ihrem DNS-Anbieter hinzu. Einige Anbieter ergänzen den Namen automatisch um Ihre Domain. Dann müssen Sie möglicherweise nur \_laiout-verification eingeben.
4. Klicken Sie anschließend in laiout auf Verifizieren. Sobald der Status der Domain Verifiziert lautet, sind Sie fertig.

Lassen Sie den TXT-Eintrag auch nach der Verifizierung bestehen.

</details>

<details>

<summary>Bei der Verifizierung wird angezeigt, dass kein passender Eintrag gefunden wurde. Was nun?</summary>

Die Änderung ist wahrscheinlich noch nicht im Internet verfügbar. Warten Sie einige Minuten und versuchen Sie es erneut.

</details>

<details>

<summary>Muss ich jede Domain verifizieren, die mein Team verwendet?</summary>

Ja. Wiederholen Sie die Schritte für jede Domain, die Ihr Team verwendet, zum Beispiel auch für acme.co.uk. Subdomains wie eu.acme.com benötigen einen eigenen Eintrag.

</details>

<details>

<summary>Ich kann meine DNS-Einstellungen nicht bearbeiten. Kann laiout die Domain für mich verifizieren?</summary>

Ja. Klicken Sie neben der Domain auf DNS-Zugriff nicht möglich? laiout um Verifizierung bitten. Das laiout-Team prüft die Domain dann manuell.

</details>

## SSO in laiout verbinden

<details>

<summary>Wie verbinde ich SSO, nachdem die App erstellt und meine Domain verifiziert wurde?</summary>

Wähle im laiout-SSO-Fenster wieder dein Protokoll aus: SAML oder OIDC. Füge bei SAML die vollständige Metadaten-XML-Datei aus der gerade erstellten App ein. Gib bei OIDC die Issuer-URL, die Client-ID und das Client-Secret deiner App ein. Klicke abschließend auf Enable SSO. SSO ist sofort für alle mit einer E-Mail-Adresse in einer verifizierten Domain aktiv.

</details>

<details>

<summary>Meine SAML-Metadaten werden abgelehnt. Woran liegt das?</summary>

Füge die vollständige Metadatendatei ein, beginnend mit der Deklaration in der ersten Zeile. Metadaten ohne diese Deklaration werden abgelehnt.

</details>

<details>

<summary>Wie teste ich, ob SSO funktioniert?</summary>

Rufe die laiout-Anmeldeseite auf, klicke auf Single Sign On, gib deine geschäftliche E-Mail-Adresse ein und klicke auf Proceed. Du wirst zur Anmeldeseite deines Unternehmens weitergeleitet und nach der Anmeldung zurück zu laiout.

</details>

## SSO verwalten

<details>

<summary>Kann ich mein Team verpflichten, sich mit SSO anzumelden?</summary>

Ja. Sobald SSO funktioniert, kannst du im selben Fenster Require SSO on Login aktivieren. Teammitglieder müssen sich dann über SSO statt mit einem Passwort anmelden. Organisationsadmins und Manager behalten den Passwortzugriff als Rückfalloption.

</details>

<details>

<summary>Erhalten Personen durch SSO Zugriff auf meine Organisation?</summary>

Nein. SSO dient der Anmeldung, nicht der Zugriffsverwaltung. Teammitglieder müssen weiterhin zu deiner laiout-Organisation eingeladen werden, bevor sie sich anmelden können.

</details>

<details>

<summary>Was passiert mit Personen, deren Domain noch nicht verifiziert ist?</summary>

Nur verifizierte Domains werden an deinen Identitätsanbieter weitergeleitet. Personen mit einer Domain, deren Verifizierung noch aussteht, melden sich weiterhin wie gewohnt an.

</details>

<details>

<summary>Was passiert, wenn ich eine Domain entferne?</summary>

Wenn du eine Domain entfernst, werden ihre Nutzer sofort nicht mehr an deinen Identitätsanbieter weitergeleitet.

</details>

<details>

<summary>Kann ich mehrere SSO-Verbindungen pro Organisation einrichten?</summary>

Nein. Pro Organisation gibt es eine SSO-Verbindung. Wenn du erneut speicherst, wird die vorherige Einrichtung ersetzt.

</details>

<details>

<summary>Wie bearbeite ich meine SSO-Einrichtung, ohne alles erneut einzugeben?</summary>

Dein Client-Secret und deine Metadaten werden sicher gespeichert und nie wieder angezeigt. Lass diese Felder beim Bearbeiten leer, damit die aktuellen Werte erhalten bleiben.

</details>

<details>

<summary>Was passiert, wenn ich die SSO-Verbindung entferne?</summary>

Wenn du die Verbindung entfernst, wird SSO sofort deaktiviert. Die Anmeldung mit Passwort funktioniert weiterhin.

</details>

<details>

<summary>An wen kann ich mich wenden, wenn ich Hilfe bei der Einrichtung von SSO brauche?</summary>

Wende dich unter <support@laiout.co> an das laiout-Team. Wir helfen dir gerne bei der Einrichtung.

</details>
