IMAP-Ereignisquelle für Exchange Online einrichten

In diesem Abschnitt wird beschrieben, wie Sie eine Microsoft Exchange Online IMAP-Ereignisquelle einrichten. Eine "IMAP-Ereignisquelle für Exchange Online" legen Sie dann an, wenn das IMAP-Postfach bei Microsoft Exchange online gehostet wird.

Wenn Sie auf ein IMAP-Postfach zugreifen möchten, das nicht bei Microsoft Exchange Online gehostet ist, finden Sie die dazugehörige Anleitung in Abschnitt Standard IMAP-Ereignisquelle einrichten

Sie haben die Möglichkeit, Vorgänge in einem E-Mail-Postfach als auslösende Ereignisse für Intrexx-Prozesse festzulegen. So können Sie beispielsweise definieren, dass beim Eingang einer E-Mail eine weitere E-Mail versendet oder ein Datensatz geschrieben wird.

Damit auslösende Ereignisse festgelegt werden können, muss der Zugriff auf das E-Mail-Postfach über IMAP eingerichtet sein.

Damit Intrexx auf das IMAP-Postfach auf Microsoft Exchange Online zugreifen kann, müssen Sie eine Reihe von Tätigkeiten in Microsoft Azure, in Microsoft Exchange Online und Intrexx ausführen. Im folgenden Schaubild finden Sie eine Übersicht der zentraler Tätigkeiten.

Microsoft Azure

Intrexx als Applikation registrieren

Schritt-für-Schritt

Um Intrexx in Microsoft Azure als Applikation zu registrieren, gehen Sie wie folgt vor:

