- Welcome to Panoply Documentation
- Getting Started
- Manage Data
- Data Security
- BI and ETL Tools
- Connectors Documents
- Connectors Introduction
- API Connectors
- Appsflyer
- Asana
- BigCommerce
- Bing Ads
- Delighted
- Facebook Ads
- Facebook Pages
- Facebook Posts
- Flex Connector
- Flex Connector Setup Guide
- Flex Connector Advanced Settings
- Flex Connector Authorization
- Flex Connector Variables
- Flex Connector Pagination
- Flex Connector Refresh Access Token
- Flex Connector Fetch List
- Flex Connector Async API
- Flex Connector Release Notes
- Flex Connector Templates
- Google Ads
- Google Analytics 4
- Google Universal Analytics
- Google Search Console
- Hubspot
- Instagram Business
- Intercom
- Jira
- Klaviyo
- LinkedIn Ads
- Mailchimp
- NetSuite
- Pardot
- Quickbooks
- Salesforce
- Shopify
- Square
- Stripe
- Twilio
- Twitter Ads
- WooCommerce
- Xero
- Zendesk
- Database/File Systems
- Data Recipes
- Release Notes
- September 2024 Release Notes
- August 2024 Release Notes
- July 2024 Release Notes
- June 2024 Release Notes
- May 2024 Release Notes
- April 2024 Release Notes
- March 2024 Release Notes
- February 2024 Release Notes
- January 2024 Release Notes
- December 2023 Release Notes
- November 2023 Release Notes
- October 2023 Release Notes
- September 2023 Release Notes
- August 2023 Release Notes
- July 2023 Release Notes
- June 2023 Release Notes
- May 2023 Release Notes
- April 2023 Release Notes
- March 2023 Release Notes
- February 2023 Release Notes
- January 2023 Release Notes
- December 2022 Release Notes
- November 2022 Release Notes
- October 2022 Release Notes
- September 2022 Release Notes
- August 2022 Release Notes
- July 2022 Release Notes
- June 2022 Release Notes
- February 2022 Release Notes
- April 2022 Release Notes
- January 2022 Release Notes
- December 2021 Release Notes
- November 2021 Release Notes
- October 2021 Release Notes
- September 2021 Release Notes
- July 2021 Release Notes
- June 2021 Release Notes
- May 2021 Release Notes
- April 2021 Release Notes
- March 2021 Release Notes
- January 2021 Release Notes
- November 2020 Release Notes
- October 2020 Release Notes Supplemental
- October 2020 Release Notes
- September 2020 Release Notes
- August 2020 Release Notes
- July 2020 Release Notes
- June 2020 Release Notes
- Platform FAQs
Flex Connector Authorization
This document describes the authorization configuration option of the Flex Connector. The majority of API services will require authorization details to extract data. Panoply's Flex Connector supports multiple different authorization options natively.
All authorization methods are still available by adding the relevant details directly in the headers and/or URL parameters and No Auth
in the Authorization configuration.
Available authorization methods:
API Key
- Key - Enter the key name required for the API key. For example,
apikey
. - Value - Enter the API key value.
- Add to - Choose between adding the key and value to the headers or URL parameters.
Bearer Token
- Token - Enter your Bearer Token. Panoply will automatically add
Bearer
to it.
Basic Auth
- Username - Enter your API username.
- Password - Enter your API password.
JWT Bearer
- Algorithm - Select the algorithm to use for the JWT token.
- Secret/Private Key - Enter the secret that’s used with the HMAC-SHA algorithm or the private key for signing the token for RS, ES, and PS algorithms.
- Secret Base64 encoded - Select this option if the secret/private key is encoded in Base64 format.
- Payload - Enter a JSON formatted payload data for your JWT token.
- Additional headers - Enter a JSON formatted headers for your JWT token. You do not need to add the
alg
andtype
headers. - Use token prefix - Select this option if there is a need to add a prefix to the JWT token in the headers.
- Token prefix - Enter the JWT token prefix to be added to the header. The default is
Bearer
. - URL parameter key - Enter the URL parameter key to use when adding the JWT token to the URL parameters.
- Add to - Choose between adding the JWT token to the headers or URL parameters.
OAuth1
- Signature Method - Select the signature method to use when authenticating API calls.
- Realm - Enter the realm specified in the response header
- Consumer Key - Enter the consumer key to be identified in the dedicated API service provider.
- Consumer Secret - Available for HMAC and PLAINTEXT signatures only. Enter the consumer secret to establish ownership of the key above.
- Private Key - Available for RSA signatures only. Enter the private key to generate the authentication signature.
- Access Token - Enter the access token that represents the permissions to access the data.
- Token Secret - Available for HMAC and PLAINTEXT signatures only. Enter the token secret to establish ownership of the access token above.
- Add to - Choose between adding the access token to the headers or URL parameters.
OAuth2
When creating the API app, enter the following URL as the redirect URI:
https://platform.panoply.io/sources/callback.html
- Authorization URL - Enter the URL to retrieve the authorization code from API provider authorization server.
- URL Parameters - Enter URL parameters to include in the authorization request.
- Access Token URL - Enter the URL to exchange the authorization code for an access token.
- Client Id - The dedicated API service client id used to generate authorization codes
- Client Secret - The dedicated API service client secret used to generate authorization codes
- Scope - Enter space delimited list of scopes based on the access required to extract your data.
- Access Token header key - Enter the header key to use with the response’s access token. By default, Panoply will use
Authorization
. - Token prefix - Enter the required token prefix.
- Add to - Choose between adding the access token to the headers or URL parameters.
Once the configuration above is complete, you can click on the Login button to initiate the authentication process. At the end of the authentication process, Panoply will retreive the relevant access and refresh tokens that will be used in the different API calls.
Refresh Acess Token
In many API services, you will be required to refresh the access token. Panoply's Flex Connector supports automation of this refresh process.
First, you will need to enable the refresh of the access token and configure the specific configurations based on the required refresh process.
- Use Refresh Token once - Check this box if the refresh of the access token will also generate a new refresh token
If the refresh process will refresh the refresh token and this has not been selected, the Flex Connector will not save the new refresh token and will fail in the successive collections
- Refresh Token URL - Enter the refresh token URL
- Headers - Enter the API call's headers in a JSON format. For example:
{"type": "123..."}
- Additional POST data - By default, the request body contains client_id, client_secret, refresh_token and grant_type values. Enter any additional or replacement POST data in a JSON format. For example:
{"Client_id": "123..."}
- Access Token response key - Enter the field path to the access token in the response.
- Refresh Token response key - This configuration is available only when Use refresh token once is selected. Enter the field path to the refresh token in the response.
- Error status codes - Enter a ; list of the error codes that will trigger the refresh of the access token. The Flex Connector will only attempt to refresh the access token when encountering these error codes
- Headers - Enter the API call's headers in a JSON format. For example:
AWS Signature
- Region - Choose the AWS region to send the API calls to.
- Service Name - Enter the service name receiving the API calls. For example:
s3
- Access Key - Enter your AWS Access Key.
- Secret Key - Enter your AWS Secret Key.
- Add to - Choose between adding the AWS authorization to the headers or URL parameters.
- Session token - Enter the session token when using temporary credentials