Authentication

Authentication for Setten projects

Each of your projects has its endpoint and key for authentication. This design gives the user a granular approach to security. If necessary, it is effortless to remove or cycle a project key without affecting other projects.

If you are searching for a way to authenticate in a client that only accepts an URL, like Terrain for example, please see Basic auth

Authentication process

When receiving requests, we will always verify their authenticity via these simple steps:

1. Get the project_id from the first segment of the URL's path

2. Retrieve the key from the locations described in Project key locations

3. If key is the key registered for the project with id project_id the request is proxied

Project key locations

Those are the locations we'll check for your project key in order. Only the first matched key will be used for authentication.

1. Header

Using the standard Authorization: Bearer header

curl

PROJECT="37677fb03e7d426e8ecfd56f36655577"
KEY="4e4a6106c6354339a263d23090559804"

curl https://lcd.pisco.terra.setten.io/${PROJECT}/node_info \
     -H "Authorization: Bearer ${KEY}"

python 3

import requests

project_id = "37677fb03e7d426e8ecfd56f36655577"
headers = {"Authorization": "Bearer 4e4a6106c6354339a263d23090559804"}

requests.get(f"https://lcd.pisco.terra.setten.io/{project_id}/node_info", headers=headers )

javascript

const projectId = "37677fb03e7d426e8ecfd56f36655577"
const headers = {"Authorization": "Bearer 4e4a6106c6354339a263d23090559804"}

fetch(`https://lcd.pisco.terra.setten.io/${projectId}/node_info`, { headers })

2. Query string

A query string named key.

curl

PROJECT="37677fb03e7d426e8ecfd56f36655577"
KEY="4e4a6106c6354339a263d23090559804"

curl https://lcd.pisco.terra.setten.io/${PROJECT}/node_info?key=${KEY}

python 3

import requests

project_id = "37677fb03e7d426e8ecfd56f36655577"
key = "4e4a6106c6354339a263d23090559804"

requests.get(f"https://bombay.lcd.setten.io/{project_id}/node_info?key={key}")

javascript

const projectId = "37677fb03e7d426e8ecfd56f36655577"
const key = "4e4a6106c6354339a263d23090559804"

fetch(`https://lcd.pisco.terra.setten.io/${projectId}/node_info?key=${key}`)