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

Mit Microsoft Entra ID verbinden

Verbinden Sie MyQ X über die Microsoft Graph-API mit Microsoft Entra ID, um Benutzer und Gruppen zu synchronisieren und MyQ-Benutzer mit ihrer Microsoft-Identität zu authentifizieren. Die Verbindung kann genutzt werden für:

  • die Synchronisierung von Benutzern und Gruppen aus Microsoft Entra ID

  • die Authentifizierung von Benutzern gegenüber Microsoft Entra ID

  • Anmeldung mit Microsoft

  • Nahtloses SSO mit dem MyQ Desktop Client

Sie können die erforderliche Microsoft-Anwendung automatisch über MyQ erstellen oder MyQ mit einer Anwendungsregistrierung verbinden, die Sie manuell verwalten.

Microsoft Entra ID, OneDrive for Business und SharePoint Online können dieselbe manuell registrierte Anwendung nutzen. Wenn Sie diese Integrationen gemeinsam nutzen möchten, konfigurieren Sie die Anwendung mit den dafür erforderlichen kombinierten Berechtigungen.

Erstellen einer Microsoft Entra ID-Verbindung

  1. Gehen Sie zu MyQ > Einstellungen > Verbindungen.

  2. Klicken Sie auf Hinzufügen und wählen Sie Microsoft Entra ID aus der Liste aus.

    connections-settings-entraid-auto.png


  3. Geben Sie einen Titel für Ihre Verbindung ein und wählen Sie den gewünschten Modus aus:

    • Automatisch erstellen: MyQ X konfiguriert die Entra-Anwendung, die für den Zugriff auf Entra ID-Benutzerdaten erforderlich ist.

    • Manuell einrichten: Konfigurieren Sie die Entra-Anwendung manuell. Wählen Sie diese Option, wenn Sie alle Aspekte der Integrationskonfiguration selbst verwalten möchten.

  4. Fahren Sie mit dem entsprechenden Abschnitt weiter unten fort.

Automatisch erstellen

Melden Sie sich während der Einrichtung mit einem Microsoft-Konto an, das über die erforderlichen Berechtigungen zum Erstellen und Konfigurieren der Connector-Anwendung verfügt.

INCLUDE_START: "(v2) Microsoft Entra App Reference" | ID: 3126001665 | Type: excerpt | Excerpt: "ms-entra-registration-models" | Depth: 0

Integration

Einrichtung

Registrierungsmodell

Client-Geheimnis

Öffentlicher Client-Flow

Microsoft Entra ID / Microsoft Graph

Automatisch oder manuell

Gemeinsam genutzt oder dediziert

Ja

Nein

OneDrive für Unternehmen

Automatisch oder manuell

Gemeinsam genutzt mit Entra ID/SharePoint oder dediziert

Ja

Nein

SharePoint Online

Automatisch oder manuell

Gemeinsam genutzt mit Entra ID/OneDrive oder eigenständig

Ja

Nein

Exchange Online

Manuell

Dediziert

Nein

Ja

Universal Print

Manuell

Dediziert

Nein

Ja


MyQ erstellt die Connector-Anwendung und konfiguriert sie mit den für die ausgewählte Integration erforderlichen Laufzeitberechtigungen. Schließen Sie den Microsoft-Autorisierungsvorgang ab und speichern Sie die Verbindung.

Sie können während der Einrichtung auch die entsprechende Synchronisationsquelle für die Benutzersynchronisierung erstellen und die Option Mit Microsoft anmelden aktivieren.

Siehe auch: Automatic Microsoft Entra App Registration

Manuell einrichten

Wählen Sie Manuell einrichten, wenn Ihre Organisation die Registrierung von Microsoft Entra-Anwendungen direkt verwaltet. Sie können dieselbe Anwendungsregistrierung für Microsoft Entra ID, OneDrive for Business und SharePoint Online verwenden oder für jeden Dienst eine eigene Anwendung einrichten. Die gemeinsam genutzte Anwendung muss die Berechtigungen enthalten, die für alle Integrationen erforderlich sind, die sie nutzen.

