SSO (Enterprise)
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Was ist SSO?
Abschnitt mit dem Titel „Was ist SSO?“Single Sign-On (SSO) ermöglicht es Ihrem Team, sich über Ihren Unternehmens-Identity-Provider (IdP) bei Capgo anzumelden. Capgo nutzt SAML 2.0 via Supabase Auth. Wenn die E-Mail-Domain eines Nutzers mit einem aktiven SSO-Provider übereinstimmt, kann die Authentifizierung über Ihren IdP erfolgen und der Nutzer wird während des SSO-Callbacks in der Organisation bereitgestellt.
SSO ändert nichts an den Berechtigungen der Nutzer. Diese werden über Organisationsrollen. SSO ändert lediglich die Art der Authentifizierung.
Voraussetzungen
Abschnitt: „Voraussetzungen“Vor dem Start:
- Enterprise-Abo für die Capgo Organisation aktiv.
- Ein Identity Provider, der SAML 2.0 unterstützt und eine IdP- Metadata-URL (HTTPS).
- Möglichkeit, einen DNS TXT-Record für die E-Mail-Domain zu setzen (z. B.
company.comfür User, die sich anmelden alsuser@company.com). - Ein Capgo Organisationsmitglied mit Berechtigung zum Ändern der Organisationseinstellungen.
- Ein IdP-Admin IT- oder Security-Verantwortliche.
Wo du die SSO-Einstellungen findest
Abschnitt mit dem Titel „SSO-Einstellungen finden“- Öffne https://console.capgo.app/
- Klicken Einstellungen in der linken Seitenleiste
- Wähle die Organisation Tab
- Wähle die Sicherheit Tab
- Scrolle zu SSO-Konfiguration. Das Formular ist nur verfügbar, wenn die Organisation den Enterprise-Plan nutzt.
Schritt 1 – IdP konfigurieren
Abschnitt mit dem Titel „Schritt 1 – Konfiguriere deinen IdP“Erstelle in deinem Identity Provider eine neue SAML 2.0 Anwendung. Du benötigst folgende Service Provider Werte aus dem Capgo SSO-Konfigurationspanel:
| Feld | Einsatzbereiche |
|---|---|
| ACS-URL | Assertion Consumer Service URL in deiner IdP SAML-App |
| Entity-ID | Entity-ID des Service Providers |
| SP-Metadata-URL | Optional: Import, falls dein IdP den SP-Metadata-Import via URL unterstützt |
| NameID-Format | Erwartetes Format für den SAML Name Identifier |
Ihr IdP muss die Daten des Benutzers freigeben E-Mail-Adresse des Nutzers in der Assertion bereitstellen. Capgo nutzt die E-Mail-Domain, um den aktiven SSO-Provider zu ermitteln und bestehende Accounts abzugleichen.
Schritt 2 – SSO-Provider in Capgo hinzufügen
Abschnitt mit dem Titel „Schritt 2 – SSO-Provider in Capgo hinzufügen“- Klicken Sie im SSO-Konfigurationspanel, um einen neuen Provider hinzuzufügen
- Geben Sie die E-Mail-Domain (z. B.
company.com). Sie muss mit dem Domain-Teil der Anmelde-E-Mails Ihrer Nutzer übereinstimmen - Geben Sie Ihre IdP- Metadata-URL ein (HTTPS)
- Einreichen
Der Provider wurde mit dem Status erstellt Verifizierung ausstehend.
Schritt 3 – DNS-Domain-Verifizierung
Abschnitt mit dem Titel „Schritt 3 – DNS-Domain-Verifizierung“Capgo verifiziert die Domain-Inhaberschaft, bevor SSO aktiviert werden kann.
Füge einen TXT- Eintrag bei deinem DNS-Provider hinzu:
| Feld | Wert |
|---|---|
| Typ | TXT |
| Name / Host | _capgo-sso.<your-domain> (z. B. _capgo-sso.company.com) |
| Wert | Der im Dashboard-Panel angezeigte Verifizierungs-Token |
Sobald der Eintrag veröffentlicht wurde (die DNS-TTL-Propagierung dauert meist einige Minuten bis zu einer Stunde), klicke auf DNS verifizieren im Dashboard. Bei Erfolg wechselt der Provider auf Verifiziert.
Schritt 4 – Provider aktivieren
Abschnitt „Schritt 4 – Provider aktivieren“Nach der DNS-Verifizierung klicke auf Aktivieren. Der Provider-Status lautet nun Aktiv. Nur Aktiv Provider werden während des SSO-Login-Flows verwendet.
Du kannst wählen Deaktivieren jederzeit im Dashboard auswählen. Dadurch wird der Provider nach Deaktiviertverschoben, wodurch SSO für diese Domain pausiert wird, ohne die Konfiguration zu löschen.
Schritt 5 – Testen und Rollen zuweisen
Abschnitt mit dem Titel „Schritt 5 – Testen und Rollen zuweisen“Wenn sich ein Nutzer zum ersten Mal via SSO anmeldet und noch keine Mitgliedschaft in dieser Organisation hat, stellt Capgo ihm die read- Rolle.
Nachdem die Pilotnutzer sich angemeldet haben:
- Gehe zu Einstellungen → Organisation → Mitglieder
- Suchen Sie die per SSO bereitgestellten Nutzer
- Passen Sie deren Rolle auf die entsprechende Ebene an (Upload, Schreiben, Admin, etc.)
Siehe den vollständige Übersicht der Berechtigungen was die jeweilige Rolle tun kann.
Optional – SSO erzwingen
Abschnitt mit dem Titel „Optional – SSO erzwingen“Bei einem Aktiv Provider kannst du SSO erzwingen. Wenn aktiviert, markiert Capgo bestehende Auth-User für diese E-Mail-Domain als SSO-only, sodass der Login-Flow für diese Domain eine IdP-Authentifizierung erfordert. Den Provider auf Deaktiviert (Deaktivieren) oder das Deaktivieren der Erzwingung entfernt das SSO-only-Flag für die Domain.
Referenz zum Provider-Status
Abschnitt mit dem Titel „Provider status reference“| Status | Bedeutung |
|---|---|
| Verifizierung ausstehend | DNS TXT-Record noch nicht verifiziert |
| Verifiziert | Domain-Besitz bestätigt; bereit zur Aktivierung |
| Aktiv | SSO ist für diese Domain aktiv |
| Deaktiviert | Festgelegt von Deaktivieren im Dashboard; SSO wird für diese Domain nicht genutzt; verwende Erneut aktivieren um zurückzukehren zu Aktiv |
Rollout-Checkliste
Abschnitt mit dem Titel „Rollout-Checkliste“- Enterprise-Plan bestätigt
- SAML-App im IdP mit ACS-URL und Entity ID von Capgo erstellt
- IdP für die Bereitstellung eines stabilen Email-Claims konfiguriert
- DNS-TXT-Record veröffentlicht und DNS verifizieren erfolgreich
- Provider aktiviert
- Pilot-User erfolgreich angemeldet
- Rollen über Standard hinaus angehoben read- wie benötigt
- Enforcement-Entscheidung getroffen (und kommuniziert, falls aktiviert)
Verwandte Dokumentation
Abschnitt mit dem Titel „Verwandte Dokumentation“Weiter mit SSO (Enterprise)
Abschnitt mit dem Titel „Weiter mit SSO (Enterprise)“Wenn du es nutzt SSO (Enterprise) Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login, @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric, Zwei-Faktor-Authentifizierung für die Implementierungsdetails zur Zwei-Faktor-Authentifizierung, und OAuth2 in Capacitor Apps in 5 Schritten umsetzen für den praktischen Kontext in: 5 Schritte zur Implementierung von OAuth2 in Capacitor Apps.