Microsoft Exchange-Datenquelle hinzufügen - OAuth2

Voraussetzungen

Sie haben das Intrexx MediaGateway installiert.

Detaillierte Informationen hierzu finden Sie in Abschnitt MediaGateway-Installation.

Schritt-für-Schritt

Um im Intrexx Portal Manager eine Microsoft Exchange-Datenquelle hinzuzufügen und die Authentifizierung über OAuth2 einzurichten, gehen Sie wie folgt vor:

  1. Starten Sie das Menü "Integration".

  2. Markieren Sie unter "Daten konsumieren" den Punkt "Connector für Microsoft Exchange".

  3. Führen Sie einen Rechtsklick aus und wählen Sie im Kontextmenü "Neue Datenquelle" aus.

    Das Dialogfenster "Neue Datenquelle - Allgemein" wird angezeigt.

    MediaGateway-Verbindung einrichten

    Verbindungsname

    Unter dem Namen, den Sie hier eintragen, können Sie die Verbindung später in Applikationen auswählen.

    Host, Port, Zeitzone

    Tragen Sie hier die Host, Port und Zeitzone des MediaGateway-Servers ein.

    In der Regel verwendet das MediaGateway für Verbindungen den Port 8087 sowie Port 9087 für SSL-verschlüsselte Verbindungen.

    gRPC anstatt COBRA (klassisch) verwenden

    Wenn Sie dieses Kontrollkästchen aktivieren, wird das gRPC Framework verwendet. Die INTREXX GmbH empfiehlt den Einsatz dieser Option.

    Wenn Sie dieses Kontrollkästchen nicht aktivieren, wird (weiterhin) das CORBA Framework verwendet.

    Weitere Informationen

    SSL verwenden

    Wenn Sie dieses Kontrollkästchen aktivieren, wird die Kommunikation zwischen dem Media Gateway Server und dem Exchange Server verschlüsselt.

    SSL-Port

    Hinterlegen Sie hier den Port auf dem Media Gateway Server, über den die verschlüsselte Verbindung erfolgen soll.

    Passwort / Passwort ändern

    Bei der Neuanlage der Microsoft Exchange Datenquelle müssen Sie hier das Passwort zum Intrexx MediaGateway hinterlegen. Das Passwort zum Intrexx MediaGateway haben Sie während der Installation vergeben.

    Sie sollten das Standard-Passwort ändern. Dies können Sie hier tun, nachdem die Datenquelle angelegt wurde.

    Weitere Informationen

    MediaGateway-Verbindung einrichten

  4. Klicken Sie auf "Weiter".

    Das Dialogfenster "Neue Datenquelle - Exchange-Version" wird angezeigt.

    Microsoft Exchange Version auswählen

    Version Microsoft Exchange Server

    Wählen Sie hier die Version Ihres Exchange-Servers aus. Von Intrexx-MediaGateway unterstützt werden Microsoft Exchange Server 2003 oder 2007 und Microsoft Exchange Server 2010 oder höher.

    Wählen Sie die Option "Microsoft Exchange Server 2010-2019 oder 365", wenn Sie Microsoft Exchange Online einsetzen.

  5. Klicken Sie auf "Weiter".

    Das Dialogfenster "Neue Datenquelle - Authentifizierung" wird angezeigt.

    OAuth2 als Authentifizierungsart auswählen

  6. Wählen Sie "OAuth2 (nur mit MS365)" aus.

    Exchange-Benutzername / Mailbox / Server-URL

    Klicken Sie auf einen der Einträge, um festzulegen, welche Angaben bei der Anmeldung an Microsoft Exchange bereits vorbelegt sein sollen und welche Angaben der Anwender selbst manuell eingeben muss.

    (Screenshot zeigt den Dialog für die Konfiguration des Exchange-Benutzernamens.)

    Wert aus Abfrage im Web

    Verwendet den Benutzernamen, den ein Benutzer in der Loginbox einer Intrexx Exchange-Applikation einträgt.

    Statischer Wert

    Hier kann ein fester Wert hinterlegt werden, der dann automatisch in der Loginbox eingetragen ist, wenn sich ein Anwender anmelden will.

    Wert aus Benutzerverwaltung

    Hier können Sie ein Feld aus dem Modul "Benutzer" auswählen, dessen Wert in der Loginbox eingetragen wird. Dabei ermittelt Intrexx den aktuell angemeldeten Benutzer und liefert die entsprechenden Daten.

    Wert im Web anzeigen

    Diese Einstellung kann gesetzt werden, wenn die Option "Statischer Wert" oder die Option "Wert aus Benutzerverwaltung" ausgewählt ist. Damit wird dann der entsprechende Wert in der Loginbox im Web angezeigt, wenn sich der Anwender anmeldet.

    Verwaltung

    Übersicht bekannter Benutzer

    Öffnet einen Dialog, in dem Sie eine Liste der Benutzer im MediaGateway finden. Dieser Link ist aktiv, wenn bereits MediaGateway-Konten angelegt sind, weil sich Benutzer angemeldet haben.

    Übersicht bekannter Benutzer

    Öffnet einen Dialog, in dem Sie eine Liste der Benutzer im MediaGateway finden. Dieser Link ist aktiv, wenn bereits MediaGateway-Konten angelegt sind, weil sich Benutzer angemeldet haben.

    Anmeldedaten im Web sitzungsbasiert abfragen

    Dieses Kontrollkästchen ist bei der Authentifizierungsart "OAuth2 (nur mit MS365)" nicht relevant.

  7. Klicken Sie auf "Weiter".

    Das Dialogfenster "Neue Datenquelle - Exchange-Konto" wird angezeigt.

    Zugangsdaten und OAuth2-Daten erfassen

    Benutzername, Passwort

    Geben Sie hier die Zugangsdaten zu einem im Microsoft Exchange-Server angelegten Benutzer-Postfach sein. Das Konto erfordert keinerlei Berechtigungen. Der Connector für Microsoft Exchange verwendet dieses Konto für die Anforderung von Meta-Informationen des Microsoft Exchange-Servers, die dann beim Erstellen von Applikationen zur Verfügung stehen und Informationen über Datenfelder, Feldtypen oder bestehende Tabellen liefern.

    E-Mail

    Geben Sie hier den Namen des Exchange-Postfachs bzw. die E-Mail Adresse an. Verwenden Sie möglichst eine primäre Postfachadresse. Bei der Verwendung von Alias-Adressen ist der Funktionsumfang des Connectors u.U. eingeschränkt.

    Server (URL)

    Tragen Sie hier die URL des Microsoft Exchange-Servers ein, der die Client Access Rolle einnimmt (z.B. der OWA Server).

    Beim Exchange Server kann es sich um einen Server handeln, den Sie selber hosten oder um Microsoft Exchange Online.

    Beispiel

    • Selbst gehosteter Exchange Server ab Exchange 2010

      https://mailserver.meinefirma.de/ews/Exchange.asmx

      In der Regel beginnt die URL mit dem Protokoll https, gefolgt vom voll qualifizierten Servernamen und /ews/Exchange.asmx (ab Exchange 2010).

    • Microsoft Exchange Online

      https://outlook.office365.com/ews/Exchange.asmx

    MS365 OAuth2 Konfiguration

    In diesem Bereich müssen Sie die Angaben aus Microsoft Azure hinterlegen.

    Tenant ID

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

    Client ID

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

    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.

    Redirect URI

    Die Redirect-URi setzt sich folgendermaßen zusammen:

    <Basis-URL>/oauth2/token/msexchange

    Die Redirect URL für die Basis-URL "https:/exampleportal.com/" stellt sich so dar:

    https:/exampleportal.com/oauth2/token/msexchange

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

    MS365 Refresh Token anfordern

    Für die Anmeldung an Microsoft Exchange benötigen Sie einen so genannten Access Token (Zugriffstoken). Dieser wird bei der Anmeldung an Microsoft Exchange automatisch generiert. Access Tokens sind aus Sicherheitsgründen nur ca. 1 Stunde gültig. Danach wird automatisch ein neuer Access Token generiert. Dies geschieht mit Hilfe des so genannten Refresh Tokens (Aktualisierungstoken). Diesen müssen Sie manuell im Connector für Microsoft Exchange auf der Registerkarte "Exchange-Konto" anfordern. Dies müssen Sie für den Benutzer, den Sie beim Anlegen der Datenquelle verwenden ().

    Außerdem müssen Sie dies für die zusätzlichen Benutzer, die Sie in Applikationen und Prozessen verwenden, durchführen ().

    Der Refresh Token wird im MediaGateway hinterlegt. Er ist für 3 Monate gültig. Anschließend muss er manuell neu angefordert werden.

    Eine detaillierte Schritt-für-Schritt-Anleitung für das Anfordern eines MS365 Refresh Tokens finden Sie in Abschnitt MS365 Refresh Token (Aktualisierungstoken) anfordern.

  8. Klicken Sie auf "Weiter".

    Das Dialogfenster "Neue Datenquelle - Zusätzliche Benutzer" wird angezeigt.

    Zusätzliche Benutzer zuordnen

    In diesem Dialog können Sie Intrexx-Benutzer einem Exchange-Benutzer zuordnen.

    Schritt-für-Schritt

    Um einen Intrexx-Benutzer einem Exchange-Benutzer zuzuordnen, gehen Sie wie folgt vor:

    1. Klicken Sie auf (Hinzufügen)

      Das Dialogfenster "Benutzerzuordnung" wird angezeigt.

    2. Klicken Sie auf (Benutzer auswählen).

    3. Wählen Sie im Folgedialog den gewünschten Benutzer aus.

    4. Erfassen Sie die erforderlichen Angaben. (Vergleichen Sie hierzu das Dialogfenster "Neue Datenquelle - Exchange-Konto" weiter oben.)

    5. Fordern Sie einen MS365 Refresh Token an.

      Eine detaillierte Schritt-für-Schritt-Anleitung für das Anfordern eines MS365 Refresh Tokens finden Sie in Abschnitt MS365 Refresh Token (Aktualisierungstoken) anfordern.

    6. Klicken Sie auf "OK".

      Sie gelangen zurück in das Dialogfenster "Neue Datenquelle - Zusätzliche Benutzer".

  9. Klicken Sie auf "Weiter".

    Das Dialogfenster "Neue Datenquelle - Verbindungstest" wird angezeigt.

    Verbindungstest durchführen

  10. Führen Sie einen Klick auf die einzelnen Verbindungstests aus.

    Bei erfolgreich verlaufenen Verbindungstests stellt sich das Dialogfenster so dar.

  11. Klicken Sie auf "OK".

    Sie gelangen zurück in das Modul "Design".

    Die neu angelegte Datenquelle wird angezeigt.

Weitere Informationen

MS365 Refresh Token (Aktualisierungstoken) anfordern