Siehe Manual Microsoft Entra App Registration.

Integration

Einrichtung

Registrierungsmodell

Client-Secret

Öffentlicher Client-Flow

Microsoft Entra ID / Microsoft Graph

Automatisch oder manuell

Gemeinsam genutzt oder dediziert

Ja

Nein

OneDrive für Unternehmen

Automatisch oder manuell

Gemeinsam genutzt mit Entra ID/SharePoint oder dediziert

Ja

Nein

SharePoint Online

Automatisch oder manuell

Gemeinsam genutzt mit Entra ID/OneDrive oder eigenständig

Ja

Nein

Exchange Online

Manuell

Dediziert

Nein

Ja

Universal Print

Manuell

Dediziert

Nein

Ja


Geben Sie anschließend Ihre Microsoft Entra-App-Daten in MyQ ein und speichern Sie die Verbindung.

  • Titel: Ein Titel für die Verbindung.

  • Mandanten-ID (Entra-App): Die Mandanten-ID Ihrer Entra-App.

  • Applikations-ID: Die Applikations-ID Ihrer Entra-App.

  • Sicherheitsschlüssel: Das Client-Geheimnis der Entra-App.

connections-settings-entraid-manual.png

Benutzersynchronisierung konfigurieren

Durch das Erstellen der Entra-ID-Verbindung werden noch keine Benutzer importiert.

Um Benutzer und Gruppen zu synchronisieren, erstellen Sie unter MyQ > Einstellungen > Benutzersynchronisierung eine Microsoft Entra ID-Synchronisationsquelle und wählen Sie die von Ihnen erstellte Verbindung aus.

Siehe auch: Benutzer aus Microsoft Entra ID synchronisieren

Authentifizierung konfigurieren

Um Benutzer mit Microsoft Entra ID zu authentifizieren, konfigurieren Sie den entsprechenden Authentifizierungsserver und ordnen Sie ihn der Entra ID-Verbindung zu.

Je nach Ihrer Umgebung können Sie außerdem Folgendes verwenden:

  • Anmeldung mit Microsoft

  • Nahtloses SSO für den MyQ Desktop Client

Die erforderlichen Authentifizierungsbereiche und Umleitungs-URIs sind separat aufgeführt.

Siehe auch: Microsoft Entra App Reference

Erneute Autorisierung der Entra-ID-Verbindung

Verwenden Sie die Option Erneut autorisieren, um den Microsoft-Autorisierungsvorgang für eine bestehende Verbindung zu wiederholen.

Durch die erneute Autorisierung kann:

  • die Zustimmung des Administrators nachholen, die bei der Ersteinrichtung nicht erteilt wurde

  • ein neues Client-Geheimnis erstellen

  • eine gelöschte Unternehmensanwendung neu erstellen

  • die Verbindung zwischen automatischer und manueller Konfiguration umstellen

Die erneute Autorisierung aktualisiert die bestehende Unternehmensanwendung, sofern diese noch vorhanden ist. Es wird kein Duplikat erstellt.

Um die Autorisierung zu erneuern, klicken Sie mit der rechten Maustaste auf die Verbindung. Dadurch wird das Dialogfeld Verbindung erstellen geöffnet. Sie können alle Schritte wiederholen, um einen neuen geheimen Schlüssel für die bestehende Verbindung zu erstellen.


Mehrere Microsoft Entra-Mandanten

MyQ kann eine Verbindung zu mehreren Microsoft Entra-Mandanten herstellen. Erstellen Sie für jeden Mandanten eine separate Verbindung und weisen Sie jeder Verbindung die entsprechende Synchronisationsquelle sowie die Authentifizierungskonfiguration zu.

Nächste Schritte

Sie können nun die Synchronisierung und Authentifizierung über Microsoft Entra ID mit Microsoft Graph konfigurieren.