MyQ X synchronisiert Benutzer aus Google Workspace mithilfe des Secure-LDAP-Dienstes von Google, der über LDAPS schreibgeschützten Zugriff auf das Google-Verzeichnis gewährt. Bei der Synchronisierung werden Benutzerkonten und Gruppenmitgliedschaften importiert und Verzeichnisattribute den MyQ-Benutzereigenschaften zugeordnet.
Voraussetzungen
-
Super-Admin-Berechtigungen in Google Workspace.
-
Ein Google Workspace-Abonnement, das den Secure LDAP-Dienst unterstützt.
-
Der MyQ-Server muss in der Lage sein, ausgehende LDAPS-Verbindungen (TCP 636) zu Google herzustellen.
-
Kenntnis darüber, welchen Benutzern oder Gruppen der Zugriff auf MyQ gestattet werden soll.
Wichtige Hinweise
Jede MyQ-Serverinstanz benötigt ein eigenes LDAP-Client-Zertifikat. Google stellt pro LDAP-Client ein eindeutiges Zertifikat aus. Wenn Sie mehrere MyQ-Server betreiben – beispielsweise einen Zentral-Server und Site-Server –, muss für jeden Server ein eigener Client in Google Admin mit einem eigenen Zertifikat und eigenen Anmeldedaten registriert sein.
Zertifikate laufen ab und müssen erneuert werden. LDAP-Client-Zertifikate für Google Workspace haben ein Ablaufdatum. Planen Sie die Erneuerung der Zertifikate in Ihrem Betriebskalender ein. Wenn ein Zertifikat abläuft, schlägt die Synchronisierung fehl, bis ein neues Zertifikat generiert und in MyQ hochgeladen wurde.
Änderungen an den Zugriffsberechtigungen können bis zu 24 Stunden dauern, bis sie wirksam werden. Wenn Sie die LDAP-Client-Zugriffsberechtigungen in der Google Admin-Konsole ändern, werden die Änderungen nicht sofort wirksam. Berücksichtigen Sie diese Verzögerung bei der Ersteinrichtung und beim Testen – sollte die Synchronisierung kurz nach einer Berechtigungsänderung nicht die erwarteten Ergebnisse liefern, warten Sie ab und versuchen Sie es erneut, bevor Sie weitere Fehlerbehebungsmaßnahmen ergreifen.
Das Client-Zertifikat muss im PEM-Format vorliegen. MyQ benötigt das Client-Zertifikat im PEM-Format (Base64-kodiert, mit BEGIN CERTIFICATE-Headern). Falls das aus der Google Admin-Konsole heruntergeladene Zertifikat im binären DER-Format vorliegt, konvertieren Sie es vor dem Hochladen in MyQ, beispielsweise mit OpenSSL: openssl x509 -inform der -in certificate.der -out certificate.pem
Schützen Sie den privaten Schlüssel nicht mit einem Passwort. MyQ kann keinen passwortgeschützten privaten Schlüssel verwenden. Lassen Sie den privaten Schlüssel bei der Erstellung der Anmeldedaten in Google Admin ungeschützt.
Konfigurieren Sie den LDAP-Client in Google Admin
Dieser Schritt wird vollständig in der Google Admin-Konsole durchgeführt. Dabei werden das Client-Zertifikat, der private Schlüssel und die LDAP-Anmeldedaten erstellt, die MyQ für die Verbindung benötigt.
-
Melden Sie sich mit einem Super-Admin-Konto bei der Google Admin-Konsole an.
-
Gehen Sie zu Apps > LDAP und klicken Sie auf Client hinzufügen.
-
Geben Sie einen Namen für den Client (erforderlich) und optional eine Beschreibung ein. Klicken Sie auf Weiter.
-
Klicken Sie auf der Seite LDAP-Client auf Zugriffsberechtigungen und nehmen Sie folgende Einstellungen vor:
Benutzeranmeldedaten überprüfen – aktiviert die Benutzerauthentifizierung über MyQ. Stellen Sie diese Option auf Alle Benutzer oder auf bestimmte Organisationseinheiten ein.
Benutzerinformationen lesen – ermöglicht MyQ das Auslesen von Benutzerattributen. Legen Sie dies für alle Benutzer oder für bestimmte Organisationseinheiten fest und aktivieren Sie anschließend den Zugriff auf:
-
Systemattribute
-
Öffentliche benutzerdefinierte Attribute
-
Private benutzerdefinierte Attribute
Gruppeninformationen lesen – ermöglicht es MyQ, die Mitgliedschaft in Verzeichnisgruppen auszulesen. Stellen Sie diese Option auf Ein.
-
-
Klicken Sie auf LDAP-Client hinzufügen und warten Sie, bis der Client eingerichtet und ein Zertifikat generiert wurde. Dies kann einige Minuten dauern.
-
Downloaden Sie das generierte Zertifikatspaket. Die ZIP-Datei enthält:
-
Das Client-Zertifikat (
.crtoder.pem) -
Den privaten Schlüssel (
.key)
Bewahren Sie diese Dateien sicher auf. Falls das Zertifikat im DER-Format vorliegt, konvertieren Sie es in das PEM-Format, bevor Sie fortfahren.
-
-
Klicken Sie auf Weiter zu den Client-Details.
-
Klicken Sie auf Zugangsdaten und anschließend auf Neue Zugangsdaten generieren. Der generierte Benutzername und das Passwort werden nur einmal angezeigt – bewahren Sie diese sicher auf, bevor Sie diesen Bildschirm verlassen.
-
Kehren Sie zur Seite mit den LDAP-Client-Details zurück und setzen Sie die Dienste für alle auf Ein. Klicken Sie auf Speichern.
Google Workspace ist nun mit MyQ als LDAP-Client konfiguriert.
Konfigurieren Sie den Authentifizierungsserver auf dem MyQ-Server
Gehen Sie zu MyQ > Einstellungen > Authentifizierungsserver und fügen Sie einen neuen LDAP-Server für Google Workspace hinzu.
|
Einstellung |
Wert |
|---|---|
|
Sicherheit |
SSL |
|
Port |
636 |
|
Server |
|
|
Benutzer |
Der in Google Admin generierte Benutzername (Schritt 1) |
|
Passwort |
Das in Google Admin (Schritt 1) generierte Passwort |
|
Client-Zertifikat |
Laden Sie die aus Google Admin heruntergeladene |
|
Privater Schlüssel |
Laden Sie die aus Google Admin heruntergeladene |
Konfigurieren Sie die Synchronisationsquelle
Gehen Sie zu MyQ > Einstellungen > Benutzersynchronisierung, klicken Sie auf + Hinzufügen und wählen Sie LDAP-Quelle hinzufügen aus.
Im Folgenden werden die für Google Workspace spezifischen Aspekte behandelt.
Basis-DN
Der Basis-DN für Google Workspace verwendet die Domänenkomponenten Ihrer Google Workspace-Domäne. Beispiel für die Domäne example.com:
dc=example,dc=com
Standard-Attributzuordnung
Google Workspace stellt ein Standard-LDAP-Schema bereit. Die folgenden Zuordnungen gelten typischerweise für die meisten Google Workspace-Verzeichnisse; überprüfen Sie die Attributnamen jedoch anhand Ihres tatsächlichen Verzeichnisses mithilfe des LDAP-Browsers auf der Registerkarte Allgemein.
|
MyQ-Eigenschaft |
Typisches Google Workspace-Attribut |
|---|---|
|
Benutzername |
|
|
Vollständiger Name |
|
|
|
|
|
Alias |
(keine – bei Bedarf explizit konfigurieren) |
|
Persönliche Nummer |
(keine – bei Bedarf explizit konfigurieren) |
Synchronisierung ausführen und planen
Um die Synchronisierung sofort auszuführen, gehen Sie zu MyQ > Einstellungen > Benutzersynchronisierung, wählen Sie die Synchronisationsquelle aus und klicken Sie auf Jetzt synchronisieren. Bei korrekter Konfiguration werden die synchronisierten Benutzer und Gruppen unter MyQ > Benutzer angezeigt.
Um die Synchronisierung automatisch nach einem Zeitplan durchzuführen, gehen Sie zu MyQ > Einstellungen > Aufgabenplan und konfigurieren Sie die Aufgabe Benutzersynchronisierung.
Sicherheitshinweise
LDAPS ist zwingend erforderlich
Der Secure-LDAP-Dienst von Google funktioniert ausschließlich über LDAPS – reines LDAP wird nicht unterstützt. Stellen Sie sicher, dass der MyQ-Server ldap.google.com über TCP-Port 636 erreichen kann und dass keine Firewall-Regel ausgehende Verbindungen auf diesem Port blockiert.
Schützen Sie Client-Zertifikate und Anmeldedaten
Das Client-Zertifikat, der private Schlüssel und die generierten Anmeldedaten gewähren Lesezugriff auf Ihr Google-Verzeichnis. Bewahren Sie diese sicher auf und beschränken Sie den Zugriff auf den MyQ-Server und dessen Administratoren. Ändern Sie die Anmeldedaten, falls diese offengelegt wurden.
Wenden Sie das Prinzip der geringsten Berechtigungen über Zugriffsberechtigungen an
Beschränken Sie in Google Admin die Zugriffsberechtigungen des LDAP-Clients ausschließlich auf die Organisationseinheiten, auf die MyQ zugreifen muss. Allen Benutzern Zugriff zu gewähren, obwohl die Synchronisierung nur einen Teil der Organisation abdeckt, stellt ein unnötiges Sicherheitsrisiko dar.