Authentication

Development vs Production

We handle development and production environments at the credential level. We will issue you with a set of dashboard and API credentials you can use for development purposes during your trial / onboarding phase.

When you’re ready to move to production, please contact us, and we will issue you a set of production credentials.

Dashboard

Upon onboarding, you will receive a set of dashboard credentials consisting of a username (usually your email) and password to your email address. You can use these to log into dashboard.herondata.io.

If you haven't received access, please speak to your Heron rep, or email us at [email protected].

To reset your password, go to the Forgot your password page. You will receive an email with instructions.

API

Once you have used your dashboard credentials to log in, you will be able to see your API credentials (api_key) in the dashboard under Settings.

We use Basic access authentication. Instead of the typical <username>:<password>, keep the username blank and use the api_key as the password. This means you should send the base64-encoded version of :<api_key> in the Authorization: Basic header.

Most modern HTTP libraries handle the encoding for you, but here's a step-by-step example for clarity:

1. Encode your api_key to get your token and leave the username spot blank:

   echo -n ":<api_key>" | openssl base64

2. Add the output of the above command in the Authorization header:

   curl "https://app.herondata.io/api/hello_world/authenticated" \
   --header 'Authorization: Basic <base-64-encoded-token>'