Microsoft Exchange Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 21.0.8662 des Connectors.

Erste Schritte

Unterstützung für Exchange-Version

Der Jitterbit Connector für Exchange stellt eine Verbindung mit der REST- API her.

Herstellen einer Verbindung

Verfügbare Schemas

Für die Verbindung mit Exchange stehen zwei Dienste zur Verfügung. Dies sind EWS (Exchange Web Services) und Microsoft Graph. Exchange Web Services ist sowohl für Exchange OnPremise als auch für Online verfügbar, erhält jedoch keine Updates mehr. Microsoft empfiehlt Exchange Online-Benutzern, auf Microsoft Graph umzusteigen. Beide sind mit unserem Tool verfügbar.

Um zwischen den beiden zu wechseln, verwenden Sie Schema Verbindungseigenschaft, um entweder EWS oder MSGraph festzulegen. Wenn Sie EWS mit Exchange Online verwenden möchten, legen Sie fest Schema zu EWS und dem Platform zu Exchange_Online.

Herstellen einer Verbindung zu Exchange mithilfe von Exchange OnPremise

Bei Verwendung einer OnPremise-Edition von Exchange, OnPremise Set User, Password, Und AuthScheme; standardmäßig führt der Connector eine Basisauthentifizierung durch, aber auch Windows (NTLM), Kerberos und delegierte Authentifizierung werden unterstützt.

Authentifizieren mit Kerberos

Siehe Verwenden von Kerberos für Einzelheiten zur Authentifizierung mit Kerberos

Legen Sie zusätzlich zu den Authentifizierungswerten die Server Eigenschaft auf die Adresse des Exchange-Servers, mit dem Sie eine Verbindung herstellen, und legen Sie Platform auf die Exchange-Version. Setzen Sie abschließend Schema zu EWS.

Herstellen einer Verbindung mit Exchange über Exchange Online

Bei der Verbindung mit Exchange Online erfolgt die Authentifizierung über OAuth. Wenn Sie über EWS eine Verbindung zur Exchange Online-Plattform herstellen, setzen Sie AuthScheme-Eigenschaft entweder auf Microsoft Entra ID, AzureServicePrincipal oder AzureMSI. Andernfalls, wenn Sie Microsoft Graph verwenden, um eine Verbindung zu Exchange Online herzustellen, werden Ressourcen von einem anderen Dienst abgerufen, sodass die Schema sollte auf MSGraph eingestellt werden. Wenn Schema ist auf MSGraph eingestellt, der Platform-Wert wird ignoriert.

Authentifizieren mit Microsoft Entra ID

Entra ID ist ein Verbindungstyp, der über OAuth läuft. Legen Sie Ihre AuthScheme Zu AzureAD und siehe Verwenden der OAuth-Authentifizierung für eine Anleitung zur Authentifizierung.

Authentifizieren mit dem Microsoft Entra-Dienstprinzipal

Azure Service Principal ist ein Verbindungstyp, der über OAuth läuft. Legen Sie Ihre AuthScheme Zu AzureServicePrincipal und siehe Verwenden der Microsoft Entra-Dienstprinzipalauthentifizierung für eine Anleitung zur Authentifizierung.

Authentifizieren mit MSI-Authentifizierung

Wenn Sie Exchange auf einer Azure-VM ausführen, können Sie die Anmeldeinformationen der Managed Service Identity (MSI) für die Verbindung nutzen:

• AuthScheme: Setzen Sie dies auf AzureMSI.

Die MSI-Anmeldeinformationen werden dann automatisch zur Authentifizierung abgerufen.

OAuth-Authentifizierung verwenden

OAuth erfordert, dass der authentifizierende Benutzer über den Browser mit Exchange interagiert. Der Connector erleichtert dies auf verschiedene Weise, wie unten beschrieben.

Eingebettete Anmeldeinformationen

Siehe Eingebettete Anmeldeinformationen, um eine Verbindung mit den eingebetteten Anmeldeinformationen des Connectors herzustellen und das Erstellen einer benutzerdefinierten OAuth-App zu überspringen.

Benutzerdefinierte Anmeldeinformationen

Anstatt die Verbindung mit den eingebetteten Anmeldeinformationen des Connectors herzustellen, können Sie eine App mit Benutzerdefinierten Anmeldeinformationen registrieren, um die zu erhalten OAuthClientId Und OAuthClientSecret.

Wann sollte eine benutzerdefinierte OAuth-App erstellt werden?

Das Erstellen einer benutzerdefinierten OAuth-App ist optional, da der Connector bereits bei Exchange registriert ist und Sie sich mit seinen eingebetteten Anmeldeinformationen verbinden können. Möglicherweise möchten Sie eine benutzerdefinierte OAuth-App erstellen, um die angezeigten Informationen zu ändern, wenn sich Benutzer beim Exchange OAuth-Endpoint anmelden, um dem Connector Berechtigungen zu erteilen.

Erstellen einer benutzerdefinierten OAuth-App

Siehe Erstellen einer benutzerdefinierten OAuth-App für ein Verfahren.

Eingebettete Anmeldeinformationen

Authentifizieren Sie sich mit den eingebetteten OAuth-Anmeldeinformationen

Desktop-Authentifizierung mit der eingebetteten OAuth-App

Sie können eine Verbindung herstellen, ohne Verbindungseigenschaften für Ihre Benutzeranmeldeinformationen festzulegen.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Anschließend schließt der Connector den OAuth-Prozess ab.

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über Verbindungen hinweg bestehen bleiben.

Benutzerdefinierte Anmeldeinformationen

Es stehen zwei Arten der App-Authentifizierung zur Verfügung: die Verwendung eines Client-Geheimnisses und die Verwendung eines Zertifikats. Sie können je nach konfigurierter App-Authentifizierung eine der beiden Arten verwenden.

Desktop-Authentifizierung mit Ihrer OAuth-App

Befolgen Sie die nachstehenden Schritte, um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-App zu authentifizieren. Siehe Erstellen einer benutzerdefinierten OAuth-App.

Holen Sie sich ein OAuth-Zugriffstoken

Sie können eine Verbindung herstellen, nachdem Sie je nach Authentifizierungstyp eine der folgenden Verbindungseigenschaftengruppen festgelegt haben.

