Docebo APIs use the OAuth 2.0 framework in most third-party scenarios, including authentication and authorization for web servers, installed and client-side applications. OAuth 2.0 app credentials can be obtained on the Docebo API and SSO App settings page.
Your client application will request an access token from the LMS, extract a token from the response and send it to each REST API that you’d like to access.
Activating & Setting Up the Docebo API & SSO App
You’ll first need to activate and set up the API & SSO app in your Docebo platform. Follow the steps outlined in this Knowledge Base article to properly configure the app and obtain your OAuth 2.0 credentials.
Obtaining an Access Token
Before your application can access private LMS data with a Docebo API, it must obtain an access token that grants access to that REST resource. A single access token can access multiple APIs. The “scope” parameter controls the set of resources and operations that an access token permits.
To obtain an access token, you will need to make a call to this endpoint. Please note that the behavior of the following API calls will depend on the user level used to get the access token, based on the permissions defined in the platform.
For information related to the Oauth2 token and the parameters to include in the below requests, refer to Oauth2 official documentation.
Using the Resource Owner Password Credentials Grant Type
Here is a sample call with the grant type set to Resource Owner Password Credentials:
curl -X POST
Using the Client Credentials Grant Type
Here is a sample call with the grant type set to Client Credentials:
curl -X POST
Please Note: With the new 7.0 APIs (found at YOURLMS.docebosaas.com/api-browser/), the system requires a specific user permission in order to work properly. Because of this, you will not be able to use client credentials to call this type of API.
Using the Authorization Code + Implicit Grant Grant Type
If your application uses the Authorization Code grant, then you should use the following URL to start the authorization flow:
Using the JWT Bearer Grant Type
JSON Web Tokens are an open, industry-standard RFC 7519 method for representing claims securely between two parties. You can use JWT technology to get an access token to access Docebo APIs.
You can generate a JWT token with the method you prefer. Some samples, as well as libraries for many programming languages, are available on the jwt.io site.
To create a JSON WEB Token that can be used to authenticate within Docebo, you must set the signature algorithm to RS256 and upload your Public Key to the API and SSO app in your platform after selecting the JTW Bearer grant type. Here is an example of a public key:
-----BEGIN PUBLIC KEY-----
-----END PUBLIC KEY-----
To allow the LMS to authenticate the user, the following information is necessary:
- iss: (Issuer) Claim. This should contain the Client ID configured inside the LMS for SSO.
- sub: (Subject) Claim. This should contain the username you want to use to log into the LMS.
- aud: (Audience) Claim. This should contain the LMS hostname (without protocol) in which you want to authenticate.
- iat: (Issued At) Claim. This should contain the token creation date in Unix timestamp format.
- exp: (Expiration Time) Claim. This should contain the expiry date in Unix timestamp format.
The token payload, therefore, will look like this:
Once you sign the token with your private key, you’ll get an encoded JWT token ready to be sent for authentication. An encoded JWT token is similar to this one:
You can then send the data to the authentication endpoint. Here’s a sample call with the grant type set to JWT Bearer:
curl -X POST
Sending the Access Token to an API
After obtaining an access token, your application needs to provide the token to every Docebo API call in the HTTP Authorization header in the format:
curl -X GET
-H 'Authorization: Bearer 2af6ac532cfef197b00f69639aeeef86621d1975'
Refreshing the Access Token
Because tokens have a limited lifespan of 14 days, your application can obtain a fresh token using the Token Endpoint if it needs to access a Docebo API beyond the life of a single access token. A refresh token allows your application to obtain new access tokens.
Please make sure you follow the guidelines outlined in the OAuth2 official documentation with regards to using and safely storing a refresh token.
Sending the Access token For Single Sign-on
After obtaining an access token, your application needs to insert the token in a specific URL format to allow for SSO. Here is the format:
Please Note: If you are using a custom domain, you should replace "YOURLMS.docebosaas.com" with your custom domain URL.