Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

Table of Contents
maxLevel2
absoluteUrltrue

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

...

Valid client ID and client secret.

Limitations

None.

Known Issues

None.

Account Settings

Image Removed

...

Required. Unique user-provided label for the account.

...

Limitations and Known Issues

None.

Account Settings

...

Info
  • 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.

Client secret

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

1394786838725.1307264331815client

Example: <Encrypted>

String

Required. Enter the Required. Enter the

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

bec1f9242f9nsh67f2276b9ws4cadd14Access tokenString

Example: <Encrypted>

String

Auto-generated after authorization. 
Specify the access token associated with

the Azure application is 

the OAUth2 application is used to make API requests on behalf of the user associated with the client ID.

N/A

Refresh token


Default Value: N/A

Refresh token

Example:<Encrypted>

String

Required

Auto-generated after authorization. 

Enter the refresh token retrieval for the application specified when setting up the account for the endpoint. There, the OAuth2 flow will be executed and the resulting refresh token can be stored in this property. If the Access token expirationNumericEnter the access token expiration value.N/AN/AOAuth2 EndpointString

Required. Enter the authorization endpoint to authorize the application.


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

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/

<tenant-id>

421e110c-7e44-4f7b-757d-e3d423916beb/oauth2/v2.0/authorize

OAuth2 Token

String

Required. Enter token endpoint to get the access token.

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/

<tenant-id>

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

fieldset

field set to provide custom properties for the OAuth2 token endpoint

. Click the + or - icons to respectively add or remove configuration rows

.

This fieldset comprises the following fields:

Token endpoint parameter

  • Token endpoint parameter value
  • 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

    user_scopeToken endpoint parameter value

    Example: offline_access User.Read  Mail.ReadWrite   MailboxSettings.ReadWrite  Calendars.ReadWrite   Contacts.ReadWrite

    String

    Provides custom properties for the OAuth2 auth endpoint.

    N/Ausers:read

    Auth endpoint config



    Use this

    fieldset

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

     Click the + or - icons to respectively add or remove configuration rows.

    This fieldset comprises the following fields:

    • Auth endpoint parameter
    • Auth endpoint value
    Auth endpoint parameterStringDefines an optional authentication parameter.

     

    Auth endpoint parameter


    Default Value: N/A

    user_

    Example: scope

    Auth endpoint value

    String

    Defines an optional

    Specify the name of the endpoint authentication parameter

    value

    .

    Auth endpoint value


    Default Value: N/A

    files:writeAuto-refresh tokenCheck boxSelect to refresh the token automatically using the refresh token if the property is enabled. Otherwise, the token might expire and will not be automatically  refreshed.Not selectedSelected

    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 

    incorrect Client ID

     or 

     or Client secret.

    Check and ensure that you have

    supplied

    provided the correct and

    valid 

    valid Client ID

     and 

     and Client secret

     for

     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 

    incorrect Client ID.

    Check and correct

    the 

    the Client ID

     entered

     entered for the account and try authorizing the app again.

    See Also

    ...

    Snap Pack History

    Expand

    Insert excerpt
    Exchange Online Snap Pack
    Exchange Online Snap Pack
    nameExchange_Online_SPH
    nopaneltrue

    ...

    Related content