---
title: "CenAuth IMS Authentication"
slug: "cenauth-authentication"
tags: ["Data Lake"]
updated: 2026-10-27T23:11:38Z
published: 2026-10-27T23:11:38Z
canonical: "ims-handbook.cenosco.com/cenauth-authentication"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://ims-handbook.cenosco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CenAuth IMS Authentication

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](https://www.postman.com).

To obtain your username and password, contact [Cenosco Customer support](https://cenosco.com/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".

![image.png](https://cdn.document360.io/e492a0e0-a4ba-4aca-8fc6-76b95f91fdf3/Images/Documentation/image%28103%29.png?sv=2026-02-06&spr=https&st=2026-10-28T16%3A03%3A11Z&se=2026-10-28T17%3A03%3A11Z&sr=c&sp=r&sig=wZ9cdtMgtqmGY51Tkd0BsXd4kcuaHTrFParJCUbbXvY%3D)Authorization settings in Postman.

- Scroll down to the section titled Configure New Token.
- Click **Edit token configuration**.

![image.png](https://cdn.document360.io/e492a0e0-a4ba-4aca-8fc6-76b95f91fdf3/Images/Documentation/image%28104%29.png?sv=2026-02-06&spr=https&st=2026-10-28T16%3A03%3A11Z&se=2026-10-28T17%3A03%3A11Z&sr=c&sp=r&sig=wZ9cdtMgtqmGY51Tkd0BsXd4kcuaHTrFParJCUbbXvY%3D)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 | [](https://ims-auth.shell.com/connect/token) A URL to the CenAuth service will be provided by Cenosco Customer Support. |
| 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**.

![](https://cdn.document360.io/e492a0e0-a4ba-4aca-8fc6-76b95f91fdf3/Images/Documentation/image-VYVJCW8E.png?sv=2026-02-06&spr=https&st=2026-10-28T16%3A03%3A11Z&se=2026-10-28T17%3A03%3A11Z&sr=c&sp=r&sig=wZ9cdtMgtqmGY51Tkd0BsXd4kcuaHTrFParJCUbbXvY%3D)Click **Get New Access Token**

- A notification box will pop up, showing that you have successfully authenticated with the CenAuth service.

![image.png](https://cdn.document360.io/e492a0e0-a4ba-4aca-8fc6-76b95f91fdf3/Images/Documentation/image%28106%29.png?sv=2026-02-06&spr=https&st=2026-10-28T16%3A03%3A11Z&se=2026-10-28T17%3A03%3A11Z&sr=c&sp=r&sig=wZ9cdtMgtqmGY51Tkd0BsXd4kcuaHTrFParJCUbbXvY%3D)Notification box. 

- 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.

![image.png](https://cdn.document360.io/e492a0e0-a4ba-4aca-8fc6-76b95f91fdf3/Images/Documentation/image%28107%29.png?sv=2026-02-06&spr=https&st=2026-10-28T16%3A03%3A11Z&se=2026-10-28T17%3A03%3A11Z&sr=c&sp=r&sig=wZ9cdtMgtqmGY51Tkd0BsXd4kcuaHTrFParJCUbbXvY%3D)Click Use Token.

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](/v414/docs/submitting-data-requests-1) to IMS’s API services.