MyQ X Server
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 8.2 EoL Print Server Central Server English French German Italian Portuguese Spanish

Benutzer aus Active Directory synchronisieren

MyQ X synchronisiert Benutzer aus Active Directory (AD) mithilfe des LDAP-Protokolls. Die Synchronisierung importiert Benutzerkonten und Gruppenmitgliedschaften, hält diese bei Änderungen im Verzeichnis auf dem neuesten Stand und ordnet die Verzeichnisattribute zu, von denen die Authentifizierung für Druckaufträge und die Terminalanmeldung abhängen.

Hinweise dazu, wann diese Quelle zu verwenden ist, finden Sie im Bereitstellungshandbuch. Siehe User Synchronization.


Voraussetzungen

  • Ein Active Directory-Domänencontroller, der vom MyQ-Server über LDAPS (Port 636 empfohlen) oder LDAP (Port 389) erreichbar ist.

  • Ein Dienstkonto in AD mit Lesezugriff, der auf die Organisationseinheiten beschränkt ist, die Sie synchronisieren möchten. Es sind weder Schreibzugriff noch erweiterte Domänenrechte erforderlich.

  • Bei Verwendung von LDAPS (empfohlen) muss das Stammzertifikat der ausstellenden Zertifizierungsstelle im Windows-Zertifikatsspeicher des MyQ-Servers installiert sein, damit das AD-Zertifikat überprüft werden kann. In verwalteten Umgebungen wird dies möglicherweise bereits über Gruppenrichtlinien geregelt.

  • DNS löst die AD-Domäne vom MyQ-Server aus korrekt auf.


Wichtige Hinweise

Testen Sie die Erkennung von Druckaufträgen, bevor Sie die Synchronisierung konfigurieren. MyQ ordnet bei LDAP-synchronisierten Benutzern stets sAMAccountName dem Feld Benutzername zu – dies kann nicht geändert werden. Wenn Ihre Erkennung von Druckaufträgen einen anderen Wert zurückgibt – in Umgebungen mit Entra-ID- oder hybridverbundenen Geräten meist userPrincipalName –, schlägt die Übereinstimmung fehl, sofern dieser Wert nicht ebenfalls als Alias vorhanden ist. Senden Sie einen Testauftrag von einem Konto, das in MyQ noch nicht existiert, und überprüfen Sie den Eintrag im Verwerfungsprotokoll (Job discarded. User "x" not found.) – der in Anführungszeichen gesetzte Wert ist genau der, den Ihre Synchronisierung in das Feld Benutzername oder Alias eintragen muss. Siehe Understanding Job Detection.

Felder mit mehreren Werten erfordern eine Transformation. In einigen Umgebungen werden mehrere Identifikatoren – beispielsweise eine Ausweisnummer und eine persönliche Nummer – in einem einzigen AD-Attribut gespeichert, getrennt durch ein Trennzeichen. MyQ unterstützt in den Synchronisierungsquelleneinstellungen die Transformation mittels regulärer Ausdrücke (Regex), um diese Werte zu analysieren. Siehe Benutzerdaten mit RegEx umwandeln.

Umgebungen mit mehreren Domänen erfordern das Anhängen der Domäne. Wenn Benutzer aus mehreren AD-Domänen in dieselbe MyQ-Installation synchronisiert werden, kann derselbe sAMAccountName in mehr als einer Domäne vorkommen. Aktivieren Sie in jeder LDAP-Synchronisationsquelle die Option Domänennamen an den Benutzernamen anhängen, um eindeutige Benutzernamen im Format username@domain zu erzeugen. Damit die Auftragsauthentifizierung korrekt funktioniert, muss die Domäne auch im Druckauftrag vorhanden sein. Siehe Multi-domain and Multi-tenant Environments.

Eine Schemaerweiterung ist irreversibel. Wenn Sie beabsichtigen, benutzerdefinierte Schemaerweiterungsattribute zum Schutz sensibler Werte wie Kartennummern oder PINs zu verwenden, testen Sie die Schemaänderung in einer Laborumgebung, bevor Sie sie in der Produktionsumgebung anwenden. Dem AD-Schema hinzugefügte benutzerdefinierte Attribute können nicht entfernt werden.


Konfigurieren Sie den Authentifizierungsserver

