Skip to main content
Skip table of contents

Microsoft Exchange Online-Einrichtung

Richten Sie zunächst Microsoft Exchange Online in Microsoft Azure ein und konfigurieren Sie es anschließend in MyQ.


Voraussetzung: SMTP AUTH

MyQ X versendet E-Mails über SMTP mit OAuth (XOAUTH2). Diese Methode erfordert, dass SMTP AUTH in Exchange Online aktiviert ist.

Wenn SMTP AUTH auf Mandanten- oder Postfachebene deaktiviert ist, funktioniert SMTP auf OAuth-Basis nicht und MyQ X kann keine E-Mails senden.


Einrichtung von Microsoft Exchange Online in Microsoft Azure

  1. Melden Sie sich beim Microsoft Azure-Portal an und gehen Sie zu „App-Registrierungen”.

    MS Azure - App registrations
  2. Erstellen Sie eine neue Registrierung:

    Creating a new registration
  3. Erstellen Sie eine Azure-Anwendung:

    1. Name – Der Name für diese Anwendung (kann später geändert werden). Beispiel: MS Exchange Online. Es ist wichtig, denselben Namen zu verwenden, der auch in MyQ unter „Verbindungen“ verwendet wird.

    2. Unterstützte Kontotypen – Wer kann diese Anwendung verwenden oder auf diese API zugreifen? Wählen Sie die Option „Nur Konten in diesem Organisationsverzeichnis (nur {Tenant-Name} – Single Tenant)“. Je nach Zielgruppe der Anwendung (welches Konto für die Autorisierung in MyQ verwendet wird) kann bei Bedarf auch eine mandantenfähige Anwendung verwendet werden.

    3. Umleitungs-URI (optional) – Die Authentifizierungsantwort wird nach erfolgreicher Authentifizierung des Benutzers an diese URL zurückgesendet. Wählen Sie die Option „Öffentlicher Client/nativ (Mobil & Desktop)“ aus der Dropdown-Liste aus und geben Sie https://login.microsoftonline.com/common/oauth2/nativeclient als Umleitungs-URI ein.

    4. Klicken Sie auf „Registrieren“.

      MS Azure - new app registration properties
  4. Die neue App-Übersichtsseite wird geöffnet. Kopieren Sie die Anwendungs-ID (Client-ID) und die Verzeichnis-ID (Tenant-ID), da diese für die Verbindung mit MyQ benötigt werden.

    MS Azure - new app overview
  5. Klicken Sie im Menü auf der linken Seite auf „Authentifizierung“. Wählen Sie unter „Erweiterte Einstellungen“ unter „Öffentliche Client-Flows zulassen“ neben „Folgende Mobil- und Desktop-Flows aktivieren“ die Option „Ja“ aus und klicken Sie dann oben auf „Speichern“.

    MS Exchange Online authentication settings
  6. Klicken Sie im Menü auf der linken Seite auf „API-Berechtigungen“ und fügen Sie die zusätzlichen Berechtigungen hinzu, die für die korrekte Funktionalität erforderlich sind:

    1. Microsoft Graph: offline_access – Ermöglicht der App, die Daten, auf die Sie ihr Zugriff gewährt haben, anzuzeigen und zu aktualisieren, auch wenn Sie die App gerade nicht verwenden. Dadurch erhält die App keine zusätzlichen Berechtigungen.

    2. Microsoft Graph: User.Read – Anmelden und Benutzerprofil lesen.

    3. Microsoft Graph: IMAP.AccessAsUser.All – Ermöglicht der App das Lesen, Aktualisieren, Erstellen und Löschen von E-Mails in Ihrem Postfach. Beinhaltet keine Berechtigung zum Senden von E-Mails.

    4. Microsoft Graph: SMTP.Send – Ermöglicht es der App, in Ihrem Namen E-Mails aus Ihrem Postfach zu versenden.

image-20250317-153320.png

Microsoft Exchange Online-Einrichtung in MyQ

  1. Melden Sie sich bei der MyQ-Webadministratoroberfläche an und gehen Sie zu MyQ, Einstellungen, Verbindungen.

  2. Klicken Sie auf „+ Hinzufügen“ und wählen Sie „Microsoft Exchange Online“.

    Adding MS Exchange Online
  3. Füllen Sie im Popup-Fenster die erforderlichen Felder aus:

    image-20250317-121002.png
    1. Titel – Fügen Sie den Namen hinzu, den Sie bei der App-Registrierung in MS Azure gewählt haben, z. B. MS Exchange Online.

    2. Verzeichnis-ID (Tenant-ID) – Die Verzeichnis-ID, die Sie während der Einrichtung von MS Azure kopiert haben.

    3. Anwendungs-ID (Client-ID) – Die Anwendungs-ID, die Sie während der Einrichtung von MS Azure kopiert haben.

  4. Klicken Sie auf „OK“.

  5. Nachdem Sie die Verbindung in MyQ eingerichtet haben, werden Sie aufgefordert, einen Code über die Microsoft-Website (https://microsoft.com/devicelogin) zu bestätigen. Der Code, den Sie bestätigen müssen, wird im Popup-Fenster direkt unter dem Link zur Microsoft-Website angezeigt. Für die Bestätigung des Codes gibt es ein Zeitlimit (in der Regel 15 Minuten).

Die E-Mail-Funktion ist erst nach erfolgreicher Bestätigung verfügbar.

Die Bestätigung muss über das Microsoft-Konto erfolgen, das Eigentümer der E-Mail-Adresse ist, die für die Verbindung mit Exchange verwendet wird (Absender-E-Mail in MyQ, Einstellungen, Registerkarte „Netzwerk“).

Wenn Sie beispielsweise die Absender-E-Mail-Adresse „print@somedomain.com“ verwenden, müssen Sie sich in diesem Schritt auf der Microsoft-Website als dieser Benutzer authentifizieren.

Microsoft Exchange Online ist nun mit MyQ verbunden und kann in der Registerkarte „Netzwerkeinstellungen“ als ausgehender SMTP-Server verwendet werden.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.