Zum Inhalt springen

Microsoft Exchange Verbindungshandbuch für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zum Anschließen App Builder TM zu Microsoft Exchange als Datenserver. Diese Verbindung nutzt den OAuth-Flow für Clientanmeldeinformationen.

Client-Anmeldeinformationen beziehen sich auf einen Ablauf in OAuth, bei dem keine direkte Benutzerauthentifizierung stattfindet. Stattdessen werden Anmeldeinformationen nur für die App selbst erstellt. Alle von der App ausgeführten Aufgaben werden ohne einen Standardbenutzerkontext ausgeführt. Dadurch unterscheidet sich der Authentifizierungsablauf etwas vom Standard. Alle Berechtigungen im Zusammenhang mit dem Client-OAuth-Ablauf erfordern die Zustimmung des Administrators.

Systemanforderungen

Microsoft Exchange

  • Azure Portal

Client-Webbrowser

Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

Kante: 84+

Einschränkungen und unterstützte Funktionen

Bei der SQL Server-Datenbank kann es Einschränkungen hinsichtlich der Primärschlüssel-IDs von Microsoft Exchange geben. Der Primärschlüssel ist eine lange alphanumerische Zeichenfolge und durchläuft bei neuen Emails schrittweise die Nummern a bis z, 0-1, AZ. Das Problem dabei ist, dass SQL Server standardmäßig nicht zwischen Groß- und Kleinschreibung unterscheidet, sodass zwei Emails mit den Primärschlüsseln „1234a“ und „1234A“ gleich sind. App Builder. Eine Problemumgehung besteht darin, die Spalte changeKey zu nutzen, die in Kombination mit id immer eindeutig ist.

Anschlussanleitung

Voraussetzungen für die Konfiguration im Azure-Portal

Vor der Konfiguration der Microsoft Exchange Data Server-Verbindung in App Builder müssen Sie zuerst die folgenden Informationen in Ihrem Azure-Portal konfigurieren.

  • Erstellen Sie eine benutzerdefinierte OAuth-App im Azure-Portal: https://cdn.cdata.com/help/CEH/ado/pg_oauthcustomappcreate.htm

  • Wählen Sie bei der App-Registrierung im Abschnitt Authentifizierung Zugriffstoken (für implizite Flows verwendet) aus.

    Anhang

  • Navigieren Sie zu Zertifikate & Geheimnisse und erstellen Sie einen Client-Geheimnis-Wert

    Hinweis

    Achten Sie darauf, den Wert des Client-Geheimnisses zu kopieren und an einem Ort zu speichern, an dem Sie darauf zugreifen können*, wenn Sie das App Builder Schritte.

    Anhang

  • Navigieren Sie zu API Berechtigungen und wählen Sie Microsoft Graph-Berechtigungen. Es gibt zwei verschiedene Berechtigungssätze: Delegierte und Anwendungsberechtigungen. Die während der Client-Anmeldeauthentifizierung verwendeten Berechtigungen finden Sie unter Anwendungsberechtigungen. Wählen Sie die entsprechenden Berechtigungen aus, die Sie für Ihre Integration benötigen.

  • Konfigurieren Sie die folgenden API Berechtigungen und erteilen Sie die Administratorzustimmung für diese Berechtigungen.

    Anhang

Konfigurieren in App Builder

