Skip to main content

Authorization

Follow this guide to create a new GlassFrog API credential that will allow Nexla to authenticate to and exchange data with your GlassFrog organization.
glassfrog_api_auth.png

GlassFrog API

Prerequisites​

To connect Nexla to GlassFrog, you need a GlassFrog account and an API key. GlassFrog API keys are associated with individual user accounts and carry the same permissions as that user. The GlassFrog API (v3) uses JSON and requires an API key for all requests.

Obtain a GlassFrog API Key​

GlassFrog allows you to create multiple API keys—one per integration—so that individual keys can be revoked without disrupting other connections.

  1. Sign in to your GlassFrog account at app.glassfrog.com.

  2. Click your name or avatar in the top-right corner of the application to open the account dropdown menu.

  3. Select Profile & Settings from the dropdown.

  4. Navigate to the API tab within your profile settings.

  5. Enter a descriptive label for the new API key in the label field (for example, Nexla Integration) to help identify its purpose later.

  6. Click the button to generate the new API key.

  7. Copy the API key immediately and store it in a secure location. The full key value is displayed only at the time of creation.

Important

GlassFrog API keys provide access to your organization's governance data with the same permissions as your user account. Treat API keys like passwords—do not share them in publicly accessible locations or commit them to version control. If a key is compromised, navigate back to Profile & Settings > API and delete the affected key, then create a replacement.

For additional information about GlassFrog API keys, refer to the official GlassFrog support documentation at support.glassfrog.com/glassfrog-api-keys.

Create a GlassFrog API Credential​

  • To create a new GlassFrog API credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Authentication​

GlassFrog API v3 authenticates requests using an API key, which can be supplied either as a URL query parameter (?api_key=YOUR_KEY) or as the value of the X-Auth-Token request header. Nexla uses the header-based method, which keeps the key out of logged URLs.

  1. Enter the GlassFrog API key you generated in the API Key field. This key authenticates Nexla with the GlassFrog API and must remain confidential.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.