1. Authenticating using a Client Secret
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
   • CallbackURL: Legen Sie dies in Ihren App-Einstellungen auf die Umleitungs URL fest.
   • AuthScheme: Stellen Sie dies in Ihren App-Einstellungen auf „AzureAD“ ein.
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken..
2. Authenticating using a Certificate
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthJWTCert: Stellen Sie dies auf den JWT-Zertifikatspeicher ein.
   • OAuthJWTCertType: Setzen Sie dies auf den Typ des Zertifikatspeichers, der durch angegeben ist OAuthJWTCert.
   • CallbackURL: Legen Sie dies in Ihren App-Einstellungen auf die Umleitungs URL fest.
   • AuthScheme: Stellen Sie dies in Ihren App-Einstellungen auf „AzureAD“ ein.
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken..

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über Verbindungen hinweg bestehen bleiben.

Kopflose Maschinen

Verwenden von OAuth auf einer Headless-Maschine

Um Exchange-Datenquellen auf Headless-Servern oder anderen Maschinen zu erstellen, auf denen der Connector keinen Browser öffnen kann, müssen Sie sich von einer anderen Maschine aus authentifizieren. Die Authentifizierung erfolgt in zwei Schritten.

1. Anstatt den Connector auf einer anderen Maschine zu installieren, können Sie die folgenden Schritte ausführen, um die OAuthVerifier-Wert. Oder Sie können den Connector auf einem anderen Computer installieren und die OAuth-Authentifizierungswerte übertragen, nachdem Sie sich über den üblichen browserbasierten Ablauf authentifiziert haben.
2. Anschließend können Sie den Connector so konfigurieren, dass das Zugriffstoken vom Headless-Computer automatisch aktualisiert wird.

Sie können dem Headless-OAuth-Authentifizierungsablauf mit den eingebetteten OAuth-Anmeldeinformationen des Connectors oder mit den OAuth-Anmeldeinformationen für Ihre benutzerdefinierte OAuth-App folgen.

Verwenden der Anmeldeinformationen für eine benutzerdefinierte OAuth-App

Erstellen einer benutzerdefinierten OAuth-App

Siehe Erstellen einer benutzerdefinierten OAuth-App für ein Verfahren. Sie können dann die folgenden Verfahren befolgen, um sich zu authentifizieren und eine Verbindung zu Daten herzustellen.

Besorgen Sie sich einen Prüfcode

Legen Sie auf der Headless-Maschine je nach Authentifizierungstyp eine der folgenden Eigenschaftengruppen fest:

1. Authenticating using a Client Secret
   • InitiateOAuth: Stellen Sie dies auf AUS.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die App-ID fest.
   • OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das App-Geheimnis fest.
2. Authenticating using a Certificate
   • InitiateOAuth: Stellen Sie dies auf AUS.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die App-ID fest.
   • OAuthJWTCert: Stellen Sie dies auf den JWT-Zertifikatspeicher ein.
   • OAuthJWTCertType: Setzen Sie dies auf den Typ des Zertifikatspeichers, der durch angegeben ist OAuthJWTCert.

Sie können dann die folgenden Schritte ausführen, um sich von einem anderen Computer aus zu authentifizieren und die OAuthVerifier Verbindungseigenschaft.

1. Rufen Sie die GetOAuthAuthorizationURL auf gespeicherte Prozedur mit dem CallbackURL-Eingabeparameter, der auf die genaue Umleitungs-URI eingestellt ist, die Sie in Ihren App-Einstellungen angegeben haben.
2. Öffnen Sie die zurückgegebene URL in einem Browser. Melden Sie sich an und erteilen Sie dem Connector Berechtigungen. Sie werden dann zur Rückruf-URL weitergeleitet. Auf der Webseite wird angegeben, dass die Site nicht erreicht werden konnte.
3. Überprüfen Sie die URL dieser Site-Seite und suchen Sie nach code Wert. Er wird in der URL in der Form Code=XXXXXX vorhanden sein (abgeschlossen mit &, das den nächsten URL Parameter kennzeichnet). Der Wert nach dem „Code=“ ist der Prüfcode.
4. Speichern Sie den Wert des Prüfcodes. Sie setzen diesen in OAuthVerifier Verbindungseigenschaft.

Legen Sie auf der Headless-Maschine je nach Authentifizierungstyp eine der folgenden Verbindungseigenschaftengruppen fest, um die OAuth-Authentifizierungswerte zu erhalten:

• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf den Consumer-Schlüssel fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Verbrauchergeheimnis fest.
• OAuthVerifier: Setzen Sie dies auf den Prüfcode.
• OAuthSettingsLocation: Legen Sie dies fest, um die verschlüsselten OAuth-Authentifizierungswerte in der angegebenen Datei zu speichern.
• InitiateOAuth: Setzen Sie dies auf REFRESH.

Mit Daten verbinden

Nachdem die OAuth-Einstellungsdatei generiert wurde, legen Sie die folgenden Eigenschaften fest, um eine Verbindung mit Daten herzustellen:

• OAuthSettingsLocation: Legen Sie dies auf die Datei fest, die die verschlüsselten OAuth-Authentifizierungswerte enthält. Stellen Sie sicher, dass diese Datei dem Anbieter Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• InitiateOAuth: Stellen Sie dies auf REFRESH ein.

OAuth-Einstellungen übertragen

Befolgen Sie die nachstehenden Schritte, um den Connector auf einem anderen Computer zu installieren, zu authentifizieren und dann die resultierenden OAuth-Werte zu übertragen.

Installieren Sie den Connector auf einem zweiten Computer und stellen Sie je nach Authentifizierungstyp eine Verbindung mit einer der folgenden Eigenschaftengruppen her:

1. Authenticating using a Client Secret
   • OAuthSettingsLocation: Legen Sie dies auf eine beschreibbare Textdatei fest.
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
   • CallbackURL: Legen Sie dies in Ihren App-Einstellungen auf die Rückruf URL fest.
2. Authenticating using a Certificate
   • OAuthSettingsLocation: Legen Sie dies auf eine beschreibbare Textdatei fest.
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthJWTCert: Stellen Sie dies auf den JWT-Zertifikatspeicher ein.
   • OAuthJWTCertType: Setzen Sie dies auf den Typ des Zertifikatspeichers, der durch angegeben ist OAuthJWTCert.
   • CallbackURL: Legen Sie dies in Ihren App-Einstellungen auf die Rückruf URL fest.

Testen Sie die Verbindung zur Authentifizierung. Die resultierenden Authentifizierungswerte werden verschlüsselt in den durch angegebenen Pfad geschrieben OAuthSettingsLocation. Nachdem Sie die Verbindung erfolgreich getestet haben, kopieren Sie die OAuth-Einstellungsdatei auf Ihren Headless-Rechner. Legen Sie auf dem Headless-Rechner die folgenden Verbindungseigenschaften fest, um eine Verbindung zu Daten herzustellen:

• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• OAuthSettingsLocation: Legen Sie hier den Pfad zu Ihrer OAuth-Einstellungsdatei fest. Stellen Sie sicher, dass diese Datei dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.

Erstellen einer benutzerdefinierten OAuth-App

Wann sollte eine benutzerdefinierte OAuth-App erstellt werden?

Das Erstellen einer benutzerdefinierten OAuth-App ist optional, da der Connector bereits bei Exchange registriert ist und Sie mit den eingebetteten Anmeldeinformationen eine Verbindung herstellen können.

Möglicherweise möchten Sie eine benutzerdefinierte OAuth-App erstellen, um die angezeigten Informationen zu ändern, wenn sich Benutzer beim Exchange OAuth-Endpoint anmelden, um dem Connector Berechtigungen zu erteilen.

Befolgen Sie die nachstehenden Schritte, um eine benutzerdefinierte OAuth-App zu erstellen und die Verbindungseigenschaften in einem bestimmten OAuth-Authentifizierungsfluss abzurufen.

Schritte zum Erstellen einer benutzerdefinierten OAuth-App

Befolgen Sie die nachstehenden Schritte, um die OAuth-Werte für Ihre App abzurufen. OAuthClientId Und OAuthClientSecret.

1. Melden Sie sich an bei https://portal.azure.com.

2. Wählen Sie im linken Navigationsbereich „Microsoft Entra ID“ und dann „App-Registrierungen“ aus und klicken Sie auf die Schaltfläche „Neue Registrierung“.

3. Geben Sie einen App-Namen ein und aktivieren Sie das Optionsfeld für die gewünschte Mandantenkonfiguration.

   Wenn Sie eine benutzerdefinierte OAuth-Anwendung in Microsoft Entra ID erstellen, können Sie festlegen, ob die Anwendung Single- oder Multi-Tenant ist. Wenn Sie die Standardoption „Nur Konten in diesem Organisationsverzeichnis“ auswählen, müssen Sie Folgendes festlegen: AzureTenant Verbindungseigenschaft an die ID des Microsoft Entra ID Tenants, wenn eine Verbindung mit dem Jitterbit Connector für Exchange hergestellt wird. Andernfalls schlägt der Authentifizierungsversuch mit einem Fehler fehl. Wenn Ihre App nur für den privaten Gebrauch bestimmt ist, sollte „Nur Konten in diesem Organisationsverzeichnis“ ausreichen. Wenn Sie Ihre App verteilen möchten, wählen Sie andernfalls eine der Multi-Tenant-Optionen.

4. Legen Sie dann die Weiterleitungs URL fest, z. B. http://localhost:33333, der Standard des Connectors. Oder legen Sie einen anderen Port Ihrer Wahl fest und setzen Sie CallbackURL an die genaue Antwort-URL, die Sie definiert haben.

5. Definieren Sie den App-Authentifizierungstyp, indem Sie zum Abschnitt „Zertifikate und Geheimnisse“ gehen. Es stehen zwei Arten der Authentifizierung zur Verfügung: die Verwendung eines Client-Geheimnisses und die Verwendung eines Zertifikats. Die empfohlene Authentifizierungsmethode ist die Verwendung eines Zertifikats, Sie können jedoch auch ein Anwendungsgeheimnis erstellen.

   • Option 1 - Upload a certificate: Wählen Sie im Abschnitt „Zertifikate und Geheimnisse“ die Option „Zertifikat hochladen“ und wählen Sie das Zertifikat aus, das von Ihrem lokalen Computer hochgeladen werden soll.
   • Option 2 - Create a new application secret: Wählen Sie im Abschnitt „Zertifikate und Geheimnisse“ „Neues Client-Geheimnis“ für die App und legen Sie deren Dauer fest. Nach dem Speichern des Client-Geheimnisses wird der Schlüsselwert angezeigt. Kopieren Sie diesen Wert, da er nur einmal angezeigt wird und als verwendet wird OAuthClientSecret.

6. Wählen Sie API Berechtigungen und klicken Sie dann auf Hinzufügen. Wenn Sie planen, dass Ihre App ohne Benutzerkontext eine Verbindung herstellt, wählen Sie die Anwendungsberechtigungen (OAuthGrantType = CLIENT). Andernfalls verwenden Sie beim Auswählen der Berechtigungen die delegierten Berechtigungen.

7. Wenn Sie die Verbindung zu Exchange über das EWS Schema herstellen, wählen Sie Exchange API und fügen Sie die Berechtigung EWS.AccessAsUser.All hinzu. Wenn Sie die Verbindung zu Exchange über das MSGraph-Schema herstellen, wählen Sie Microsoft Graph API und fügen Sie die folgenden Berechtigungen hinzu: Calendars.ReadWrite.Shared, Contacts.ReadWrite, Group.Read.All, Group.ReadWrite.All, User.ReadWrite.All und Mail.ReadWrite.Shared.

8. Speichern Sie Ihre Änderungen.

9. Wenn Sie Berechtigungen ausgewählt haben, die eine Administratorzustimmung erfordern (z. B. Anwendungsberechtigungen), können Sie diese vom aktuellen Mandanten aus auf der Seite „API Berechtigungen“ erteilen. Andernfalls befolgen Sie die Schritte unter Administratorzustimmung.

Zustimmung des Administrators

Administratorzustimmung bezieht sich darauf, wenn der Administrator für einen Microsoft Entra ID Mandanten Berechtigungen für eine Anwendung erteilt, für die die Zustimmung eines Administrators zum Anwendungsfall erforderlich ist. Die eingebettete App im Jitterbit Connector für Exchange enthält keine Berechtigungen, für die die Administratorzustimmung erforderlich ist. Daher gelten diese Informationen nur für benutzerdefinierte Anwendungen.

Administratoreinwilligungsberechtigungen

Wenn Sie im Azure-Portal eine neue OAuth-App erstellen, müssen Sie angeben, welche Berechtigungen die App benötigt. Einige Berechtigungen können mit der Angabe „Administratorzustimmung erforderlich“ gekennzeichnet sein. Beispielsweise erfordern alle Gruppenberechtigungen die Administratorzustimmung. Wenn Ihre App die Administratorzustimmung erfordert, gibt es mehrere Möglichkeiten, dies zu tun.

