Authentication

Documentation for externally authenticating to Loupe

Obtaining an Access Token

Loupe uses OAuth2/OpenID Connect to authenticate users. Below is how to obtain an access token for external integrations.

POST - https://id.atelier.technology/connect/token

Parameters

  • grant_type (string, required): Use "password" for this authentication method.
  • resource (string, required): Use "api://enterprise" to access the production environment of Loupe.
  • username (string, required): Use the email address of the user account you want to authenticate.
  • password (string, required): Use the password of the user account you want to authenticate.

Obtaining a Refresh Token

To obtain a refresh token include the scope parameter in your call. All other parameters should be the same as when obtaining an access token.

POST - https://id.atelier.technology/connect/token

Parameters

  • grant_type (string, required): Enter "password" for this authentication method.
  • resource (string, required): Enter "api://enterprise" to access the production environment of Loupe.
  • username (string, required): Enter the email address of the user account you want to authenticate.
  • password (string, required): Enter the password of the user account you want to authenticate.
  • scope (string, required): Enter "offline_access" to obtain a refresh token.

Obtaining an Access Token Using a Refresh Token

Perform the following query to obtain an access token using a refresh token.

POST - https://id.atelier.technology/connect/token

Parameters

  • grant_type (string, required): Enter "refresh_token" for this authentication method.
  • resource (string, required): Enter "api://enterprise" to access the production environment of Loupe.
  • refresh_token (string, required): Enter the refresh token you previously obtained.

 

Note: Loupe uses bearer tokens, so be sure to include "bearer" when authenticating. For example, authorization = "bearer <access_token>"