Zum Inhalt springen
Bexxo Hilfe

Hilfe Die Plattform Import und SSO

Google Workspace verbinden

Für Administratoren Aktualisiert am 13. November 2026

Google Workspace verbinden, um die Personen und Gruppen der Organisation zu synchronisieren und die Anmeldung mit dem Google-Konto (SSO) vorzubereiten.
Auf dieser Seite
  1. Übersicht
  2. Zugang bei Google vorbereiten
  3. Den Abschnitt Verbindung ausfüllen
  4. Was importiert wird
  5. SSO-Anmeldung mit Google
  6. Testen und Fehler beheben

Übersicht

Google Workspace wird nur lesend abgefragt: Benutzer, Gruppen und Mitglieder. Dieser Artikel behandelt die Vorbereitung bei Google und die Abschnitte Verbindung und SSO-Anmeldung; die übrigen Einstellungen sind für alle Importe gleich.

Die für alle Importe gemeinsamen EinstellungenPersonen importieren und SSO einrichten

1Zugang bei Google vorbereiten

Die Synchronisierung verwendet ein Google-Dienstkonto, das im Namen eines Administrators Ihrer Domain handelt. Sie benötigen:

  1. ein Dienstkonto in einem Google-Cloud-Projekt, mit einem JSON-Schlüssel (die Datei muss client_email, private_key und token_uri enthalten);

  2. die aktivierte Admin-SDK-API für dieses Projekt;

  3. in der Google-Workspace-Administrationskonsole die domänenweite Delegierung, die der Client-ID des Dienstkontos erteilt wird, mit genau den drei untenstehenden Bereichen mit Lesezugriff;

  4. die E-Mail-Adresse eines Domänenadministrators, der Benutzer und Gruppen lesen kann: Das Dienstkonto handelt in seinem Namen.

Zu delegierende Bereiche

Die Menüs der Google-Konsolen ändern sich häufig: Suchen Sie nach «Dienstkonten» für den Schlüssel und nach «Domänenweite Delegierung» für die Bereiche.

2Den Abschnitt Verbindung ausfüllen

FeldInhalt
JSON-Schlüssel des DienstkontosObligatorisch. Der vollständige Inhalt der JSON-Datei; das ist das Geheimnis des Imports und darf nirgendwo anders weitergegeben werden.
E-Mail des delegierten AdministratorsObligatorisch. Der Administrator, in dessen Namen das Dienstkonto das Verzeichnis liest.
Google-Kunden-ID (customer ID)Optional. Leer: my_customer, das Konto des delegierten Administrators.
DomainOptional. Beschränkt die gelesenen Benutzer auf diese Domain, zum Beispiel exemple.ch. Gruppen werden immer für das gesamte Konto gelesen.

Der JSON-Schlüssel enthält einen privaten Schlüssel: Fügen Sie ihn nur in dieses Feld ein.

Was importiert wird

  • Ein in Google gesperrter oder archivierter Benutzer wird als inaktiv importiert.
  • Nur direkte Mitglieder vom Typ Benutzer werden einer Gruppe zugeordnet: Eine verschachtelte Gruppe wird nicht aufgelöst.
  • In der Feldzuordnung und den Filtern verwendbare Eigenschaften für eine Person: primaryEmail, name.givenName, name.familyName, name.fullName, phones[0].value, organizations[0].title, orgUnitPath, languages[0].languageCode sowie die weiteren von Google gelieferten Felder der obersten Ebene, zum Beispiel suspended.
  • Für eine Gruppe: name, email, description.

Beispiel für einen Filter nach Organisationseinheit: Eigenschaft orgUnitPath, Beginnt mit, /Siège.

SSO-Anmeldung mit Google

Das SSO verwendet eine OAuth-Anwendung vom Typ «Webanwendung», die in Google Cloud erstellt wird und vom Dienstkonto getrennt ist.

  1. Deklarieren Sie alle in SSO-Anmeldung angezeigten Weiterleitungs-URLs (Portal und Academy) als zulässige Weiterleitungs-URIs der OAuth-Anwendung.

  2. Geben Sie den Aussteller https://accounts.google.com, die Client-ID und das Clientgeheimnis der OAuth-Anwendung ein, speichern Sie und testen Sie dann die Erkennung.

Die Aktivierung des SSO und die Folgen einer Unterbrechung werden im allgemeinen Artikel beschrieben.

Testen und Fehler beheben

SituationZu prüfen
Verbindungstest fehlgeschlagenIst der JSON-Schlüssel vollständig und aktuell? Betrifft die Delegierung die Client-ID dieses Dienstkontos, mit den drei Bereichen? Ist die delegierte E-Mail die eines Administrators, der Benutzer und Gruppen lesen kann?
Der Test gelingt, aber es fehlen PersonenBeschränkt das Feld Domain die Lesung? Sind die fehlenden Personen direkte Mitglieder der ausgewählten Gruppen?
Organisation mit aktiver VerschlüsselungTest und Synchronisierung laufen über den Bexxo Protected Agent: Er muss gestartet sein und die Google-Adressen erreichen können.
Organisation mit aktiver VerschlüsselungDen Bexxo Protected Agent installieren

Keine Antwort gefunden? Kontakt aufnehmen