Exchange Online OAuth2 User Account

Overview

You can configure your accounts in SnapLogic using the Designer or Manager. Use this account type to connect Exchange Online Snaps with data sources that use Exchange Online OAuth2 User accounts. The Exchange Online OAuth2 User Account has limited user permissions as you do not require all the permissions in the Microsoft Azure Portal. The User Account is typically used when an individual user needs access to the Exchange Online mailbox. This method allows the application or service to interact with the user's Exchange Online mailbox on their behalf.

Prerequisites

Valid Azure application in Azure portal with the required API permissions.

Account settings

Note: Learn about the common controls in the Snap settings dialog.


Field/Field set	Description
Label* `String`	Specify a unique label for the account. Default value: N/A Example: `Exchange Online OAuth2 User Account`
Client ID* `String`	Specify the client ID associated with your Azure application. You can create the client ID as advised by your application provider. Learn more about how to generate Client ID: Application Configuration in Azure Portal for OAuth2 Account to use in Exchange Online Default value: N/A Example: `39dh47-86838725-1307264jgf-gsf331815`
Client secret* `String`	Specify the client secret associated with your account. You can create the client secret as advised by your application provider. Learn more about how to generate Client Secret: Application Configuration in Azure Portal for OAuth2 Account to use in Exchange Online Default value: N/A Example: `<Encrypted>`
Access token `String`	Auto-generated after authorization. Specify the access token associated with the OAuth2 application. It is used to make API requests on behalf of the user associated with the client ID. Default value: N/A Example: `<Encrypted>`
Refresh token `String`	Auto-generated after authorization. Specify the refresh token associated with your account. If the refresh token is stored, then the access token can be refreshed automatically before it expires. Default value: N/A Example: `<Encrypted>`
Access token expiration `Integer`	Auto-generated after authorization. Specify the duration till which the access token remains active. Default value: N/A Example: `4532291`
OAuth2 Endpoint* `String`	Specify the authorization endpoint to authorize the application. Replace the tenant ID placeholder with the tenant ID generated while creating the OAuth2 application. Default value: `https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/authorize` Example: `https://login.microsoftonline.com/421e110c-7e44-4f7b-757d-e3d423916beb/oauth2/v2.0/authorize`
OAuth2 Token* `String`	Specify the token endpoint to get the access token. Replace the tenant ID placeholder with the tenant ID generated while creating the OAuth2 application. Default value: `https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token` Example: `https://login.microsoftonline.com/413e110c-7d55-4f7b-947d-e3d423916beb/oauth2/v2.0/token`
Token endpoint config	Use this field set to provide custom properties for the OAuth2 token endpoint.
Token endpoint parameter `String`	Defines an optional token endpoint parameter value. Default value: N/A Example: `scope`
Token endpoint parameter value `String`	Provides custom properties for the OAuth2 auth endpoint. Default value: N/A Example: `offline_access User.Read Mail.ReadWrite MailboxSettings.ReadWrite Calendars.ReadWrite Contacts.ReadWrite`
Auth endpoint config	Use this field set to provide custom properties for the OAuth2 auth endpoint.
Auth endpoint parameter `String`	Specify the name of the endpoint authentication parameter. Default value: N/A Example: `scope`
Auth endpoint value `String`	Specify the value corresponding to the endpoint authentication parameter. Default value: N/A Example: `offline_access User.Read Mail.ReadWrite MailboxSettings.ReadWrite Calendars.ReadWrite Contacts.ReadWrite`
Graph service URL `String`	Specify the Graph service URL. To connect to a Microsoft cloud other than the global cloud (such as the Government or China), you must configure the corresponding Token Endpoint and Authorization Endpoint to match the environment. US Government L5 (DoD): `https://dod-graph.microsoft.us/v1.0` Microsoft Graph China (21Vianet): `https://microsoftgraph.chinacloudapi.cn/v1.0` US Government L4 (GCC High): `https://graph.microsoft.us/v1.0` Learn more Default value: `https://graph.microsoft.com/v1.0` Example: `https://dod-graph.microsoft.us`

Troubleshooting


Type	Description	Examples of upstream and downstream Snaps
`Authentication failed.`	You have entered an incorrect Client ID or Client secret.	Check and ensure that you have provided the correct and valid Client ID and Client secret for the account and allowed the required access privileges to the application.
`Error in Authorization: Something went wrong when authorizing this app. Invalid client_id parameter.`	You have entered an incorrect Client ID.	Check and correct the Client ID entered for the account and try authorizing the app again.