Skip to end of banner
Go to start of banner

WIP-OAuth2 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 6 Next »

In this article

Overview

You can use this account type to connect HTTP Client Snap with data sources that use OAuth2 account.

Prerequisites

  • Valid Client ID, Client secret, OAuth2 Endpoint, and OAuth2 Token.

Limitations

None.

Known Issues

None.

Account Settings

<Insert image here>

  • 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 Name

Field Type

Description

Label*

Default Value: None
Example: OAuth2 Account

String

Specify a unique label for the account.

Client ID*

Default Value: N/A
Examplep369e45x-352x-440p-9pb0-932xep12p593

String

Specify the OAuth Client ID associated with your account. You can create the client ID as advised by your application provider.

Client secret

Default Value: N/A
Example!tz@wld*(687 

String

Specify the OAuth Client secret associated with your account.

Access token

Default Value: N/A
Example: N/A

String

Auto-generated upon account authorization. The access token is used to make API requests on behalf of the user associated with the client ID.

Refresh token

Default Value: N/A
Example: N/A

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.

You should retrieve the Refresh token when setting up the account for the endpoint, where the OAuth2 flow is executed and the resulting refresh token is stored in this field. If the refresh token is stored, then the access token can be refreshed automatically before it expires. 

Access token expiration

Default Value: Current Time + 3600 seconds
Example10000

Integer

Auto-generated upon account authorization. The number of seconds after which the access token expires.

Header authenticated

Default Value: Deselected
Example: N/A

Checkbox

Select this checkbox if the endpoint uses bearer header authentication.

OAuth2 Endpoint*

Default Value: N/A
Examplehttps://login.microsoftonline.com/common/oauth2/v2.0/authorize

String

Specify the URL of the endpoint that authorizes the application. 

OAuth2 Token*

Default Value: N/A
Examplehttps://login.microsoftonline.com/common/oauth2/token

String

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

If you are using a REST OAuth2 Account, access the account token through account.access_token explicitly. The property must be marked as an expression. An example URL for LinkedIn is: "https://api.linkedin.com/v1/people/~?oauth2_access_token=" + account.access_token.

Grant Type

Default ValueAuthorization Code
Exampleclient_credentials

Dropdown

Select the method of authorization.

  • Authorization Code: The user is authenticated using credentials (username and password), which return to the client through a redirect URL. The application then receives the authorization code from the URL and uses it to request an access token.

  • Client Credentials: Obtains an access token for the client ID and client secret through the token endpoint URL.

  • Password: Obtains access token using your login credentials (username and password). When selected, it populates the following fields:

    • Username: Specify the username of the account type.

    • Password: Specify the password of the account type.

Token endpoint config

Use this field set to define custom properties for the OAuth2 token endpoint. This endpoint returns access tokens or refresh tokens depending on the request parameters.

Token endpoint parameter

Default Value: N/A
Exampleredirect_uri

String

Specify the parameter for the token endpoint.

Token endpoint parameter value

Default Value: N/A
Examplehttps://elastic.snaplogic.com/api/1/snowflake/admin/oauth2callback/snowflake

String

Specify the value for the token endpoint parameter.

Auth endpoint config

Use this fieldset to define custom properties for the OAuth2 authentication endpoint.

Authentication parameter

Default Value: N/A
Exampleredirect_uri

String

Specify the parameter for the token endpoint.

Authentication parameter value

Default Value: N/A
Examplehttps://elastic.snaplogic.com/api/1/snowflake/admin/oauth2callback/snowflake

String

Specify the value for the OAuth2 authentication parameter.

Auto-refresh token

Default Value: Deselected

Checkbox

String

Select this checkbox to enable auto-refresh of the access token before it expires.

Troubleshooting

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

Error rendering macro 'excerpt-include' : No link could be created for 'XYZ Snap Pack'.

  • No labels