Zum Inhalt springen

Microsoft Exchange-Verbindungsanleitung für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zur Verbindung von App Builder mit Microsoft Exchange als Datenserver. Diese Verbindung nutzt den OAuth-Flow für Client-Anmeldeinformationen.

Client-Anmeldeinformationen beziehen sich auf einen Flow in OAuth, bei dem keine direkte Benutzeranmeldung stattfindet. Stattdessen werden Anmeldeinformationen nur für die App selbst erstellt. Alle Aufgaben, die von der App ausgeführt werden, erfolgen ohne einen Standardbenutzerkontext. Dies macht den Authentifizierungsfluss etwas anders als üblich. Alle Berechtigungen, die mit dem Client-OAuth-Flow verbunden sind, erfordern die Zustimmung des Administrators.

Systemanforderungen

  • Microsoft Exchange

  • Azure-Portal

Webbrowser des Clients

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Einschränkungen und unterstützte Funktionen

Es kann Einschränkungen bezüglich der Primärschlüssel-IDs von Microsoft Exchange mit der SQL Server-Datenbank geben. Der Primärschlüssel ist eine lange alphanumerische Zeichenfolge und wird für neue E-Mails inkrementell durch a-z, 0-1, A-Z durchlaufen. Das Problem dabei ist, dass SQL Server standardmäßig nicht zwischen Groß- und Kleinschreibung unterscheidet, sodass zwei E-Mails mit PKs "1234a" und "1234A" für App Builder identisch sind. Eine Lösung besteht darin, die Spalte changeKey zu nutzen, die in Kombination mit id immer eindeutig sein wird.

Verbindungsanweisungen

Voraussetzungen zur Konfiguration im Azure-Portal

Bevor Sie die Verbindung zum Microsoft Exchange-Datenserver in App Builder konfigurieren, müssen Sie zunächst die folgenden Informationen aus 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.

    attachment

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

    Hinweis

    Stellen Sie sicher, dass Sie den Wert des Client-Geheimnisses kopieren und an einem Ort speichern, an dem Sie ihn während der Konfiguration der App-Builder-Schritte abrufen können.

    attachment

  • Navigieren Sie zu API-Berechtigungen und wählen Sie die Berechtigungen für Microsoft Graph aus. Es gibt zwei verschiedene Berechtigungsgruppen - Delegierte und Anwendungs-Berechtigungen. Die während der Authentifizierung mit Client-Anmeldeinformationen verwendeten Berechtigungen befinden sich unter Anwendungsberechtigungen. Wählen Sie die entsprechenden Berechtigungen aus, die Sie für Ihre Integration benötigen.

  • Konfigurieren Sie die folgenden API-Berechtigungen und gewähren Sie die Zustimmung des Administrators zu diesen Berechtigungen.

    attachment

Konfigurieren im App Builder

Erstellen eines OAuth-Sicherheitsanbieters

  1. Navigieren Sie zur App Builder IDE

  2. Klicken Sie auf die Schaltfläche Sicherheitsanbieter

  3. Klicken Sie auf die Schaltfläche + Benutzeranmeldung

  4. Weisen Sie den Namen etwas Identifizierbares zu. Zum Beispiel: Microsoft Exchange Connector

  5. Setzen Sie den Typ auf OAuth

  6. Setzen Sie den Authentifizierungstyp auf OAuth

  7. Setzen Sie die OAuth-Berechtigung auf Client-Anmeldeinformationen

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

  9. Setzen Sie die OAuth-Ressourcen-Authentifizierung auf Bearer

  10. Setzen Sie den Token-Besitzer auf Client

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

    • Typ = Token-Endpunkt

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

    Hinweis

    Ersetzen Sie die TenantID in der bereitgestellten URL-Zeichenfolge entsprechend

    attachment

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

  13. Setzen Sie den Typ auf Client

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

  15. Geben Sie das Passwort an. Dies ist der Wert des zuvor erstellten Client-Geheimnisses.

  16. Klicken Sie auf die Schaltfläche Speichern

attachment

  1. 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

attachment

  1. Aktivieren Sie das Feld Aktiviert in den Anbieter-Einstellungen, um dies als Sicherheitsanbieter zu aktivieren

Erstellen Sie den Microsoft Exchange-Datenserver

  1. Navigieren Sie zur App Builder IDE

  2. Klicken Sie auf die Schaltfläche Datenserver

  3. Klicken Sie auf die Schaltfläche + Server

  4. Weisen Sie einen Servernamen zu. Zum Beispiel: Exchange Driver

  5. Setzen Sie den Typ auf Microsoft Exchange

attachment

  1. Klicken Sie, um die Sicherheitseinstellungen zu erweitern

  2. Setzen Sie den Sicherheitsanbieter auf den Sicherheitsanbieter, den wir erstellt haben. Zum Beispiel: Microsoft Exchange Connector

  3. Klicken Sie auf die Schaltfläche Speichern

  4. Klicken Sie, um die Servereinstellungen zu erweitern

  5. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen

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

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

attachment

In diesem Abschnitt verknüpfen wir die von uns erstellte Exchange-Datenserverquelle mit unserer App Builder-App.

  1. Navigieren Sie von Ihrer App Builder-App zum App Workbench

  2. Klicken Sie auf die Kachel Datenquellen

  3. Klicken Sie auf die Schaltfläche + Quelle

  4. Wählen Sie Verknüpfung zu vorhandener Quelle

  5. Klicken Sie auf Weiter

  6. Suchen Sie den Exchange Driver

  7. Aktivieren 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 Kachel Tabellen

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

  12. Bestätigen Sie, dass Sie jetzt alle Tabellen sehen können, die mit der Datenquelle des Exchange Drivers für den angegebenen Benutzer verknüpft sind

    attachment