Hilfe Die Plattform Import und SSO
Google Workspace verbinden
Auf dieser Seite
Ü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.
1Zugang bei Google vorbereiten
Die Synchronisierung verwendet ein Google-Dienstkonto, das im Namen eines Administrators Ihrer Domain handelt. Sie benötigen:
ein Dienstkonto in einem Google-Cloud-Projekt, mit einem JSON-Schlüssel (die Datei muss
client_email,private_keyundtoken_urienthalten);die aktivierte Admin-SDK-API für dieses Projekt;
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;
die E-Mail-Adresse eines Domänenadministrators, der Benutzer und Gruppen lesen kann: Das Dienstkonto handelt in seinem Namen.
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
| Feld | Inhalt |
|---|---|
| JSON-Schlüssel des Dienstkontos | Obligatorisch. Der vollständige Inhalt der JSON-Datei; das ist das Geheimnis des Imports und darf nirgendwo anders weitergegeben werden. |
| E-Mail des delegierten Administrators | Obligatorisch. Der Administrator, in dessen Namen das Dienstkonto das Verzeichnis liest. |
| Google-Kunden-ID (customer ID) | Optional. Leer: my_customer, das Konto des delegierten Administrators. |
| Domain | Optional. 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].languageCodesowie die weiteren von Google gelieferten Felder der obersten Ebene, zum Beispielsuspended. - 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.
Deklarieren Sie alle in SSO-Anmeldung angezeigten Weiterleitungs-URLs (Portal und Academy) als zulässige Weiterleitungs-URIs der OAuth-Anwendung.
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
| Situation | Zu prüfen |
|---|---|
| Verbindungstest fehlgeschlagen | Ist 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 Personen | Beschränkt das Feld Domain die Lesung? Sind die fehlenden Personen direkte Mitglieder der ausgewählten Gruppen? |
| Organisation mit aktiver Verschlüsselung | Test und Synchronisierung laufen über den Bexxo Protected Agent: Er muss gestartet sein und die Google-Adressen erreichen können. |
Keine Antwort gefunden? Kontakt aufnehmen