Microsoft Exchange Connection
See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium Microsoft Exchange connector.
Microsoft Exchange is a server software that provides email, calendar, and contact management for businesses and orgaanizations.
This topic describes how to authenticate to Microsoft Exchange and configure any necessary connection properties in the Microsoft Exchange connection connector.
Connection Configuration
Each connection property available in the Microsoft Exchange connector is explained below.
Connection Name
The name of the connection to be created should be provided. This is the name that will display on the list of available connections.
Server
The address (Web Services URL) of the Exchange server to which you are connecting.
For Exchange Online, you should set it to https://outlook.office365.com/EWS/Exchange.asmx.
Auth Scheme
The type of authentication to use when connecting to Microsoft Exchange.
Possible Values
Basic
Set this to use HTTP Basic authentication.
If Basic is selected, additional configuration parameters will get listed.
User
The username used to authenticate to the Exchange site.
Password
The password used to authenticate to the Exchange site.
AzureAD
Set this to perform Azure Active Directory OAuth authentication. This authentication scheme is applicable only for the Exchange_Online Platform.
If AzureAD is selected, additional configuration parameters will get listed.
Azure Tenant
The Microsoft Online tenant being used to access data. If not specified, your default tenant is used.
Example: contoso.onmicrosoft.com
Alternatively, specify the tenant Id. This value is the directory Id in the Azure Portal > Azure Active Directory > Properties.
Client ID
The client ID assigned when you register your application with an OAuth authorization server.
As part of registering an OAuth application, you will receive the ClientId value, sometimes also called a consumer key.
Client Secret
The client secret assigned when you register your application with an OAuth authorization server.
As part of registering an OAuth application, you will receive a client secret, also called a consumer secret.
Refresh Token
The OAuth refresh token for the corresponding OAuth access token.
API
Choose the preferred API to interact with Microsoft Exchange, either MS Graph or EWS.
Platform
The Platform associated with the Exchange server.
Possible Values:
| Platform | Description |
|---|---|
| Exchange2007* | Target the initial release version of Exchange 2007. |
| Exchange2007_SP1* | Target Exchange 2007 Service Pack 1 (SP1), Exchange 2007 Service Pack 2 (SP2), and Exchange 2007 Service Pack 3 (SP3). |
| Exchange2010 | Target Exchange 2010. |
| Exchange2010_SP1 | Target Exchange 2010 Service Pack 1 (SP1). |
| Exchange2010_SP2 | Target Exchange 2010 Service Pack 2 (SP2) and Exchange 2010 Service Pack 3 (SP3). |
| Exchange2013 | Target Exchange 2013. |
| Exchange2013_SP1 | Target Exchange 2013 Service Pack 1 (SP1). |
| Exchange_Online | Target Exchange Online. |
- These APIs do not support filtering using the WHERE clause. Instead, the connector parses the WHERE clause in memory.
Add Configuration: Additional properties can be added using this option as key-value pairs.
After entering all the details, click on the TEST button.
If the connection service identification and authentication details are provided correctly, a success message stating “connection available” is generated.
Click on the CREATE button to save the changes.
If the details are incorrect or the server is down, you will get a message “Connection unavailable”.
If you have any feedback on Gathr documentation, please email us!