Melden Sie sich an Microsoft Azure (https://portal.azure.com) mit Ihren Microsoft 365 Zugangsdaten an.

Sie gelangen auf die Startseite von Microsoft Azure.

Sie können über den Menüpunkt App-Registrierungen oder über Azure Active Directory Ihr Intrexx als App registrieren.

Im Folgenden finden Sie die Beschreibung über das Azure Active Directory.
Klicken Sie auf Azure Active Directory.

Sie gelangen auf die Startseite des Azure Active Directory.
Klicken Sie auf den Menüpunkt "App-Registrierungen".

Sie gelangen auf die Seite "App-Registrierungen".

Klicken Sie auf "Neue Registrierung".

Sie gelangen auf die Seite "Anwendung registrieren".

Name	Beschreibung
Name	Erfassen Sie hier den Namen, unter dem Ihr Portal in Microsoft Azure registriert wird. Sie können den Namen frei wählen. Beispiel "MailAccount -John"
Unterstützte Kontotypen	Wählen Sie hier aus, welche Kontotypen auf Intrexx zugreifen können. Vergleichen Sie hierzu auch die "Entscheidungshilfe", die Microsoft auf dieser Seite anbietet.
Umleitungs-URI (optional)	Wählen Sie in der Auswahlliste "Web" aus. Erfassen Sie hier die Umleitungs-URI. Diese setzt sich folgendermaßen zusammen: Basis-URL/service/oauth2/authorize Beispiel Die Redirect URL für die Basis-URL "https://exampleportal/" stellt sich so dar: "https:/portalexample./service/oauth2/authorize"

Name

Beschreibung

Name

Erfassen Sie hier den Namen, unter dem Ihr Portal in Microsoft Azure registriert wird. Sie können den Namen frei wählen.

Beispiel

"MailAccount -John"

Unterstützte Kontotypen

Wählen Sie hier aus, welche Kontotypen auf Intrexx zugreifen können. Vergleichen Sie hierzu auch die "Entscheidungshilfe", die Microsoft auf dieser Seite anbietet.

Umleitungs-URI (optional)

Wählen Sie in der Auswahlliste "Web" aus.
Erfassen Sie hier die Umleitungs-URI. Diese setzt sich folgendermaßen zusammen:
Basis-URL/service/oauth2/authorize

Beispiel

Die Redirect URL für die Basis-URL "https://exampleportal/" stellt sich so dar:
"https:/portalexample./service/oauth2/authorize"

Hinweis Die Basis-URL finden Sie im Hauptmenü unter "Portal > Portaleigenschaften".

Klicken Sie auf "Registrieren".

Sie gelangen auf die Seite, auf der Sie alle relevanten Informationen zur angelegten App finden.

Hier finden Sie die Client-ID () und die Mandant-ID ().

Kopieren Sie die Client-ID und die Mandant-ID.
Klicken Sie auf den Menüpunkt "Zertifikate und Geheimnisse".

Sie gelangen auf die Seite "Zertifikate und Geheimnisse".
Klicken Sie auf "Neuer geheimer Clientschlüssel".

Das Fenster "Geheimen Clientschlüssel hinzufügen" wird angezeigt.
Erfassen Sie eine Beschreibung für den geheimen Clientschlüssel und geben Sie die Gültigkeitsdauer des Clientschlüssels an.
Klicken Sie auf "Hinzufügen".

Sie gelangen zurück auf die Seite "Zertifikate & Geheimnisse".

Rechts unten wird der Geheime Clientschlüssel angezeigt.

Diesen benötigen Sie später zur Einrichtung der Ereignisquelle in Intrexx.
Kopieren Sie den geheimen Clientschlüssel.

Sie haben Intrexx in Microsoft Azure registriert.

Gleichzeitig haben Sie die Client-ID, die Tenant-ID (Mandant-ID) und den geheimen Clientschlüssel erzeugt und kopiert.

Weitere Informationen

Registrieren einer Anwendung bei Microsoft Identity Platform

Microsoft Exchange Online

Intrexx

Schritt-für-Schritt

Um eine IMAP-Ereignisquelle für Exchange Online einzurichten, gehen Sie wie folgt vor:

Öffnen Sie den Prozess, in dem Sie eine IMAP-Ereignisquelle einrichten möchten.
Markieren Sie das Element "IMAP-Ereignisquelle" und ziehen Sie es per Drag-and-drop auf die Arbeitsfläche.
Führen Sie einen Doppelklick auf das Element aus oder drücken Sie ENTER.
Der Dialog "Allgemein" wird angezeigt.

Titel

Tragen Sie hier den Titel der Ereignisquelle ein.

Beschreibung

Hier können Sie eine Beschreibung für die Ereignisquelle erfassen.

Mehrsprachigkeit

Sie können Texte mehrsprachig erfassen.

Detaillierte Informationen hierzu finden Sie in Abschnitt Mehrsprachige Portale
Klicken Sie auf "Weiter".

Sie gelangen in den Dialog "Ereignisquellentyp".
Markieren Sie "Exchange Online".

Standard IMAP

Wenn Sie eine "Standard IMAP Ereignisquelle" einrichten möchten , finden Sie die entsprechende Anleitung in Abschnitt Standard IMAP-Ereignisquelle einrichten.
Klicken Sie auf "Weiter".

Sie gelangen in den Dialog "E-Mail-Server".

In diesem Dialog müssen Sie die Angaben aus Microsoft Azure hinterlegen (Microsoft Azure).

Ab Intrexx Version 12.0.0

Standard IMAP

Wenn Sie eine "Standard IMAP Ereignisquelle" einrichten möchten , finden Sie die entsprechende Anleitung in Abschnitt Standard IMAP-Ereignisquelle einrichten.

Mandant (Tenant)

Erfassen Sie hier die Tenant ID. Diese finden Sie in Microsoft Azure im Feld "Verzeichnis-ID (Mandant)" ().

Benutzerprinzipalname (User Principal Name)

Erfassen Sie hier den Benutzerprinzipalnamen eines Benutzers ein, der Zugriff auf Microsoft Exchange Online bzw. das entsprechende Postfach hat.

Anwendungs-ID (Client ID)

Erfassen Sie hier die Anwendungs-ID (Client-ID). Diese finden Sie in Microsoft Azure im Feld "Anwendungs-ID (Client-ID)" ().

Anwendungsgeheimnis (Client secret)

Erfassen Sie hier den Wert (!) des Geheimen Clientschlüssels. Diesen finden Sie in Microsoft Azure unter dem Menüpunkt "Zertifikate & Geheimnisse". Detaillierte Informationen hierzu finden Sie in Abschnitt Geheimen Clientschlüssel erzeugen.

Ab Intrexx Version 12.0.0

Wenn Sie auf den nach unten gerichteten kleinen Pfeil rechts neben dem Schlüsselsymbol klicken, wird ein Menü geöffnet, in dem Sie auswählen können, ob das Passwort mit dem Prozess gespeichert oder aus dem Anmeldeinformationsspeicher bezogen werden soll .Wenn Sie "Aus Anmeldeinformationsspeicher" auswählen, ändert sich das Schlüsselsymbol und das Eingabefeld für das Passwort wird zur Auswahlliste, aus der Sie das gewünschte Credential auswählen können. Im Prozess wird dann der Name des Credentials gespeichert.

Alle weiteren Informationen zum Intrexx Credential Store und der Verwendung von Credentials in Prozesselementen finden Sie hier.

Ordnerpfad

Geben Sie hier den Pfad des Ordners an, den Sie überwachen wollen. Das Wurzelverzeichnis eines IMAP-Postfachs heißt in der Regel INBOX. Die Namen von Ordnern sowie das Pfadtrennzeichen hängen vom eingesetzten IMAP-Serverprodukt und auch von dessen Konfiguration ab.
Klicken Sie auf "Weiter".
Sie gelangen in den Dialog "Optionen".

Pollingintervall

Geben Sie hier das Intervall an, in dem der Server abgefragt werden soll. In der Auswahlliste können Sie die Zeiteinheit in Millisekunden, Sekunden, Minuten oder Stunden festlegen.

Filter für Auswahl der E-Mails

Hier können Sie einstellen, welche E-Mails ausgewählt werden sollen.
- nur ungelesene E-Mails
- nur gelesene E-Mails
- Alle E-Mails
Wenn in der IMAP-Ereignisquelle der Zustand der verarbeiteten E-Mails nicht über eine abschließende Aktion im Konfigurationsdialog oder per Groovy-Skript so verändert wird, dass die Filterbedingung nicht mehr zutrifft, so wird das IMAP-Ereignis immer wieder für die erste Mail aus der Ergebnismenge der Abfrage ausgeführt - und zwar nicht erst beim nächsten Zeitpunkt gemäß Pollingintervall, sondern sofort. Es ist beabsichtigt, dass im Dialog keine abschließende Aktion zwingend ausgewählt werden muss. Eine abschließende Aktion sollte dann aber unbedingt per Groovy ausgeführt werden. Es ist sicherzustellen, dass nach Ausführung des Prozesses die Filterbedingung für die Auswahl der E-Mails auf die verarbeiteten E-Mails nicht mehr zutrifft. Die Bedingung setzt sich zusammen aus Ordnerpfad und Filter. Es ist also immer ausreichend, eine E-Mail in einen anderen Ordner zu verschieben oder zu löschen. Ebenfalls ausreichend ist es z.B. Mails als gelöscht zu markieren. Werden ungelesene E-Mails gefiltert, ist es ausreichend, sie als gelesen zu markieren.

Abschließende Aktionen auf dem E-Mail-Server ausführen

Als gelesen markieren

Die gefilterten E-Mails werden als gelesen markiert.

Verschieben

Verschiebt die E-Mails in hier festgelegten Ordnerpfad.

Ordnerpfad

Tragen Sie hier den Pfad ein, in den die E-Mails verschoben werden sollen.

Als gelöscht markieren

Die gefilterten E-Mails werden als gelöscht markiert.

Endgültig löschen

Die gefilterten E-Mails werden gelöscht.
Folgende Einstellungen haben massive Auswirkungen auf den Inhalt des gewählten Ordners:
- Verschieben
- Als gelöscht markieren
- Endgültig löschen
Wir empfehlen diese Einstellungen nur bei speziell für diesen Zweck eingerichteten Postfächern. Für Fehler, die aus einer falschen Einstellung resultieren, übernimmt United Planet keine Haftung.
IMAP-Provider-Einstellungen

Hier können die Provider-Einstellungen konfiguriert werden.

IMAP-Provider-Einstellungen bearbeiten

Öffnet einen Dialog, in dem die Einstellungen bearbeitet werden können.

Name

Hier wird der Name der IMAP-Provider-Einstellung angezeigt.

Wert

Hier wird der Wert der IMAP-Provider-Einstellung angezeigt.

Eintrag hinzufügen

Legt eine neue Zeile an. In der Spalte "Name" kann eine Einstellung ausgewählt oder direkt eingetragen werden. Der Wert kann mit Doppelklick in die entsprechende Zelle eingetragen werden.

Eine Übersicht über die möglichen Einträge finden Sie unter folgendem Link: Package com.sun.mail.imap

Eintrag löschen

Entfernt die aktuell markierte Einstellung aus der Liste.

Informationen zu den IMAP-Provider-Einstellungen finden Sie hier.

Zugriff auf freigegebene Postfächer

Um auf mit der IMAP-Ereignisquelle auf freigegebene Postfächer zuzugreifen, fügen Sie hier die beiden folgenden Parameter mit dem Wert "true" hinzu.
- mail.imaps.auth.plain.disable
- mail.imaps.auth.ntlm.disable
Mit Administratorberechtigung ausführen

Mit dieser Einstellung werden die Aktionen des Prozesses mit den entsprechenden Rechten ausgeführt.
Klicken Sie auf "Weiter".

Sie gelangen in den Dialog "Benutzerauswahl".

Hier muss ein Benutzer festgelegt werden, in dessen Kontext die Ereignisquelle ausgeführt wird.

Standard-Benutzer aus den Portaleigenschaften

Wenn kein bestimmter Benutzer ausgewählt ist, wird mit dieser Option automatisch der Benutzer verwendet, der in den Portaleigenschaften definiert ist.

Statischer Benutzer

Hier wird ein fester Benutzer bestimmt.

Benutzer auswählen

Öffnet einen Dialog, in dem ein Benutzer ausgewählt werden kann.

Benutzer aus Systemwert

Der Benutzer kann auch aus einer Systemdatengruppe ermittelt werden.

Systemwert bearbeiten

Öffnet einen Dialog, in dem ein Wert aus einer Systemdatengruppe referenziert werden kann.
Klicken Sie auf "Weiter".

Sie gelangen in den Dialog "Verbindungstest".

Test

Ein Klick auf diese Schaltfläche startet den Verbindungstest.
Klicken Sie auf "OK".

Ihre nächsten Schritte

IMAP-Ereignisbehandler einrichten

Weitere Informationen

Standard IMAP-Ereignisquelle einrichten