Zum Hauptinhalt springen
Grundsätzlich bieten wir drei verschiedene Authentifizierungsmethoden an:
  • 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
Eine detaillierte Anleitung zur Einrichtung der Authentifizierungsmethoden findest du unten.
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.
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

  1. Wenn Genow in einem anderen Tenant als dein Google Workspace läuft:
  2. Wenn Genow im selben Tenant wie dein Google Workspace läuft:
    • Verwende das bestehende Genow-Plattformprojekt

Schritt 2: OAuth-Client konfigurieren

  1. Navigiere in der Google Cloud Console zu APIs & Services > Credentials
  2. Klicke auf Create Credentials > OAuth client ID
  3. 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
  4. 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
  5. Klicke auf Create
  6. Speichere die generierten Werte:
    • Client ID
    • Client Secret

Schritt 3: Genow konfigurieren

  1. Melde dich als Administrator bei deiner Genow-Instanz an
  2. Füge die folgenden Informationen zum Secret Manager der Genow-Plattform hinzu:
    • FIREBASE_CLIENT_ID: Deine Google Client ID
    • FIREBASE_CLIENT_SECRET: Dein Google Client Secret
      Wenn 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.
  3. Führe nach dem Hinzufügen der Secrets die folgenden Befehle aus, um die Infrastruktur zu aktualisieren:
  4. Warte, bis die Infrastruktur-Updates abgeschlossen sind

Schritt 4: Integration testen

  1. Melde dich von Genow ab
  2. Klicke auf die Schaltfläche “Sign in with Google”
  3. Du solltest zur Google-Anmeldeseite weitergeleitet werden
  4. 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:
  1. Überprüfe, ob alle Konfigurationswerte korrekt sind
  2. Stelle sicher, dass die autorisierten Origins und Redirect-URIs exakt übereinstimmen
  3. Prüfe, ob die Benutzer in beiden Systemen existieren
  4. Überprüfe die Genow-Logs auf Fehlermeldungen
  5. Überprüfe, ob der OAuth consent screen korrekt konfiguriert ist
  6. 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