Die einfachste Möglichkeit, die Administratorzustimmung zu erteilen, besteht darin, dass sich ein Administrator einfach bei portal.azure.com anmeldet und zu der App navigiert, die Sie in App-Registrierungen erstellt haben. Unter „API -Berechtigungen“ befindet sich eine Schaltfläche zum Erteilen der Zustimmung. Sie können hier zustimmen, dass Ihre App Berechtigungen für den Mandanten erhält, unter dem sie erstellt wurde.

Wenn Ihre Organisation über mehrere Mandanten verfügt oder der App Berechtigungen für andere Mandanten außerhalb Ihrer Organisation erteilt werden müssen, wird die GetAdminConsentURL kann zur Generierung der Admin-Autorisierungs URL verwendet werden. Im Gegensatz zu GetOAuthAuthorizationURL, werden von diesem Endpoint keine wichtigen Informationen zurückgegeben. Wenn der Administrator Zugriff gewährt, wird lediglich ein Boolean-Wert zurückgegeben, der angibt, dass Berechtigungen erteilt wurden.

Sobald ein Administrator seine Zustimmung erteilt, kann die Authentifizierung wie gewohnt durchgeführt werden.

Client-Anmeldeinformationen

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.

Client-OAuth-Flow

Alle Berechtigungen im Zusammenhang mit dem Client-OAuth-Flow erfordern die Zustimmung des Administrators. Dies bedeutet, dass die mit dem Jitterbit Connector für Exchange eingebettete App nicht im Client-OAuth-Flow verwendet werden kann. Sie müssen Ihre eigene OAuth-App erstellen, um Client-Anmeldeinformationen verwenden zu können. Siehe Erstellen einer benutzerdefinierten OAuth-App für weitere Einzelheiten.

Navigieren Sie in Ihrer App-Registrierung in portal.azure.com zu API -Berechtigungen und wählen Sie die Microsoft Graph-Berechtigungen aus. Es gibt zwei verschiedene Berechtigungssätze: Delegierte und Anwendungsberechtigungen. Die während der Clientanmeldeauthentifizierung verwendeten Berechtigungen finden Sie unter Anwendungsberechtigungen. Wählen Sie die entsprechenden Berechtigungen aus, die Sie für Ihre Integration benötigen.

Sie können eine Verbindung herstellen, nachdem Sie je nach Authentifizierungstyp eine der folgenden Verbindungseigenschaftengruppen festgelegt haben.

1. Authenticating using a Client Secret
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
   • AzureTenant: Stellen Sie dies auf den Mandanten ein, mit dem Sie sich verbinden möchten.
   • OAuthGrantType: Setzen Sie dies auf CLIENT.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
2. Authenticating using a Certificate
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
   • AzureTenant: Stellen Sie dies auf den Mandanten ein, mit dem Sie sich verbinden möchten.
   • OAuthGrantType: Setzen Sie dies auf CLIENT.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthJWTCert: Stellen Sie dies auf den JWT-Zertifikatspeicher ein.
   • OAuthJWTCertType: Setzen Sie dies auf den Typ des Zertifikatspeichers, der durch angegeben ist OAuthJWTCert.

Die Authentifizierung mit Client-Anmeldeinformationen erfolgt automatisch wie bei jeder anderen Verbindung, außer dass kein Fenster mit einer Benutzeraufforderung geöffnet wird. Da kein Benutzerkontext vorhanden ist, ist kein Browser-Popup erforderlich. Verbindungen werden hergestellt und intern abgewickelt.

Verwenden der Microsoft Entra-Dienstprinzipalauthentifizierung

Die Authentifizierung als Microsoft Entra-Dienstprinzipal wird über den OAuth-Client-Anmeldeinformationsfluss abgewickelt und beinhaltet keine direkte Benutzerauthentifizierung. Stattdessen werden Anmeldeinformationen nur für die App selbst erstellt. Alle von der App ausgeführten Aufgaben werden ohne Standardbenutzerkontext, sondern basierend auf den zugewiesenen Rollen ausgeführt. Der Anwendungszugriff auf die Ressourcen wird über die Berechtigungen der zugewiesenen Rollen gesteuert.

Benutzerdefinierte Anmeldeinformationen

Sie müssen eine OAuth-App registrieren, um die OAuth-Eigenschaftswerte abzurufen, bevor Sie eine Verbindung zur Exchange-Datenquelle herstellen. Sie können die Benutzerdefinierten Anmeldeinformationen überprüfen Anleitung zum Festlegen der OAuth-Eigenschaften.

Erstellen einer benutzerdefinierten OAuth-App

Siehe Erstellen einer benutzerdefinierten OAuth-App für ein Verfahren.

Erstellen einer benutzerdefinierten OAuth-App

Bei der Authentifizierung mit einem Microsoft Entra-Dienstprinzipal ist das Erstellen einer benutzerdefinierten OAuth-App und eines Dienstprinzipals erforderlich, das auf die erforderlichen Ressourcen zugreifen kann.

Befolgen Sie die nachstehenden Schritte, um eine benutzerdefinierte OAuth-App zu erstellen und die Verbindungseigenschaften für die Microsoft Entra-Dienstprinzipal-Authentifizierung abzurufen.

Schritte zum Erstellen einer benutzerdefinierten OAuth-App

Befolgen Sie die nachstehenden Schritte, um die OAuth-Werte für Ihre App abzurufen.

1. Melden Sie sich an bei https://portal.azure.com.
2. Wählen Sie im linken Navigationsbereich „Microsoft Entra ID“ und dann „App-Registrierungen“ aus und klicken Sie auf die Schaltfläche „Neue Registrierung“.
3. Geben Sie einen App-Namen ein und aktivieren Sie das Optionsfeld für Konten in einem beliebigen Organisationsverzeichnis (Jeder Microsoft Entra ID Mandant - Multitenant). Legen Sie dann die Umleitungs-URL auf etwas wie http://localhost:33333, die Standardeinstellung des Connectors.
4. Kopieren Sie den Anwendungs-ID-Wert (Client-ID), der nach dem Erstellen der App im Abschnitt „Übersicht“ angezeigt wird, da dieser Wert als verwendet wird OAuthClientId
5. Definieren Sie den App-Authentifizierungstyp, indem Sie zum Abschnitt „Zertifikate und Geheimnisse“ gehen. Es stehen zwei Arten der Authentifizierung zur Verfügung: die Verwendung eines Client-Geheimnisses und die Verwendung eines Zertifikats. Die empfohlene Authentifizierungsmethode ist über ein Zertifikat, Sie können jedoch auch ein Anwendungsgeheimnis erstellen.
   • Option 1 - Upload a certificate: Wählen Sie im Abschnitt „Zertifikate und Geheimnisse“ die Option „Zertifikat hochladen“ und wählen Sie das Zertifikat aus, das von Ihrem lokalen Computer hochgeladen werden soll.
   • Option 2 - Create a new application secret: Wählen Sie im Abschnitt „Zertifikate und Geheimnisse“ „Neues Client-Geheimnis“ für die App und legen Sie dessen Dauer fest. Nach dem Speichern des Client-Geheimnisses wird der Schlüsselwert angezeigt. Kopieren Sie diesen Wert, da er nur einmal angezeigt wird und als verwendet wird OAuthClientSecret.
