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 Microsoft Entra ID synchronisieren

Synchronisieren Sie Benutzer aus Microsoft Entra ID, um MyQ-Benutzer und -Gruppen anzulegen und zu verwalten.

Um Benutzer mit Microsoft Entra ID zu synchronisieren, planen Sie zunächst Ihre Synchronisationsquelle, die Benutzeridentitäten, das Verhalten der maßgeblichen Quelle sowie Multi-Tenant-Umgebungen. Registrieren Sie anschließend eine Microsoft Entra ID-Anwendung. Erstellen Sie schließlich in MyQ eine Microsoft Entra ID-Verbindung, die Sie für Ihre Synchronisation verwenden können.


Microsoft Entra ID als Synchronisationsquelle hinzufügen

Gehen Sie zu MyQ > Einstellungen > Benutzersynchronisierung.

Klicken Sie auf Hinzufügen und wählen Sie Microsoft Entra ID-Quelle hinzufügen aus.

Konfigurieren Sie die Synchronisationsquelle auf den folgenden Registerkarten:

  • Allgemein: Wählen Sie die Entra-Verbindung aus und geben Sie die Synchronisationsquelle an.

  • Benutzer: Wählen Sie aus, welche Benutzer synchronisiert werden sollen, ordnen Sie deren Eigenschaften zu und konfigurieren Sie die Optionen für den Benutzerlebenszyklus.

  • Gruppen: Legen Sie fest, welche Entra-Gruppenmitgliedschaften in MyQ dargestellt werden und wie diese gepflegt werden.

Registerkarte Allgemein

Konfigurieren Sie die Synchronisationsquelle:

  • Aktivieren: Aktivieren oder deaktivieren Sie die Synchronisationsquelle.

  • Authentifizierungsserver: Wählen Sie die Microsoft Entra ID-Verbindung aus, die für den Zugriff auf den Mandanten verwendet wird.

  • Synchronisationsquelle: Geben Sie einen aussagekräftigen Namen für die Quelle ein.

Verwenden Sie eindeutige und aussagekräftige Namen, wenn Sie Benutzer aus mehreren Entra-Mandanten synchronisieren.

Registerkarte Benutzer

Wählen Sie auf der Registerkarte Benutzer aus, welche Entra-Benutzer synchronisiert werden sollen, ordnen Sie deren Eigenschaften MyQ zu und konfigurieren Sie, wie MyQ mit Änderungen umgeht, die während der Synchronisierung erkannt werden.

Zu importierende Benutzer

Wählen Sie eine der folgenden Optionen aus:

  • Alle Benutzer: Synchronisieren Sie alle Benutzer im Mandanten.

  • Benutzer aus ausgewählten Gruppen: Synchronisieren Sie Benutzer, die Mitglieder mindestens einer ausgewählten Entra-Gruppe sind.

  • Benutzer aus Gruppen, deren Namen eine bestimmte Zeichenfolge enthalten: Synchronisieren Sie Benutzer, die Gruppen angehören, deren Namen eine der angegebenen Zeichenfolgen enthalten. Geben Sie jede Zeichenfolge in einer separaten Zeile ein. Bei der Übereinstimmungssuche wird die Groß-/Kleinschreibung nicht berücksichtigt.

Das Filtern von Benutzern anhand von Zeichenfolgen in Gruppennamen kann die Synchronisationszeit erheblich verlängern.

Benutzereigenschaften

Ordnen Sie Microsoft Entra-Attribute den MyQ-Benutzereigenschaften zu.

MyQ-Eigenschaft

Verfügbare Entra-Attribute

Vollständiger Name

displayName

Persönliche Nummer

employeeId, extensionAttribute1–extensionAttribute15

E-Mail

mail

Notizen

extensionAttribute1–extensionAttribute15

Sprache

preferredLanguage

Abteilung

department

Alias

displayName, userPrincipalName, upnPrefix, mailNickname, onPremisesSamAccountName, onPremisesDomainName, extensionAttribute1–extensionAttribute15

Karte

