- Print
- DarkLight
- PDF
To access Cenosco’s APIs, you are required to authenticate your user credentials using Cenosco's CenAuth identity service.
Take Note
For the examples below, we rely on Postman, a free application used to build, test and use web APIs. Before continuing, download Postman from the following location: https://www.postman.com.
To obtain your username and password, contact Cenosco Customer support.
Configuring Postman to Obtain a Token
To obtain a token from the CenAuth service:
Run the Postman application.
Create a New Collection by clicking the Plus button on the left hand panel.
Select your New Collection.
Select the Authorization tab.
Under Type, select "OAuth 2.0".
Scroll down to the section titled Configure New Token.
Click Edit token configuration.
Configuring Credentials
To continue configuring the authentication necessary to access the Data Lake (or other API service), complete the following fields as shown in the table below:
Field | Content |
---|---|
Token Name | Enter a descriptive name for your token. |
Access Token URL | |
Client ID | Your username. |
Client Secret | Your password. |
Client Authentication | Send Client Credentials in body. |
Requesting Tokens from CenAuth Service
To obtain the token for use in submitting requests:
Click Get New Access Token.
A notification box will pop up, showing that you have successfully authenticated with the CenAuth service.
A token will be returned by CenAuth service and the token will be shown in another popup after a few seconds.
Click Use Token to continue using Postman, or select and copy the Access Token for use in another application.
Take Note
Authentication tokens expire after one hour. To refresh your token click Get New Access Token.
You are now ready to start submitting data requests to IMS’s API services.