> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/de/administration/authentification-sso.md).

# Authentifizierungsmethoden und Single Sign-On (SSO)

### Authentifizierungsmethoden

Steeple bietet zwei Authentifizierungsmethoden an:

* **E-Mail + Passwort** : Standardmethode, jeder Mitarbeitende meldet sich mit seinen Steeple-Zugangsdaten an
* **Single Sign-On (SSO)** : Anmeldung über einen Unternehmens-Identitätsanbieter (Azure AD, Okta, Google Workspace)

### Was ist SSO?

SSO (Single Sign-On) ermöglicht es Mitarbeitenden, sich mit ihren vorhandenen Unternehmenszugangsdaten bei Steeple anzumelden, ohne ein separates Konto zu erstellen.

#### Vorteile

* Zentralisierte Zugriffsverwaltung
* Keine doppelten Konten
* Sicherheit abgestimmt auf die Tools des Unternehmens
* Möglichkeit, die Benutzerbereitstellung zu automatisieren

#### Protokoll

Steeple implementiert SSO über **SAML V2.0**.

#### Wichtiger Hinweis

Steeple unterstützt **kein Single Logout (SLO)** : Sobald die Steeple-Sitzung hergestellt ist, ist sie unabhängig von der Sitzung des Identitätsanbieters und läuft gemäß ihrer eigenen Gültigkeitsdauer ab.

### Unterstützte Identitätsanbieter

* **Azure Active Directory** (Microsoft Entra ID)
* **Okta**
* **Google Workspace**

### SSO konfigurieren

Die Konfiguration erfolgt über **Administration** > **Integrationen** (`/administration/integrations`).

#### SSO mit Azure Active Directory

1. Eine Nicht-Galerie-Unternehmensanwendung in Azure erstellen (Identity > Applications > Enterprise Applications)
2. In Steeple: Administration > Integrationen > Installieren, den Namen des SSO-Buttons und die reservierten Domains konfigurieren
3. Die Steeple-Metadaten in die grundlegende SAML-Konfiguration von Azure kopieren
4. Die Benutzerattribute konfigurieren (email, first\_name, last\_name, provider\_identifier)
5. Die URL der Föderationsmetadaten aus Azure kopieren
6. In Steeple importieren, indem die URL eingefügt und auf "Metadaten importieren" geklickt wird
7. Benutzer und Gruppen in Azure zuweisen — auch der Administrator, der die Konfiguration vornimmt, muss zugewiesen sein

#### SSO mit Okta

1. Eine SAML-2.0-Integration in Okta erstellen (Applications > Create App Integration)
2. Die Steeple-URLs in Okta kopieren (von Administration > Integrationen > Okta SAML > Installieren)
3. Das Name-ID-Format auf **EmailAddress**
4. Die Attribute wie angegeben konfigurieren
5. Die URL der Metadaten aus dem Tab "Sign on" von Okta abrufen
6. In Steeple importieren

#### SSO mit Google Workspace

1. Eine benutzerdefinierte SAML-Anwendung in Google erstellen (Applications > Web und mobil > App hinzufügen)
2. Die XML-Metadatendatei von Google herunterladen
3. Die Steeple-Metadaten in Google Workspace und umgekehrt konfigurieren
4. Die Google-XML-Datei muss unter einer zugänglichen URL gehostet werden (eine sichere interne Hosting-Lösung verwenden, keinen öffentlichen Drittanbieter-Dienst), damit sie in Steeple importiert werden kann
5. Die Benutzerattribute konfigurieren

### Migration zu SSO

* **Gleiche E-Mail** im Unternehmensverzeichnis und in Steeple: nahtloser Übergang, das vorhandene Konto bleibt erhalten
* **Andere E-Mail** : Ein neues Konto wird erstellt — der Benutzer muss seine E-Mail-Adressen vor der Migration zusammenführen

### Mehr-Communitys-Architekturen (Eltern/Kind)

Für Organisationen mit Eltern/Kind-Communitys ist es möglich, Gruppen des Identitätsanbieters auf bestimmte Steeple-Communitys abzubilden. Die Konfiguration variiert je nach Anbieter:

* **Azure AD** : Gruppen-Claims mit der object\_id der Gruppe verwenden
* **Okta** : die Okta-Gruppen konfigurieren (Leerzeichen in den Namen durch Unterstriche ersetzen)
* **Google Workspace** : das Attribut sso\_group\_id hinzufügen

### Was der Assistent tun kann

Der Assistent kann den Benutzer zur Seite führen **Integrationen** über navigate\_to und die Authentifizierungskonzepte erklären. Für die detaillierte technische Konfiguration auf <https://help.steeple.com/> verweisen