Zum Inhalt springen

SSO (Enterprise)

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.

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.com für User, die sich anmelden als user@company.com).
  • Ein Capgo Organisationsmitglied mit Berechtigung zum Ändern der Organisationseinstellungen.
  • Ein IdP-Admin IT- oder Security-Verantwortliche.
  1. Öffne https://console.capgo.app/
  2. Klicken Einstellungen in der linken Seitenleiste
  3. Wähle die Organisation Tab
  4. Wähle die Sicherheit Tab
  5. Scrolle zu SSO-Konfiguration. Das Formular ist nur verfügbar, wenn die Organisation den Enterprise-Plan nutzt.

Erstelle in deinem Identity Provider eine neue SAML 2.0 Anwendung. Du benötigst folgende Service Provider Werte aus dem Capgo SSO-Konfigurationspanel:

FeldEinsatzbereiche
ACS-URLAssertion Consumer Service URL in deiner IdP SAML-App
Entity-IDEntity-ID des Service Providers
SP-Metadata-URLOptional: Import, falls dein IdP den SP-Metadata-Import via URL unterstützt
NameID-FormatErwartetes 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.

  1. Klicken Sie im SSO-Konfigurationspanel, um einen neuen Provider hinzuzufügen
  2. Geben Sie die E-Mail-Domain (z. B. company.com). Sie muss mit dem Domain-Teil der Anmelde-E-Mails Ihrer Nutzer übereinstimmen
  3. Geben Sie Ihre IdP- Metadata-URL ein (HTTPS)
  4. Einreichen

Der Provider wurde mit dem Status erstellt Verifizierung ausstehend.

Capgo verifiziert die Domain-Inhaberschaft, bevor SSO aktiviert werden kann.

Füge einen TXT- Eintrag bei deinem DNS-Provider hinzu:

FeldWert
TypTXT
Name / Host_capgo-sso.<your-domain> (z. B. _capgo-sso.company.com)
WertDer 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.

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:

  1. Gehe zu Einstellungen → Organisation → Mitglieder
  2. Suchen Sie die per SSO bereitgestellten Nutzer
  3. 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.

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.

StatusBedeutung
Verifizierung ausstehendDNS TXT-Record noch nicht verifiziert
VerifiziertDomain-Besitz bestätigt; bereit zur Aktivierung
AktivSSO ist für diese Domain aktiv
DeaktiviertFestgelegt von Deaktivieren im Dashboard; SSO wird für diese Domain nicht genutzt; verwende Erneut aktivieren um zurückzukehren zu Aktiv
  • 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)

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.