Skip to end of banner
Go to start of banner

Exchange Online OAuth2 User Account

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 26 Current »

In this article

Overview

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. Refer to this example to know when to use the Exchange Online OAuth2 User Account.

Prerequisites

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

Limitations and Known Issues

None.

Account Settings

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon ( (blue star) ): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon ( (blue star) ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( (blue star) ): Indicates that you can add fields in the fieldset.

  • Remove icon ( (blue star) ): Indicates that you can remove fields from the fieldset.

Field

Field Type

Description

Label*


Default Value: None
ExampleExchange Online OAuth2 User Account

String

Specify a unique name for the account.

Client ID*


Default Value: N/A
Example39dh47-86838725-1307264jgf-gsf331815

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 

Client secret*


Default Value: N/A
Example: <Encrypted>

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

Access token


Default Value: N/A
Example: <Encrypted>

String

Auto-generated after authorization. 
Specify the access token associated with the OAUth2 application is used to make API requests on behalf of the user associated with the client ID.

Refresh token


Default Value: N/A
Example:<Encrypted>

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.

Access token expiration


Default Value: N/A
Example: 4532291

Integer

Auto-generated after authorization. 

Specify the duration till which the access token remains active.

OAuth2 Endpoint*


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

String

Specify the authorization endpoint to authorize the application. Replace tenant ID placeholder with the tenant ID generated while creating OAuth2 application.

OAuth2 Token*


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

String

Specify the token endpoint to get the access token. Replace tenant ID placeholder with the tenant ID generated while creating OAuth2 application.

Token endpoint config



Use this field set to provide custom properties for the OAuth2 token endpoint.

Token endpoint parameter


Default Value: N/A
Example: scope

String

Defines an optional token endpoint parameter value.

Token endpoint parameter value


Default Value: N/A
Example: offline_access User.Read  Mail.ReadWrite   MailboxSettings.ReadWrite  Calendars.ReadWrite   Contacts.ReadWrite

String

Provides custom properties for the OAuth2 auth endpoint.

Auth endpoint config



Use this field set to provide custom properties for the OAuth2 auth endpoint. 

Auth endpoint parameter


Default Value: N/A
Example: scope

String

Specify the name of the endpoint authentication parameter.

Auth endpoint value


Default Value: N/A
Exampleoffline_access  User.Read Mail.ReadWrite    MailboxSettings.ReadWrite  Calendars.ReadWrite   Contacts.ReadWrite

String

Specify the value corresponding to the endpoint authentication parameter.


Troubleshooting

Error

Reason

Resolution

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.

Snap Pack History

 Click here to expand...

Release

Snap Pack Version 

Date

Type

Updates

May 2024

main26341

Stable

Updated and certified against the current SnapLogic Platform release.

February 2024

main25112

Stable

The Microsoft Exchange Snap Pack is deprecated. We recommend that you use the Exchange Online Snap Pack for your existing pipelines containing the Microsoft Exchange Snaps. Contact support@snaplogic.com if your existing pipelines use Snaps from the deprecated Snap Pack.

November 2023

main23721

Stable

Updated and certified against the current SnapLogic Platform release.

August 2023

main22460

Stable

Updated and certified against the current SnapLogic Platform release.

May 2023

433patches22402

Latest

Fixed an issue with the Send Email Snap where attachments larger than 3 MB were not getting attached to the sent email messages.

May 2023

main21015

Stable

Upgraded with the latest SnapLogic Platform release.

February 2023

432patches20437

Latest

Fixed an issue with the Microsoft Exchange Online OAuth2 User and Exchange Online OAuth2 Application accounts that caused 401 unauthorized errors when updating the access tokens.

February 2023

432patches20035

Stable

The below Exchange Online patch got re-deployed as stable.
The following permissions are no longer mandatory for the Exchange Online Snaps to work:

You can choose to not assign these permissions in your Snap accounts.

February 2023

432patches19899

 

Latest

The following permissions are no longer mandatory for the Exchange Online Snaps to work:

You can choose to not delegate these permissions for your Snap accounts.

February 2023

main19844

 

Stable

Upgraded with the latest SnapLogic Platform release.

December 2022

431patches19413

 

Latest

When the Ultra Parent Pipeline is connected to a child Pipeline with the Send Email Snap using the Exchange Online OAuth2 application Account, it now refreshes, obtains a new access token, and continues the Snap operation.

November 2022

main18944

 

Stable

  • The Exchange Online OAuth2 User Account now does not encounter an Access Denied (403) error. Now only the current user details are fetched when you do not have User.Read.All permission in your permissions scope.

  • Exchange Online Read Email:

    • This Snap now shows the email folder suggestions and includes the subfolders' names successfully by prefixing the parent folder name with the / delimiter.

    • This Snap now downloads the inline attachments correctly when you select the Download attachments checkbox. The Snap now shows the email folder suggestions and includes the subfolder names by prefixing the parent folder name with the delimiter (/). For example, custom/subfolder.

  • The Send Email Snap supports sending the HTML Table in the email body using the following fields:

    • HTML Table option under Email type

    • Table Data Path

    • Batch Size

September 2022

430patches18442

 

Latest

The Microsoft Exchange Online List Events Snap now does not fail with the java.net.SocketTimeoutException: timeout error because the default execution (Read and Write) timeout of 10 seconds is updated to 5 minutes.

September 2022

430patches18099

 

Latest

  • The User.Read.All permission is now not mandatory in the Exchange Online OAuth2 User Account while reading and sending messages and creating events. Even if you do not provide this permission, the account does not encounter Access Denied (403) error.
    The User.Read permission fetches only the current user details.

  • The Send Email Snap supports sending the HTML Table in the email body using the following fields:

    • HTML Table option under Email type

    • Table Data Path

    • Batch Size 

  • Enhancements in the Exchange Online Read Email Snap:

    • The Snap now downloads the inline attachments correctly when you select the Download attachments checkbox.

    • The Snap now shows the email folder suggestions and includes the subfolder names successfully by prefixing the parent folder name with the delimiter ('/').

August 2022

main17386

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.29

main15993

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.28

main14627

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.26

main11181

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.25 Patch

425patches10994

 

Latest

Improved the Exchange Online Snap Pack to handle authentication token errors and acquire new tokens and improved the error messages in the Create Event Snap where the Snap fails with Null Pointer Exception when the account reference provided is invalid.

4.25

main9554

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.24

424patches8965

Latest

Fixed an issue of the conflict of users' having similar email IDs by accepting only the first user’s email ID returned by the API and ignoring the duplicate ones.

4.24

main8556

 

Stable

No updates made.

4.23 

main7430

 

Stable

Initial release of the Snap Pack with the following Snaps and Accounts:


Related content

  • No labels