- Microsoft SSO (Setup-Schritte werden auch benötigt, um später SharePoint-Sites zu verbinden)
- Google OAuth SSO
- Google SAML für die Nutzung von Workspace-Gruppen
- Anmeldung per E-Mail
Stelle Genow mindestens einen Support- und einen Entwicklungs-Serviceuser zur Verfügung. Andernfalls können wir dich nicht vollständig unterstützen. Beide Benutzer sollten den Gruppen der globalen Platform-Admins hinzugefügt werden, um alle erforderlichen Berechtigungen zu erhalten.
- Google SSO
- Google SAML
- Microsoft SSO
- Anmeldung per E-Mail
Diese Anleitung führt dich durch die Einrichtung von Single Sign-On (SSO) mit Google Workspace für Genow. Diese Integration ermöglicht es deinen Benutzern, sich mit ihren Google Workspace-Anmeldedaten anzumelden.
Voraussetzungen
- Ein Google Workspace-Konto
- Ein Google Cloud-Projekt (bei Self-Hosting)
- Administratorzugriff auf deine Genow-Instanz (bei Self-Hosting)
Schritt 1: Projekteinrichtung
- Wenn Genow in einem anderen Tenant als dein Google Workspace läuft:
- Gehe zur Google Cloud Console
- Erstelle ein neues Projekt für die oAuth-Einstellungen
- Wenn Genow im selben Tenant wie dein Google Workspace läuft:
- Verwende das bestehende Genow-Plattformprojekt
Schritt 2: OAuth-Client konfigurieren
- Navigiere in der Google Cloud Console zu APIs & Services > Credentials
- Klicke auf Create Credentials > OAuth client ID
- Konfiguriere den OAuth consent screen:
- User Type: Internal
- App name: “Genow SSO”
- User support email: Deine Admin-E-Mail
- Developer contact information: Deine Kontakt-E-Mail
- Erstelle eine OAuth 2.0 Client ID:
- Application type: Web application
- Name: “Genow SSO”
- Authorized JavaScript origins: Füge die Identity-Platform-Origins deiner Genow-Plattform hinzu
- Authorized redirect URIs: Füge die Identity-Platform-Redirect-URIs deiner Genow-Plattform hinzu
Hinweis: Die genauen Origins und Redirect-URIs werden dir von deinem Genow-Plattformadministrator bereitgestellt
- Klicke auf Create
- Speichere die generierten Werte:
- Client ID
- Client Secret
Schritt 3: Genow konfigurieren
- Melde dich als Administrator bei deiner Genow-Instanz an
- Füge die folgenden Informationen zum Secret Manager der Genow-Plattform hinzu:
FIREBASE_CLIENT_ID: Deine Google Client IDFIREBASE_CLIENT_SECRET: Dein Google Client SecretWenn die Plattform von Genow gehostet wird, leite diese Informationen bitte an Genow weiter. Die folgenden Schritte werden in diesem Fall ebenfalls von Genow durchgeführt.
- Führe nach dem Hinzufügen der Secrets die folgenden Befehle aus, um die Infrastruktur zu aktualisieren:
- Warte, bis die Infrastruktur-Updates abgeschlossen sind
Schritt 4: Integration testen
- Melde dich von Genow ab
- Klicke auf die Schaltfläche “Sign in with Google”
- Du solltest zur Google-Anmeldeseite weitergeleitet werden
- Nach erfolgreicher Authentifizierung solltest du zurück zu Genow weitergeleitet werden
Wichtige Hinweise
- Die Authentifizierung erfolgt über das OAuth 2.0-Protokoll von Google
- Wir empfehlen, unserem Support-Team Zugriff auf dein Google Cloud-Projekt zu gewähren, um eine bessere Unterstützung zu ermöglichen
- Zusätzliche Dokumentation zu Anwendungsrollen und Benutzerberechtigungen wird separat bereitgestellt
Fehlerbehebung
Wenn du auf Probleme stößt:- Überprüfe, ob alle Konfigurationswerte korrekt sind
- Stelle sicher, dass die autorisierten Origins und Redirect-URIs exakt übereinstimmen
- Prüfe, ob die Benutzer in beiden Systemen existieren
- Überprüfe die Genow-Logs auf Fehlermeldungen
- Überprüfe, ob der OAuth consent screen korrekt konfiguriert ist
- Stelle sicher, dass für das Projekt die erforderlichen APIs aktiviert sind
Sicherheitshinweise
- Rotiere das Client Secret regelmäßig
- Überwache die Anmelde-Logs auf verdächtige Aktivitäten
- Halte dein Google Cloud-Projekt sicher
- Überprüfe und auditiere den Benutzerzugriff regelmäßig
- Erwäge die Implementierung zusätzlicher Sicherheitsmaßnahmen wie 2FA