6. Aktivieren Sie auf der Tab „Authentifizierung“ unbedingt die Option „Zugriffstoken (für implizite Flows verwendet)“.
7. Öffnen Sie die Seite „Abonnements“, indem Sie in der Suchleiste nach dem Abonnementdienst suchen und ihn auswählen.
8. Wählen Sie das jeweilige Abonnement aus, dem Sie die Anwendung zuweisen möchten, öffnen Sie dann den Abschnitt „Zugriffskontrolle (IAM)“ und klicken Sie auf die Schaltfläche „Rolle hinzufügen“.
9. Wählen Sie „Besitzer“ als Rolle aus, die Sie Ihrer erstellten OAuth-App zuweisen möchten.

Benutzerdefinierte Anmeldeinformationen

Befolgen Sie die nachstehenden Schritte, um sich mit den Anmeldeinformationen für eine benutzerdefinierte OAuth-App zu authentifizieren. Siehe Erstellen einer benutzerdefinierten OAuth-App.

Authentifizierung mit Ihrer OAuth-App

Es stehen zwei Arten der App-Authentifizierung zur Verfügung: die Verwendung eines Client-Geheimnisses und die Verwendung eines Zertifikats. Sie können je nach konfigurierter App-Authentifizierung eine der beiden Arten verwenden.

Holen Sie sich ein OAuth-Zugriffstoken

Sie können eine Verbindung herstellen, nachdem Sie je nach Authentifizierungstyp eine der folgenden Verbindungseigenschaftengruppen festgelegt haben.

1. Authenticating using a Client Secret
   • AuthScheme: Legen Sie dies in Ihren App-Einstellungen auf „AzureServicePrincipal“ fest.
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
   • AzureTenant: Stellen Sie dies auf den Mandanten ein, mit dem Sie sich verbinden möchten.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
2. Authenticating using a Certificate
   • AuthScheme: Legen Sie dies in Ihren App-Einstellungen auf „AzureServicePrincipal“ fest.
   • InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
   • AzureTenant: Stellen Sie dies auf den Mandanten ein, mit dem Sie sich verbinden möchten.
   • OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
   • OAuthJWTCert: Stellen Sie dies auf den JWT-Zertifikatspeicher ein.
   • OAuthJWTCertType: Setzen Sie dies auf den Typ des Zertifikatspeichers, der durch angegeben ist OAuthJWTCert.

Kerberos verwenden

In diesem Abschnitt wird gezeigt, wie Sie den Connector zur Authentifizierung bei Exchange mithilfe von Kerberos verwenden.

Authentifizieren mit Kerberos

Um sich mit Kerberos bei Exchange zu authentifizieren, legen Sie die folgenden Eigenschaften fest:

• AuthScheme: Setzen Sie dies auf NEGOTIATE.
• KerberosKDC: Setzen Sie dies auf host name or IP Address Ihrer Kerberos-KDC-Maschine.
• KerberosRealm: Setzen Sie dies auf the realm of the Exchange Kerberos principal. Dies ist der Wert nach dem '@'-Symbol (z. B. EXAMPLE.COM) der principal value (zum Beispiel ServiceName/MyHost@EXAMPLE.COM).
• KerberosSPN: Setzen Sie dies auf service and host of the Exchange Kerberos Principal. Dies ist der Wert vor dem '@'-Symbol (z. B. ServiceName/MyHost) des principal value (zum Beispiel ServiceName/MyHost@EXAMPLE.COM).

Abrufen des Kerberos-Tickets

Sie können eine der folgenden Optionen verwenden, um das erforderliche Kerberos-Ticket abzurufen.

MIT Kerberos-Anmeldeinformations-Cache-Datei

Mit dieser Option können Sie den MIT Kerberos Ticket Manager oder den Befehl kinit verwenden, um Tickets abzurufen. Beachten Sie, dass Sie nicht das User oder Password Verbindungseigenschaften mit dieser Option.

1. Stellen Sie sicher, dass Sie eine Umfeld mit dem Namen erstellt haben KRB5CCNAME.
2. Setzen Sie die KRB5CCNAME Umfeld auf einen Pfad, der auf Ihr verweist credential cache file (zum Beispiel C:\krb_cache\krb5cc_0 oder /tmp/krb5cc_0). Diese Datei wird erstellt, wenn Sie Ihr Ticket mit MIT Kerberos Ticket Manager erstellen.
3. Um ein Ticket zu erhalten, öffnen Sie die Anwendung MIT Kerberos Ticket Manager und klicken Sie auf Get Ticket, enter your principal name and password, then click OK. Bei erfolgreichem Abschluss werden die Ticketinformationen im Kerberos Ticket Manager angezeigt und in der Anmeldeinformations-Cachedatei gespeichert.
4. Nachdem die Anmeldeinformations-Cachedatei erstellt wurde, verwendet der Connector die Cachedatei, um das Kerberos-Ticket für die Verbindung mit Exchange abzurufen.

Als Alternative zum Festlegen von KRB5CCNAME Umfeld können Sie den Dateipfad direkt mit der festlegen KerberosTicketCache-Eigenschaft. Wenn diese Eigenschaft festgelegt ist, verwendet der Connector die angegebene Cache-Datei, um das Kerberos-Ticket für die Verbindung mit Exchange abzurufen.

Keytab-Datei

Wenn die KRB5CCNAME environment variable has not been set, Sie können ein Kerberos-Ticket abrufen mit einem Keytab File. Setzen Sie dazu die User Eigenschaft auf den gewünschten Benutzernamen und setzen Sie die KerberosKeytabFile-Eigenschaft zu einem Dateipfad, der auf die dem Benutzer zugeordnete Keytab-Datei verweist.