employeeId, extensionAttribute1–extensionAttribute15

PIN

employeeId, extensionAttribute1–extensionAttribute15

Benutzerdefiniert 1–3

extensionAttribute1–extensionAttribute15

Sie können auch ein unterstütztes benutzerdefiniertes Entra-Attribut eingeben, anstatt eines der vordefinierten Attribute auszuwählen.

Der Entra-UPN des Benutzers wird stets als MyQ-Benutzername verwendet und kann nicht neu zugeordnet werden.

Für die Eigenschaft Alias können Sie onPremisesSamAccountName@onPremisesDomainName verwenden, um die beiden Attribute zu einem Alias wie beispielsweise user@company.com zu kombinieren.

Optionen zur Benutzersynchronisierung

users-settings-sync-entraid-options.png

Konfigurieren Sie, wie MyQ mit synchronisierten Benutzern umgeht.

  • Fehlende Benutzer deaktivieren: Deaktivieren Sie automatisch Benutzer in MyQ, die nicht mehr im Synchronisierungsbereich vorhanden sind.
    Verwenden Sie diese Option, wenn Entra ID den Lebenszyklus der synchronisierten MyQ-Benutzer steuert.

  • Neue Benutzer hinzufügen: Erstellen Sie automatisch MyQ-Benutzer, die im Synchronisierungsbereich gefunden werden, aber noch nicht in MyQ vorhanden sind.

  • Als Authentifizierungsserver verwenden: Weisen Sie die ausgewählte Microsoft Entra ID-Verbindung als Authentifizierungsserver für synchronisierte Benutzer zu.
    Aktivieren Sie diese Option, wenn sich von dieser Synchronisationsquelle synchronisierte Benutzer auch bei Microsoft Entra ID authentifizieren sollen.

  • Nach persönlicher Nummer zuordnen: Ordnen Sie synchronisierte Identitäten anhand der persönlichen Nummer bestehenden MyQ-Benutzern zu. Wenn eine übereinstimmende persönliche Nummer gefunden wird, aktualisiert MyQ den bestehenden Benutzer, anstatt ein neues Konto anzulegen.
    Die Zuordnung nach persönlicher Nummer ist standardmäßig für Synchronisationsquellen aktiviert, die in aktuellen MyQ X-Versionen erstellt wurden, und wird dringend empfohlen.

  • Synchronisationsquelle ignorieren: Ermöglicht es dieser Synchronisationsquelle, bestehende MyQ-Benutzer abzugleichen und zu aktualisieren, selbst wenn diese einer anderen Synchronisationsquelle zugeordnet sind. Aktivieren Sie diese Option, wenn Sie Benutzer zu Entra ID migrieren oder mehrere Benutzerquellen konsolidieren, ohne doppelte Konten zu erstellen.

  • Delta-Synchronisierung aktivieren: Überprüfen Sie in regelmäßigen Abständen, ob seit dem letzten Delta-Lauf Änderungen vorgenommen wurden, und wenden Sie nur diese Änderungen an – neue Benutzer, aktualisierte Benutzer, deaktivierte oder gelöschte Benutzer, Umbenennungen von Gruppen sowie Änderungen der Gruppenzugehörigkeit.

Normalisierten Alias aus Anzeigenamen erstellen

Aktivieren Sie Normalisierten Alias aus Anzeigenamen erstellen, um einen zusätzlichen Alias hinzuzufügen, der zur Identifizierung von Druckaufträgen verwendet werden kann, die von mit Entra ID verbundenen Geräten übermittelt werden.

Der Alias wird aus dem Entra-Anzeigenamen des Benutzers in dem Format generiert, das von unterstützten Windows-Druckaufträgen erwartet wird.

Dieser Alias wird zusätzlich zu allen Aliasen hinzugefügt, die über die Eigenschaftszuordnungen konfiguriert wurden.

Einschränkung

Wenn mehrere synchronisierte Benutzer denselben Anzeigenamen haben, kann der normalisierte Alias nur dem ersten übereinstimmenden Benutzer zugewiesen werden. In diesem Fall kann MyQ die Benutzer anhand des mit dem Druckauftrag übermittelten verketteten Namens nicht zuverlässig unterscheiden.