Gehen Sie zu MyQ > Einstellungen > Authentifizierungsserver und fügen Sie einen neuen LDAP-Server für die AD-Domäne hinzu. Stellen Sie Sicherheit auf SSL und den Port auf 636 ein.

Wenn ein Dienstkonto einer Subdomain verwendet wird, geben Sie die Subdomain im Feld Benutzername an. Befindet sich beispielsweise das Konto Administrator in cz.testAD.local, stellt jedoch eine Verbindung zu testAD.local her, geben Sie Administrator@cz.testAD.local ein.

Siehe auch: Einstellungen für Authentifizierungsserver


Konfigurieren Sie die Synchronisationsquelle

Gehen Sie zu Einstellungen > Benutzersynchronisierung, klicken Sie auf + Hinzufügen und wählen Sie LDAP-Quelle hinzufügen.

Die vollständige Konfigurationsanleitung finden Sie unter Benutzer aus LDAP synchronisieren. Im Folgenden werden die für Active Directory spezifischen Aspekte behandelt.

Standard-Attributzuordnung

MyQ wendet diese Standardzuordnungen automatisch für Active-Directory-Quellen an. Alle anderen Eigenschaften haben keine Standardwerte und müssen explizit konfiguriert werden.

MyQ-Eigenschaft

Standard-AD-Attribut

Benutzername

sAMAccountName

Vollständiger Name

cn

E-Mail

mail

Eigenschaften, die üblicherweise explizit für AD konfiguriert werden:

MyQ-Eigenschaft

AD-Attribut

Notizen

Alias

userPrincipalName

Ordnen Sie hier zu, wenn die Joberkennung UPN anstelle von sAMAccountName zurückgibt.

Alias

mailNickname oder mail

Hier zuordnen, wenn die Erkennung von Druckaufträgen Kennungen im E-Mail-Format zurückgibt.

Persönliche Nummer

employeeId

Nützlich für die Zuordnung von Benutzern über Synchronisierungsquellen hinweg, einschließlich während der Migration von AD zu Entra ID.

Karte

Benutzerdefiniertes Attribut oder extensionAttribute

Prüfen Sie vor der Aktivierung den Schutz vertraulicher Attribute – siehe Sicherheitshinweise.

PIN

Benutzerdefiniert oder extensionAttribute

Es gelten dieselben Überlegungen wie bei der Karte.

Benutzerspeicher

HomeDrive

Aktiviert Easy Print und Easy Scan für den Home-Ordner des Benutzers auf Embedded Terminals.


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

Verwenden Sie LDAPS

Die gesamte LDAP-Kommunikation zwischen MyQ und AD sollte über LDAPS (LDAP über SSL/TLS) oder StartTLS erfolgen. Bei einfachem LDAP werden Anmeldedaten und Verzeichnisdaten im Klartext übertragen. LDAPS kann in den Einstellungen des Authentifizierungsservers in MyQ erzwungen werden.

Schützen Sie sensible Verzeichnisattribute

Standardmäßige AD-Attribute sind standardmäßig für jeden authentifizierten Domänenbenutzer lesbar. Wenn Ausweisnummern, PINs oder andere sensible Identifikatoren in AD gespeichert sind und mit MyQ synchronisiert werden sollen, kennzeichnen Sie diese Attribute vor der Aktivierung der Synchronisierung als vertraulich. Vertrauliche Attribute beschränken den Lesezugriff auf bestimmte Treuhandkonten – dem von MyQ für die Synchronisierung verwendeten Dienstkonto würde Treuhandzugriff gewährt.

Für einen stärkeren Schutz sollten Sie sensible Werte in benutzerdefinierten Schemaerweiterungsattributen statt in Standardattributen speichern. Benutzerdefinierte Attribute lassen sich weniger leicht auflisten und können ebenfalls als vertraulich gekennzeichnet werden.

Wenden Sie das Prinzip der geringsten Berechtigungen auf das Synchronisierungsdienstkonto an

Das für die LDAP-Synchronisierung verwendete Dienstkonto sollte über Lesezugriff verfügen, der auf die zu synchronisierenden Organisationseinheiten beschränkt ist. Werden vertrauliche Attribute verwendet, muss dem Dienstkonto ausdrücklich nur für diese Attribute Treuhänderzugriff gewährt werden.