Authentication in API v2

This chapter describes how to authenticate with the Lucidum API v2. The steps are:

• Generate a bearer token

• Include the bearer token in the header of each API request

Generating a Bearer Token

To authenticate with the Lucidum API v2, use a bearer token. The bearer token allows a Lucidum account to access the Lucidum API. You can generate the bearer token from the Lucidum UI.

Lucidum does not support SSO access for the Lucidum API.

To generate the Token:

1. Go to Settings > User Management.

2. Find your account. Click its Edit link.

3. Ensure that your account is assigned the Role Api_Users.

   

    

4. In the Edit User page, in the Roles field, click API_Users and click the right arrow button.

5. In the Edit User page, click the button Generate ClientID/Secret.

6. Double-click on the Client ID field to copy the value. Save it somewhere safe.

7. Double-click on the Secret field to copy the value. Save it somewhere safe.

8. Click the button Generate Token.

9. Double-click on the Token field to copy the value. Save it somewhere safe. Lucidum will not display this value again.

10. Click the Confirm button.

Authentication in the Header

To authenticate with the Lucidum API v2, include the bearer token in the header of each API request.

In Python, the header looks like this:

headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer quoVnYQeDNicAOywkOKq'
}

In cURL the header looks like this:

--header 'Content-Type: application/json' \
--header 'Authorization: Bearer quoVnYQeDNicAOywkOKq'

where:

• quoVnYQeDNicAOywkOKq is the bearer Token we generated in the Edit User page.

• Content-Type is JSON.