Introduction
Authentication is a mandatory process of verifying your identity as an UP42 user. Access to UP42 services is allowed or denied based on the identity of the requester. The UP42 API uses bearer authentication.
The UP42 platform relies on the following structure: Project > Workflow > Block > Job. Once the user creates a project, the access token will be generated as a cryptic string based on the project's credentials: the project ID and project API key. The access token is thus called a project token.
Each API call is made at project level. If you wish to switch the project, you need to generate a new project token with the credentials from the project of your choice.
Requirements
For the API calls, we recommend using several third party tools (see table below).
Tool | Description |
---|---|
cURL | command-line HTTP client for getting or sending data using URL syntax. |
jq | lightweight command-line tool for processing the JSON syntax. |
jwt-cli | command-line tool for decoding the project token. This token is based on JSON Web Tokens and uses a Hashed Message Authentication Code (HMAC) based on SHA-512. |
Get Project Credentials
To generate the project ID and project API key, please follow the steps below:
- If you do not have an UP42 account, register here.
- After registering, create a project on the console and locate the project credentials here.
- Create two project variables. In this example, we used the variables
PROJ
(project ID) andPKEY
(project API key).
Get Bearer Token
After the project variables have been created, get the bearer token (also known as project token):
PTOKEN=$(curl -sX POST "https://$PROJ:$PKEY@api.up42.com/oauth/token" \
-H 'Content-Type: application/x-www-form-urlencoded' -d \
'grant_type=client_credentials' | jq -r '.data.accessToken')
Please note that the token is valid for 5 minutes. To get a new token, recall the command by typing !PTOKEN
.
Now that you have access to the UP42 services, you can proceed with one of the following guides: