Skip to content

API Authentication

Authentication Flow

Aleph API implements the OAuth 2.0 standard for authentication, specifically using the Client Credentials flow. This ensures secure access to our API endpoints while maintaining industry-standard security practices.

The authentication process consists of 4 main steps:

1

Login to Aleph

2

Create Credentials

3

Get Access Token

4

Get Contract ID

Make API Request

Access Aleph Graphical User Interface

Access to the Aleph API is exclusively available to registered users of the Aleph platform. To use our API services:

  • Existing Users: If you already have an Aleph account, you can proceed to create API credentials through your account profile.
  • New Users: If you don't have access to Aleph yet, please contact our sales team at sales@satellogic.com to discuss your needs and set up your account.

Key Concepts

Understanding these concepts will help you navigate authentication with Aleph:

Contracts

In Aleph, a Contract is the legal framework that defines the conditions under which a user, with access to that contract, can interact with our available products—such as Archive Imagery or Tasking.

Here's what you need to know:

  • Contracts define the specific products and services your organization can access
  • Each API credential is associated with a specific contract
  • Contracts determine:
  • Which products you can order (e.g., imagery products)
  • The level of access to our archives
  • Your tasking capabilities
  • Delivery options available to you

Roles

Different roles in Aleph grant access to different features and capabilities.

Imagery User role

To create an API credential, your user account must have this role, which also allows you to access and interact with Aleph's geospatial data through the API and the GUI.

API Credentials to use geospatial data has a different role called M2M Imagery Intergrator.

M2M Imagery Integrator

  • The most common role for API access
  • This is the most common role for API access, to be granted to systems and applicatons which need to automatically interact with our APIs.

At this stage, you should not worry about which role you need for your API usage, our customer Success Team will give you the right role for your profile. Please get in touch with them at tasking@satellogic.com to get the access you need.