Transformation

Während der Synchronisierung können Regex-Transformationsregeln auf Benutzerattribute angewendet werden, um Werte zu analysieren oder neu zu formatieren, bevor sie in MyQ gespeichert werden.

Registerkarte Gruppen

Die Registerkarte Gruppen steuert, wie Entra-Gruppenmitgliedschaften in MyQ dargestellt werden. Sie legt nicht fest, welche Benutzer importiert werden. Die Benutzerauswahl wird separat auf der Registerkarte Benutzer unter Zu importierende Benutzer konfiguriert.

users-settings-sync-entraid-groups.png

Synchronisationstyp

Wählen Sie aus, wie MyQ Änderungen an der Gruppenmitgliedschaft behandelt:

  • Vollständige Synchronisierung: Die Gruppenmitgliedschaft in MyQ richtet sich nach der Entra-ID. Benutzer werden Gruppen hinzugefügt oder aus diesen entfernt, um mit der Quelle übereinzustimmen.

  • Synchronisieren, wenn nicht leer: Die Gruppenzugehörigkeit wird synchronisiert, wobei verhindert wird, dass ein Benutzer ohne jegliche Gruppenzugehörigkeit verbleibt.

  • Neue hinzufügen: Fügen Sie in Entra ID gefundene Mitgliedschaften hinzu, entfernen Sie jedoch keine bestehenden MyQ-Mitgliedschaften, wenn Benutzer später aus der entsprechenden Entra-Gruppe entfernt werden.

Gruppen auswählen

Verwenden Sie die Gruppenfilter, um festzulegen, welche Entra-Gruppenmitgliedschaften in MyQ angelegt werden sollen:

  • Gruppen auswählen: Wählen Sie einzelne Entra-Gruppen aus.

  • Gruppen auswählen, die eine Zeichenfolge enthalten: Schließen Sie Gruppen ein, deren Namen mit den angegebenen Zeichenfolgen übereinstimmen.

  • Gruppen unter dieser Gruppe importieren: Ordnen Sie synchronisierte Gruppen einer bestehenden übergeordneten MyQ-Gruppe zu.

  • Gruppen ignorieren: Schließen Sie ausgewählte Gruppen aus.

  • Gruppen ignorieren, die eine Zeichenfolge enthalten: Schließen Sie Gruppen aus, deren Namen die angegebenen Zeichenfolgen enthalten.

Benutzerauswahl und Gruppensynchronisierung

Die Gruppen, anhand derer ausgewählt wird, welche Benutzer synchronisiert werden sollen, müssen nicht mit den Gruppen übereinstimmen, deren Mitgliedschaften in MyQ angelegt wurden.

Beispiel – nehmen wir an, Entra ID enthält:

  • Alle Studierenden – 1.500 Benutzer

  • Klasse 1A – 1.000 Benutzer

  • Klasse 1B – 500 Benutzer

Um alle Schüler zu synchronisieren, aber in MyQ nur die Mitgliedschaft Class1B anzulegen:

  1. Wählen Sie auf der Registerkarte Benutzer die Option Benutzer aus ausgewählten Gruppen und anschließend All students aus.

  2. Wählen Sie auf der Registerkarte Gruppen ausschließlich Class1B aus.

Alle 1.500 Benutzer werden synchronisiert, jedoch erhalten nur die 500 Mitglieder von Class1B diese Gruppenmitgliedschaft in MyQ.

Auf diese Weise lassen sich der Umfang der Benutzersynchronisierung und die MyQ-Gruppenstruktur unabhängig voneinander steuern.

Delta-Synchronisierung

Die Delta-Synchronisierung ist ein inkrementeller Modus, der die regelmäßige Vollsynchronisierung ergänzt. Um diese Funktion zu nutzen, aktivieren Sie die geplante Aufgabe Benutzer-Delta-Synchronisierung und führen Sie die Synchronisierung mindestens einmal durch.

