Exact Online OAuth2.0 Account

In this article

Overview

You can use this account type to connect Exact Online Snaps with Exact Online instance using the Exact Online OAuth 2.0 Account.

Prerequisites

  • Valid Exact Online Login account (valid user name and password)

  • Valid client application (valid client Id and client secret)

Limitations and Known Issues

None

Account Settings

Exact Online OAuth2.0 Account Settings.png

Call-back Domain: The redirect URI must be set differently in the app that is created in the endpoint: https://<SnapLogic_POD_Name>/api/1/rest/admin/oauth2callback/rest

For example: "https://elastic.snaplogic.com/api/1/rest/admin/oauth2callback/rest" in the screenshot below:

Exact Online OAuth2.0 Account_Authorization details.png
  • Asterisk (*): Indicates a mandatory field.

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

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

  • Add icon ( ): Indicates that you can add fields in the field set.

  • Remove icon (): Indicates that you can remove fields from the field set.

Field Name

Field Type

Description

Field Name

Field Type

Description

Label*

String

Specify the name for the account. We recommend you to update the account name, if there is more than one account in your project.

Default Value: [None]
Example: Exact Online OAuth2 Account

Client ID*

String

Specify the client ID associated with your account. You can create the client ID as advised by your application provider. Learn more about obtaining Client ID and Client Secret.

Default Value: N/A
Example: p364e45x-953x-460p-9pb0-934xep16p693

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 obtaining Client ID and Client Secret.

Default Value: N/A
Example: aBC232320mxyz=

Access token

String

Auto-generated after authorization. The token that SnapLogic uses to make API requests on behalf of the user associated with the client ID.

Default Value: N/A
Example: 78456578

Refresh token

Integer

Auto-generated after authorization. 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: 157842

Access token expiration

Integer

Auto-generated after authorization. The access token expiration value, in seconds.

Default Value: <Current Time + 3600 seconds>
Example: 1612279710

OAuth2 Endpoint*

String

Specify the URL of the endpoint that authorizes the application. 

Default Value: N/A
Example: Exact Online

OAuth2 Token*



String

 Specify the URL of the endpoint that retrieves the token for an authenticated account.

Default Value: N/A
Example: Exact Online

Token endpoint config

Use this field set to configure token endpoint parameters as necessary for the account. This field set comprises the following fields:

  • Token endpoint parameter

  • Token endpoint parameter value

Token endpoint parameter

String

Provide the name for the token endpoint parameter.

Default Value: N/A
Example: scope, redirect_uri

Token endpoint parameter value

String

Provide the value for the parameter, typically the default scope or a redirect_uri.

Default Value: N/A
Example: .default https://elastic.snaplogic.com/api/1/rest/admin/oauth2callback/exactonline

Auth endpoint config

Use this field set to provide custom properties for the OAuth2 auth endpoint. Click the + or - icons to respectively add or remove configuration rows. This field set comprises the following fields:

  • Auth endpoint parameter

  • Auth endpoint value

Auth endpoint parameter

String

Specify the name for the token endpoint parameter.

Default Value: N/A
Example: scope

Auth endpoint value

String

Specify the value for the endpoint parameter defined above.

Default Value: N/A
Example: read_orders, write_orders

Auto-refresh token

Checkbox

Select this checkbox to refresh the token automatically using the refresh token, if the property is enabled. If this property is deselected, the token expires and is not refreshed automatically.

Default Value: Deselected

Authorize

Button

Click this button to authorize the Exact Online OAuth2 account using the credentials provided in the Client ID, Client Secret, OAuth2 Endpoint, and OAuth2 Token fields.

Refresh

Button

Click this button to refresh the access token using the credentials provided in the Client ID, Client Secret, OAuth2 Token, and refresh token fields.

To create your Exact Online OAuth2 account in SnapLogic, you must provide your Client ID, Client secret, OAuth2 endpoint, and OAuth2 token and click Authorize. SnapLogic sends your account details to the OAuth2 endpoint specified and populates the Access token, Refresh token, and Access token expiration fields using the details received from that endpoint.

Troubleshooting

Error

Reason

Resolution

Error

Reason

Resolution

Account validation failed.

The Pipeline ended before the batch could complete execution due to a connection error.

Verify that the Refresh token is configured to handle the inputs properly. If you are not sure when the input data is available, configure this field as zero to keep the connection always open.

Snap Pack History

 


See Also

Configuring Exact Online Account

https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1439233/Glossary

https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/1438341/Getting+Started