📘

This page describes how to generate keys required to authenticate your access to resources on Eratos.

• Eratos Keys are used for interacting with datasets and models.
• Senaps Keys are used for interacting with the Senaps backend.

Generate your keys

Good security practices are always important when working with data and are something we take seriously at Eratos. We employ the use of development keys which are unique identifiers used to authenticate you before our system provides you with access to our APIs. Anyone who interacts with data through Eratos is authenticated at each step to ensure that everyone on Eratos is who they say they are.

There are 2 types of keys used to authenticate you in eratos: Eratos Keys (for interacting with datasets and models) and Senaps Keys (for interacting with the Senaps backend).

Generate an Eratos Development Key

Once you are signed in, select "Development" from the menu on the left-hand side:

Then click on "Create new key" and provide a key name to help you identify.

You will see a Key ID and Key secret.

Save both in a safe place, such as eratos/eratos_keys, by clicking Download .json file

Please ensure you follow Eratos Development Key Recommended Practice for easy authentication.

🚧

Once you navigate away from the page the secret will not be retrievable

Create and Save Developer API Key

• Step 1: Login to Senaps
• Step 2: Click My Account on the left-hand Menu

• Step 3: Click Add New Key

• Step 4: Save Key to Json File

{
    "senaps_key": "Paste your key here!"
}

Congratulations you have setup your Senaps environment so you are now ready to create pull data and create models in Senaps.

Activate Senaps Credentials in Python Environment

The below script reads the Senaps credentials created above and uses them to authenticate and activate the Senaps sensor client in your python environment. You will need to install the Senaps SDK first.

import json
from senaps_sensor.api import API
from senaps_sensor.auth import HTTPKeyAuth

creds_path = "Path to Senaps Creds"

# Opening JSON file
f = open(creds_path)
  
# returns JSON object as 
# a dictionary
creds = json.load(f)

senaps_client = API(HTTPKeyAuth(creds['senaps_key']), host="senaps.eratos.com")