Benutzer und Passwort

Wenn beide the KRB5CCNAME environment variable and the _KerberosKeytabFile_ property have not been set, Sie können ein Ticket abrufen mit einem User and Password combination. Setzen Sie dazu die User Und Password Eigenschaften für die Benutzer-/Passwortkombination, die Sie zur Authentifizierung bei Exchange verwenden.

Cross-Realm-Authentifizierung

Komplexere Kerberos-Umgebungen erfordern möglicherweise eine bereichsübergreifende Authentifizierung, wenn mehrere Bereiche und KDC-Server verwendet werden (z. B. wenn ein Bereich/KDC für die Benutzerauthentifizierung und ein anderer Bereich/KDC zum Abrufen des Servicetickets verwendet wird).

In einer solchen Umfeld ist die KerberosRealm Und KerberosKDC Eigenschaften können auf die für die Benutzerauthentifizierung erforderlichen Werte gesetzt werden. Die KerberosServiceRealm Und KerberosServiceKDC Eigenschaften können auf die zum Erhalt des Servicetickets erforderlichen Werte eingestellt werden.

Exchange Online-Verwaltungsaufgaben

Der Jitterbit Connector für Exchange kann verwendet werden, um Verwaltungsaufgaben mit MSGraph durchzuführen Schema. Dies kann durch Angabe der UserId-Spalte zum Ausführen von CUD-Operationen erfolgen.

Die UserId-Spalte

Viele Tabellen enthalten eine spezielle UserId-Spalte. Diese ist für Administratoren gedacht, die Datensätze im Konto eines anderen Benutzers ändern möchten. Wenn Sie kein Administrator sind oder dieses Verhalten nicht wünschen, geben Sie die UserId nicht an, wenn Sie einen INSERT-/UPDATE-/DELETE Operation ausführen. Wenn Sie beispielsweise Folgendes ausführen, wird ein Kontakt für einen anderen Benutzer eingefügt:

INSERT INTO Contacts (displayName, CompanyName, UserId) VALUES ('Bill', 'Bob Co', '12345')

Die obige Anfrage hat insgesamt den Effekt, dass versucht wird, einen Kontakt unter der Ressource unter /users/12345/contacts hinzuzufügen. Wenn UserId nicht angegeben ist, werden die betroffenen Ressourcen stattdessen unter /users/me/contacts geändert. Wenn Sie kein Administrator sind, können Sie im Allgemeinen nur Datensätze unter /users/me beeinflussen oder anzeigen. Es wird daher nicht empfohlen, UserId festzulegen, wenn Sie kein Administrator sind.

Wählen Sie Daten austauschen

Hinweis: Im Folgenden wird das Verhalten beschrieben, wenn Schema ist auf EWS eingestellt. Es hat keine Auswirkungen auf MSGraph.

FindItem vs. GetItem

Standardmäßig führt der Connector den FindItem-API Aufruf der Exchange Web Services aus und fordert nur dann zusammenfassende Informationen zu Elementen an, wenn ein SELECT Operation ausgeführt wird. Jede Anforderung, die mehr als ein Element zurückgeben könnte, gibt nur zusammenfassende Informationen zurück. Beispiel:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith'

Wenn Sie den Inhalt einer Nachricht oder weitere Informationen zu einem Kontakt oder einem Kalenderereignis anfordern möchten, müssen Sie festlegen IncludeContent auf TRUE, geben Sie die ItemIds der Artikel an oder beschränken Sie Ihre Ergebnisse auf einen einzelnen Artikel. Beispiel:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemId='AZQ111222...'

ODER

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemdId IN ('AZQ111222...', 'AZQ111223...', 'AZQ111224...', 'AZQ111225...')

ODER

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith' LIMIT 1

Öffentliche und benutzerdefinierte Ordner

Wenn Sie aus einem öffentlichen oder benutzerdefinierten Ordner lesen möchten, müssen Sie zunächst die Ordner-ID des Ordners ermitteln, aus dem Sie lesen möchten. Dies kann durch Senden einer Abfrage aus dem übergeordneten Ordner (für einen benutzerdefinierten Ordner) oder aus der entsprechenden Tabelle für den Objekttyp erfolgen, der in einem öffentlichen Ordner gespeichert ist. Verwenden Sie dazu den Posteingang, wenn der öffentliche Ordner

enthält Nachrichten. Beispiel:

So ermitteln Sie die Ordner-ID eines Unterordners im Posteingang:

SELECT DisplayName, FolderId FROM Inbox

So finden Sie die Ordner-ID eines benutzerdefinierten Ordners, der Kontakte enthält:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderName='publicfoldersroot'

Wenn Ihr öffentlicher Ordner verschachtelt ist, müssen Sie möglicherweise eine separate SELECT- Abfrage für den übergeordneten benutzerdefinierten Ordner ausführen:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderId='AAEuAAAAAAAa...'

Erstellen von Elementen in öffentlichen und benutzerdefinierten Ordnern

In öffentliche und benutzerdefinierte Ordner einfügen

Wenn Sie ein Element in einem öffentlichen oder benutzerdefinierten Ordner erstellen möchten, müssen Sie zuerst die Ordner-ID des Ordners ermitteln, aus dem Sie lesen möchten (siehe Auswählen von Exchange-Daten). Sobald Sie die Ordner-ID kennen, können Sie diesen Wert als ParentFolderId verwenden, wenn Sie ein neues Objekt erstellen. Um ein Objekt in einem benutzerdefinierten oder öffentlichen Ordner zu erstellen, verwenden Sie den entsprechenden

Objekttyp als Tabelle (oder Posteingang, wenn der Ordner Nachrichten enthält). Beispiel:

Einfügen in einen Unterordner des Posteingangs:

INSERT INTO Inbox (Subject, FromEmailAddress, ToRecipients_EmailAddress, ParentFolderId) VALUES ('New email message', 'user1@email.com', 'user2@email.com', 'AAEuAAAAAAAa...')

Einfügen in einen öffentlichen Ordner, der Kontakte enthält:

INSERT INTO Contacts (GivenName, Surname, EmailAddress1, ParentFolderId) VALUES ('Jill', 'Smith', 'user3@email.com', 'AAEuAAAAAAAa...')

Aktualisieren oder Löschen von Elementen in öffentlichen und benutzerdefinierten Ordnern

Aktualisieren oder Löschen eines Elements in öffentlichen und benutzerdefinierten Ordnern