Erstellen eines OAuth-Sicherheitsanbieters

  1. Navigieren Sie zu App Builder IDE

  2. Klicken Sie auf die Schaltfläche Sicherheitsanbieter

  3. Klicken Sie auf die Schaltfläche + Benutzerauthentifizierung

  4. Weisen Sie dem Namen einen identifizierbaren Namen zu. Beispiel: Microsoft Exchange Connector

  5. Stellen Sie den Typ auf OAuth ein

  6. Stellen Sie den Authentifizierungstyp auf OAuth ein

  7. Setzen Sie den OAuth-Grant auf Client-Anmeldeinformationen

  8. Stellen Sie die OAuth-Client-Authentifizierung auf Basic

  9. Setzen Sie die OAuth-Ressourcenauthentifizierung auf Bearer

  10. Setzen Sie den Token-Besitzer auf Client

  11. Klicken Sie auf die Schaltfläche + Endpoint und erstellen Sie einen Datensatz:

    • Typ = Token-Endpoint

    • URL = https://login.microsoftonline.com/{{ TenantID }}/oauth2/v2.0/token

    Notiz

    Ersetzen Sie die TenantID im angegebenen URL String entsprechend

    Anhang

  12. Klicken Sie auf die Schaltfläche + Anmeldeinformationen und erstellen Sie einen Datensatz mit dem in Azure erstellten Anwendungs-ID-Wert (Client-ID). Diese Informationen werden auf der Übersichtsseite der Azure-Anwendung gespeichert:

    1. Setzen Sie den Typ auf Client

    2. Geben Sie den Benutzernamen ein. Dies ist der Wert der Anwendungs-ID (Client-ID), der auf der Übersichtsseite der Azure-Anwendung zu finden ist.

    3. Geben Sie das Passwort ein. Dies ist der zuvor erstellte Client Secret-Wert.

    4. Klicken Sie auf die Schaltfläche Speichern

    Anhang

  13. Klicken Sie auf die Schaltfläche + Eigenschaft und erstellen Sie einen Scopes-Datensatz:

    • Setzen Sie den Parameter auf Scopes

    • Setzen Sie den Wert auf den Standardberechtigungswert für Microsoft Graph

    Anhang

  14. Aktivieren Sie das Feld Aktiviert in den Anbietereinstellungen, um dies als Sicherheitsanbieter zu aktivieren

Erstellen des Microsoft Exchange Datenservers

  1. Navigieren Sie zu App Builder IDE

  2. Klicken Sie auf die Schaltfläche Datenserver

  3. Klicken Sie auf die Schaltfläche + Server

  4. Vergeben Sie einen Servernamen. Beispiel: Exchange Driver

  5. Stellen Sie den Typ auf Microsoft Exchange ein.

    Anhang

  6. Klicken Sie auf Sicherheitseinstellungen, um sie zu erweitern

  7. Stellen Sie den Sicherheitsanbieter auf den von uns erstellten Sicherheitsanbieter ein. Beispiel: Microsoft Exchange Connector

  8. Klicken Sie auf die Schaltfläche Speichern

  9. Klicken Sie auf Servereinstellungen, um sie zu erweitern

  10. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen

  11. Im Feld Erweitert müssen Sie einen Benutzer aus dem Mandanten angeben, der auf Outlook-Ressourcen zugreifen soll. Das Format sollte sein: UserID={{ UserEmail }}

    • Wenn Sie mehrere Mandanten konfiguriert haben, müssen Sie hier auch angeben, welcher Mandant es ist. Wenn nicht angegeben, wird Ihr Standardmandant verwendet.

    Anhang

In diesem Abschnitt verknüpfen wir die von uns erstellte Exchange Data Server-Quelle mit unserem App Builder App.

  1. Von Ihrem App Builder App, navigieren Sie zur App Workbench

  2. Klicken Sie auf die Fliese Datenquellen

  3. Klicken Sie auf die Schaltfläche + Quelle

  4. Wählen Sie Link zu vorhandener Quelle

  5. Klicken Sie auf Weiter

  6. Suchen Sie den Exchange-Treiber

  7. Überprüfen Sie das Feld Ausgewählt

  8. Klicken Sie auf die Schaltfläche Link 1 Quelle

  9. Klicken Sie auf Fertig

  10. Klicken Sie auf die Fliese Tabellen

  11. Wählen Sie den Exchange-Treiber als Wert für App-Datenquellen

  12. Bestätigen Sie, dass Sie nun alle Tabellen anzeigen können, die mit der Exchange-Treiber-Datenquelle für den angegebenen Benutzer verknüpft sind

    Anhang