Anstatt das gesamte Entra ID-Verzeichnis erneut einzulesen, fragt jeder Delta-Lauf bei Microsoft Entra ID nur nach den Änderungen, die seit dem letzten Lauf vorgenommen wurden. Da nur sehr wenige Daten übertragen werden, kann die Delta-Aufgabe alle paar Minuten ausgeführt werden, sodass Änderungen in Entra ID viel schneller in MyQ ankommen als bei einer täglichen Vollsynchronisierung allein.

Die Delta-Synchronisierung ersetzt die vollständige Synchronisierung nicht. Die reguläre vollständige Synchronisierung läuft weiterhin nach ihrem eigenen Zeitplan (in der Regel täglich) und dient als Sicherheitsnetz, das alle Daten abgleichen, die von den Delta-Läufen nicht abgedeckt werden konnten.

Das bloße Aktivieren des Kontrollkästchens löst keinen sofortigen Delta-Lauf aus. Änderungen werden erst erfasst, wenn die geplante Aufgabe Benutzer-Delta-Synchronisierung das nächste Mal ausgeführt wird.

Synchronisierung ausführen

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.

Mehrere Entra-Mandanten synchronisieren

Um Benutzer aus mehreren Microsoft Entra-Mandanten zu synchronisieren, erstellen Sie für jeden Mandanten eine separate Entra-Verbindung und eine separate Synchronisationsquelle. Geben Sie jeder Verbindung und jeder Synchronisationsquelle einen eindeutigen, aussagekräftigen Namen, damit Administratoren den entsprechenden Mandanten identifizieren können.

Jede Quelle kann über folgende eigene Einstellungen verfügen:

  • Synchronisierungsbereich

  • Eigenschaftszuordnungen

  • Gruppenkonfiguration

  • Optionen für den Benutzerlebenszyklus

  • Authentifizierungseinstellungen

Lokale Identität für hybride Entra-ID-Benutzer

In hybriden Umgebungen, in denen Entra-Benutzer über entsprechende lokale Active Directory-Identitäten verfügen, importiert MyQ automatisch die folgenden Attribute, sofern diese verfügbar sind:

Entra-Attribut

MyQ-Eigenschaft

onPremisesSamAccountName

Benutzername vor Ort

onPremisesDomainName

On-Premises-Domäne

Es ist keine zusätzliche Attributzuordnung erforderlich.

Die Werte sind in den erweiterten Eigenschaften des Benutzers verfügbar. Werden sie manuell bearbeitet, werden die manuellen Werte bei der nächsten Entra-Synchronisierung überschrieben.

Sollte eines der Attribute für einen Benutzer nicht verfügbar sein, protokolliert MyQ dies im Synchronisierungsprotokoll.

Lokale Windows-Identität

Wenn beide lokalen Attribute verfügbar sind, kann MyQ eine Windows-Identität für Vorgänge erstellen, die als lokales Konto des Benutzers ausgeführt werden müssen.

Die NetBIOS-Domäne wird aus dem ersten Label der synchronisierten DNS-Domäne abgeleitet:

Lokale Identität

Ergebnis

Domäne acme.com, Benutzer smith

acme\smith

Domäne abc.alphabet.com, Benutzer smith

abc\smith

MyQ verwendet diese Identität für unterstützte lokale Dateioperationen, die so konfiguriert sind, dass sie als der angemeldete Benutzer ausgeführt werden.

Falls MyQ die lokale Identität nicht erstellen kann:

  • Wenn die lokale Domäne nicht verfügbar ist, greift MyQ auf die Domänenauflösung des Authentifizierungsservers zurück;

  • ist der lokale Benutzername nicht verfügbar, greift MyQ auf den MyQ-Benutzernamen des Benutzers zurück.

Bei Verwendung eines Fallbacks wird eine Warnung in das Protokoll geschrieben.

Entra-Benutzer, die ausschließlich in der Cloud tätig sind und über diese Attribute nicht verfügen, sind davon nicht betroffen.