Anders als beim Lesen aus oder Einfügen in einen öffentlichen oder benutzerdefinierten Ordner benötigen Sie die Ordner-ID nicht, um ein Element zu aktualisieren oder zu löschen. Sie müssen lediglich wissen, welchen Objekttyp

der Ordner enthält, und diesen Typ als Tabelle verwenden (oder Posteingang für einen Ordner verwenden, der Nachrichten enthält). Beispiel:

Aktualisieren eines Nachrichtenelements in einem benutzerdefinierten Ordner:

UPDATE Inbox SET Subject = 'Updated email message' WHERE ItemID = 'AZQ111222...')

Löschen eines Kontaktelements aus einem öffentlichen Ordner:

DELETE FROM Contacts WHERE ItemID = 'AZQ111222...')

Optimieren des Datenzugriffs

Identitätswechsel bei Benutzern

Diese Authentifizierungsmethode wird normalerweise von Administratoren verwendet, um den Zugriff über ein Dienstkonto zu konfigurieren.
Um alle Anfragen zu imitieren, legen Sie zum Zeitpunkt der Verbindung die folgenden Verbindungseigenschaften fest.
Um sich für eine einzelne Abfrage als Benutzer auszugeben, verwenden Sie die gleichnamigen Pseudospalten.

• ImpersonationUser: Legen Sie dies für den Benutzer fest, dessen Identität Sie annehmen möchten.
• ImpersonationType: Stellen Sie hier das Format ein, das Sie zur Angabe des Benutzers verwenden. Beispielsweise UPN oder SID.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Exchange-Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Exchange können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Contacts WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Der Jitterbit Connector für Exchange modelliert die Exchange 2- und Exchange APIs als relationale Tabellen, Ansichten und gespeicherte Prozeduren. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt.

