In this article
Overview
You can use this account type to connect the HTTP Client Snap with data sources that use the OAuth2 account.
Prerequisites
Valid Client ID, Client secret, OAuth2 Endpoint, and OAuth2 Token.
Limitations and Known Issues
None.
Account Settings
Asterisk ( * ): Indicates a mandatory field.
Suggestion icon ( ): Indicates a list that is dynamically populated based on the configuration.
Expression icon ( ): Indicates 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 | |
---|---|---|---|
Label* Default Value: None | String | Specify a unique label for the account. | |
Client ID* Default Value: N/A | 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 | String | Specify the OAuth Client secret associated with your account. | |
Send client data as Basic Auth header Default Value: Deselected | Checkbox | Select this checkbox to pass the client data as part of the Basic Auth header when generating a token. | |
Access token Default Value: N/A | String | Autogenerated on 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 | String | Autogenerated 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 | Integer | Autogenerated on account authorization. The number of seconds after which the access token expires. | |
Header authenticated Default Value: Deselected | Checkbox | Select this checkbox if the endpoint uses bearer header authentication. | |
OAuth2 Endpoint* Default Value: N/A | String | Specify the URL of the endpoint that authorizes the application. | |
OAuth2 Token* Default Value: N/A | 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 | |
Grant Type Default Value: authorization_code | Dropdown | Select the method of authorization.
| |
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 | String | Specify the parameter for the token endpoint. | |
Token endpoint parameter value Default Value: N/A | 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 | String | Specify the parameter for the token endpoint. | |
Authentication parameter value Default Value: N/A | String | Specify the value for the OAuth2 authentication parameter. | |
Auto-refresh token Default Value: Deselected | Checkbox | String | Select this checkbox to enable autorefresh of the access token before it expires. |
Redirect URL: 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/apisuite
You must append the Snap Pack name at the end of the Redirect URI; else your account will be unauthorized.
Snap Pack History
Release | Snap Pack Version | Date | Type | Updates |
---|---|---|---|---|
August 2024 | 438patches28040 |
| Latest | Enhanced the HTTP Client Snap with improved handling of redirect URL encoding to minimize runtime errors. |
August 2024 | main27765 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
May 2024 | 437patches27592 |
| Latest | Updated the API Suite Snaps to process authentication information from incoming documents to support features such as Secrets manager-based credentials. |
May 2024 | 437patches27587 |
| Latest | Fixed an issue with the HTTP Client Snap that caused |
May 2024 | 437patches26862 |
| Latest | Fixed an issue with the HTTP Client Snap where redirect URLs containing spaces were not properly encoded, resulting in runtime errors. |
May 2024 | 437patches26826 |
| Latest | Enhanced the SSL OAuth2 Account with the Send Client Data as Basic Auth header checkbox that enables you to send the client information as a header to the OAuth endpoint. |
May 2024 | 437patches26522 |
| Latest | Enhanced the OAuth2 account with Snaplex support for executing OAuth2 operations. |
May 2024 | 437patches26491 |
| Latest | Fixed an issue with the GraphQL Client Snap that displayed an error when passing the |
May 2024 | main26341 | Stable | Updated and certified against the current SnapLogic Platform release. | |
February 2024 | 436patches25508 |
| Latest | Enhanced the HTTP Client Snap to optimize the memory usage by accumulating the |
February 2024 | 463patches25211 |
| Latest | Enhanced the GraphQL Client Snap to include detailed stack trace, error message, and reason within the Snap error view output. |
February 2024 | main25112 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
November 2023 | 435patches25047 |
| Latest | Fixed an issue that caused the HTTP Client Snap to fail when the Basic Authentication account password contained special characters. |
November 2023 | 435patches24708 |
| Latest |
|
November 2023 | 435patches24208 |
| Latest | Fixed an issue with the HTTP Client Snap that caused incorrect parsing of the |
November 2023 | 435patches23943 |
| Latest | Fixed an issue with the GraphQL Client Snap that displayed a null pointer exception when the Header authenticated checkbox in the OAuth2 Account is deselected. The Snap now passes the credentials appropriately using URL parameters when the Header authenticated field is deselected. |
November 2023 | main23721 |
| Stable | Added the Google Service Account to the HTTP Client Snap, which enables you to connect to various Google Cloud endpoints such as Analytics 4 and Compute Engine. |
August 2023 | 434patches23079 |
| Latest | Fixed an issue with the SnapLogic SSL Account for the HTTP Client Snap where a blank keystore or truststore URL caused an error during account configuration. |
August 2023 | 434patches22631 |
| Latest | Fixed an issue with the HTTP Client Snap that displayed incorrect cookie information, with a null value in the cookies when you have duplicate cookies in the header. The Snap now displays the cookie information correctly. |
August 2023 | main22460 |
| Stable | Updated and certified against the current SnapLogic Platform release. |
May 2023 | 433patches22065 |
| Latest | Fixed an issue with the GraphQL Client Snap that caused an error even when the variable value was defined in the previous Snap. |
May 2023 | 433patches21959 |
| Latest | Fixed an issue with the HTTP Client Snap that caused an intermittent connectivity issue, which resulted in a |
May 2023 | 433patches21860 |
| Latest | Fixed an issue with the HTTP Client Snap where the Snap now conceals the additional authentication headers in the debug information for Secured Headers Account. |
May 2023 | 433patches21346 |
| Latest | Fixed an issue with the HTTP Client Snap where the validation of the SSL Account for a specified Keystore or Truststore value failed despite providing the correct password. |
May 2023 | 433patches21307 |
| Latest | Fixed an issue with the HTTP Client Snap that caused pagination to fail when the next Snap in the pipeline could modify the input document (for example, the Mapper Snap). Behavior Change: |
May 2023 | 433patches21140 |
| Latest |
|
May 2023 | main21015 |
| Stable | Introduced the GraphQL Client Snap, which enables you to query a GraphQL endpoint and retrieve data. This Snap features a built-in query builder to help you efficiently build queries. |
February 2023 | 432patches20818 |
| Latest |
|
February 2023 | 432patches20054 |
| Latest | For Snaps using AWS Signature V4 accounts, DNS canonical names are now supported for S3 buckets. |
February 2023 | main19844 |
| Stable | Upgraded with the latest SnapLogic Platform release. |
November 2022 | 431patches19006 |
| Latest | The HTTP Client Snap does not fail when making a PATCH request containing an empty response body and location in the Headers. The Snap checks the entity length if the response entity is empty and skips the data conversion. |
November 2022 | main18944 |
| Stable | The HTTP Client Snap now accepts the default value |
October 2022 | 430patches18454 |
| Latest and Stable | Introduced the API Suite Snap Pack that contains the HTTP Client Snap. This Snap unifies all supported HTTP methods: GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, and PATCH that you can execute on a REST API service endpoint. |