Die verfügbaren Entitäten sowie alle API Einschränkungen und-Anforderungen für die Abfrage dieser Entitäten sind im EWS-Datenmodell (dokumentiert und MSGraph-Datenmodell. Sie können die SupportEnhancedSQL Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Überblick

Die Datenmodelle zeigen ein Beispiel, wie Ihre Exchange-Umfeld aussehen könnte. Das eigentliche Datenmodell wird dynamisch basierend auf Ihrem Exchange-Konto abgerufen.

Hauptmerkmale

• Tabellen und Ansichten werden dynamisch definiert, um Kalender, Dokumente und Projekte in Exchange zu modellieren.
• Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Exchange, einschließlich des Herunterladens und Hochladens von Objekten.
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Exchange-Konto bei Verwendung des Connectors sofort berücksichtigt werden.

EWS-Datenmodell

EWS-Datenmodell beschreibt die verfügbaren Schemata für die Verbindung mit Exchange OnPremise und Exchange Online mithilfe von EWS. Sie können Tabellen verwenden, um mit Live-Exchange-Daten zu arbeiten. Sie können gespeicherte Prozeduren verwenden, die von Jitterbit Connector für Exchange bereitgestellt werden, um die Arbeit mit Exchange-Daten zu automatisieren.

MSGraph-Datenmodell

MSGraph-Datenmodell beschreibt die Schemata, die für die Verbindung mit Exchange Online-Konten über Microsoft Graph verfügbar sind. Sie können Tabellen verwenden, um mit Live-Exchange-Daten zu arbeiten. Sie können gespeicherte Prozeduren verwenden, die von Jitterbit Connector für Exchange bereitgestellt werden, um die Arbeit mit Exchange-Daten zu automatisieren.

EWS-Datenmodell

Der Jitterbit Connector für Exchange modelliert Exchange-Entitäten als relationale Tabellen und Gespeicherte Prozeduren. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt.

API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert. Sie können die SupportEnhancedSQL-Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zu Exchange. Sie können zum Suchen, Aktualisieren und Ändern von Informationen in Exchange verwendet werden.

Tabellen

Der Connector modelliert die Daten in Exchange in eine Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Exchange-Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Anfrage gestellt werden muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Jitterbit-Connector für Exchange-Tabellen

Kalender

Kalenderelemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Wählen Sie wiederkehrende Ereignisse aus

Wenn Sie einen SELECT Operation für die Kalendertabelle ausführen, schließt der Connector standardmäßig keine einzelnen wiederkehrenden Ereignisse ein (nur das Hauptelement wird eingeschlossen). Wenn Sie die einzelnen Wiederholungen eines wiederkehrenden Ereignisses anzeigen möchten, müssen Sie die ItemId angeben. Ihre Abfrage muss eine WHERE-Klausel ähnlich der folgenden enthalten:

SELECT Subject,IsRecurring,Recurrence_StartDate,Recurrence_EndDate,Recurrence_Interval,Recurrence_Type,Recurrence_NumberOfOccurrences,FirstOccurrence_Start  FROM Calendar WHERE ItemId='myid'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Calendar_OptionalAttendees

Die optionalen Teilnehmer für ein bestimmtes Ereignis. Bei der Abfrage dieser Ansicht muss eine ItemId angegeben werden.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Einfügen

Wenn Sie einen SELECT Operation für die Kalendertabelle ausführen, schließt der Connector standardmäßig keine einzelnen wiederkehrenden Ereignisse ein (nur das Hauptelement wird eingeschlossen). Wenn Sie die einzelnen Wiederholungen eines wiederkehrenden Ereignisses anzeigen möchten, müssen Sie die Suche nach der Spalte „IsRecurring“ filtern und mit „Start“ und „End“ einen Zeitraum angeben. Ihre Abfrage muss eine WHERE-Klausel ähnlich der folgenden enthalten:

INSERT INTO Calendar_OptionalAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Calendar_RequiredAttendees

Die erforderlichen Teilnehmer für ein bestimmtes Ereignis. Bei der Abfrage dieser Ansicht muss eine ItemId angegeben werden.

Tabellenspezifische Informationen

Insert-Anweisungen

Wenn Sie einen INSERT Operation durchführen, müssen Sie EmailAddress und ItemId angeben. Darüber hinaus gibt es eine Eigenschaft namens SendMeetingInvitations, die Sie festlegen können, um zu entscheiden, wer benachrichtigt wird, wenn Sie erforderliche Teilnehmer einfügen.

INSERT INTO Calendar_RequiredAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kontakte

Erstellen, aktualisieren, löschen und Abfrage Kontaktelemente.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gelöschte Elemente

Erstellen, aktualisieren, löschen und Abfrage gelöschte Elemente.

Tabellenspezifische Informationen

Wählen Sie Emails aus den Unterordnern „DeletedItems“ aus

Wenn Sie eine SELECT Operation für die Tabelle „DeletedItems“ ausführen, schließt der Connector nicht die Elemente in den Unterordnern unter „DeletedItems“ ein, sondern nur die Elemente, die im Ordner „DeletedItems“ enthalten sind. Wenn Sie die Elemente unter den Unterordnern „DeletedItems“ abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede ID des Unterordners „DeletedItems“ abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Tabelle „Ordner“ ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Unterordnern „DeletedItems“ abzurufen:

SELECT * FROM DeletedItems where ParentFolderId in (Select FolderId from Folders where ParentFolderName='DeletedItems' and TotalCount>0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Entwürfe

Entwurfselemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Emails aus Unterordnern „Entwürfe“ auswählen

Wenn Sie eine SELECT Operation für die Drafts-Tabelle durchführen, schließt der Connector nicht die Elemente in den Unterordnern unter Drafts ein, sondern nur die Elemente, die im Drafts-Ordner enthalten sind. Wenn Sie die Elemente in den Drafts-Unterordnern abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede Drafts-Unterordner-ID abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Folders-Tabelle ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Drafts-Unterordnern abzurufen:

SELECT * FROM Drafts where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Drafts' and TotalCount>0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ordner

Erstellen, aktualisieren, löschen und Abfrage Unterordner für einen bestimmten Ordner.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den FolderChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den FolderChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die Zeit für die Ausführung einer Abfrage verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Posteingang

Posteingangselemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Emails aus Posteingangsunterordnern auswählen

Wenn Sie einen SELECT Operation für die Tabelle „Posteingang“ ausführen, schließt der Connector nicht die Elemente in den Unterordnern unter „Posteingang“ ein, sondern nur die Elemente, die im Ordner „Posteingang“ enthalten sind. Wenn Sie die Elemente unter den Unterordnern „Posteingang“ abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede ID des Unterordners „Posteingang“ abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Tabelle „Ordner“ ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Unterordnern „Posteingang“ abzurufen:

SELECT * FROM Inbox where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Inbox' and TotalCount>0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

JunkEmail

Erstellen, aktualisieren, löschen und Abfrage Junk Email Elemente.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Postausgang

Postausgangselemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Emails aus Unterordnern des Postausgangs auswählen

Wenn Sie einen SELECT Operation für die Tabelle „Postausgang“ ausführen, schließt der Connector nicht die Elemente in den Unterordnern unter „Postausgang“ ein, sondern nur die Elemente, die im Ordner „Postausgang“ enthalten sind. Wenn Sie die Elemente in den Unterordnern „Postausgang“ abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede ID des Unterordners „Postausgang“ abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Tabelle „Ordner“ ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den Unterordnern „Postausgang“ abzurufen:

SELECT * FROM Outbox where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Outbox' and TotalCount>0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gesendete Artikel

Erstellen, aktualisieren, löschen und Abfrage gesendete Elemente.

Tabellenspezifische Informationen

Emails aus SentItems-Unterordnern auswählen

Wenn Sie eine SELECT Operation für die SentItems-Tabelle durchführen, schließt der Connector nicht die Elemente in den Unterordnern unter SentItems ein, sondern nur die Elemente, die im SentItems-Ordner enthalten sind. Wenn Sie die Elemente unter den SentItems-Unterordnern abrufen möchten, müssen Sie die ParentFolderId-s in der WHERE-Klausel angeben. Sie können jede SentItems-Unterordner-ID abrufen, indem Sie eine nach ParentFolderName gefilterte Abfrage für die Ordnertabelle ausführen. Sie können die folgende Abfrage verwenden, um die Elemente in den SentItems-Unterordnern abzurufen:

SELECT * FROM SentItems where ParentFolderId in (Select FolderId from Folders where ParentFolderName='SentItems' and TotalCount>0)

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Aufgaben

Aufgabenelemente erstellen, aktualisieren, löschen und Abfrage.

Tabellenspezifische Informationen

Aktualisieren und Löschen

Der Connector benötigt den ItemChangeKey, um ein Element zu aktualisieren oder zu löschen. Wenn Sie sich jedoch über den ItemChangeKey nicht sicher sind, kann der Connector ihn automatisch vom Exchange-Server abrufen. Beachten Sie, dass dies die zum Ausführen einer Abfrage erforderliche Zeit verlängern kann.

Wiederholungsfelder

Um die Wiederholungsfelder in einer Aufgabe EINFÜGEN, AUSWÄHLEN oder AKTUALISIEREN zu können, müssen Sie sicherstellen, dass Sie nur die Felder festlegen, die mit den Feldern Wiederholungstyp und Wiederholungsdauer verknüpft sind. Bitte beachten Sie die folgenden Tabellen:

Recurrence_Type-Werte und zugehörige Felder

Recurrence_Duration und zugehörige Felder

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Jitterbit-Connector für gespeicherte Exchange-Prozeduren

Anhänge erstellen

Erstellen Sie einen Anhang und fügen Sie ihn einer vorhandenen Email hinzu.

Gespeicherte Prozedurspezifische Informationen

Verwenden Sie das Verfahren CreateAttachments, um einer vorhandenen Email einen Anhang hinzuzufügen. Um die Dateipfade der Anhänge anzugeben, verwenden Sie die Eingabe „Attachments“, während Sie für Base64-codierten Inhalt „AttachmentContent“ und „AttachmentName“ angeben.

EXECUTE CreateAttachments ItemId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD/FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAxEAAABDJHYjDdygQ5pQPUEu3S2cAAVZoayvAAAA', Attachments = 'C:\Users\User\Desktop\logfile.txt,C:\Users\User\Desktop\TestConnectionLog.txt'

Eingabe

Ergebnissatzspalten

Anhang abrufen

Ruft die angegebenen Anhänge ab.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft ein Authentifizierungstoken von Outlook ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die Autorisierungs URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt. Sie fordern den OAuthAccessToken von dieser URL an.

Eingang

Ergebnissatzspalten

GetUserOfSettings (Benutzereinstellungen abrufen)

Bietet Zugriff auf die Abwesenheitseinstellungen eines Benutzers. Ein Benutzer wird anhand seiner Email-Adresse identifiziert. Wenn die Abwesenheitsnachricht null ist und Abwesenheitsnachrichten aktiviert sind, wird keine Abwesenheitsnachricht gesendet.

Eingang

Ergebnissatzspalten