API Token Management

The API Token Management page allows you to view, create, edit, and manage API tokens.

For user accounts of type Admin, the API Token Management page displays:

• Action tokens. Tokens for API calls to the Lucidum Data Group.
• User Generated tokens. Tokens for all other Lucidum API endpoints.
• Limited tokens. Created by Admin accounts. Tokens with an expiration date and granular access to APIs.

NOTE: Token Management is a living feature in Lucidum. Future releases will include additional functionality.

To view the list of API Tokens:

1. Navigate to Settings > API Token Management.
2. The API Token Management page appears:

   

3. The API Token Management page displays the following about each API token:
   • Tag. For Action Tokens, this is the name you specified when you created the token. User Generated tokens do not include a tag.
   • Type. Type of token. Options are:
     • Action. Action tokens provide access to data in the Lucidum Data Group ( /CMDB/v2/data/ldg endpoint). The Lucidum Data Group provides a more focused set of results for each asset or user. For details on generating an Action Token, see Generating a Bearer Token for /CMDB/v2/data/ldg.
     • User Generated. User Generated tokens provide access to all other endpoints in the Lucidum API. For details on generating a user generated token, see Generating a Bearer Token for All Other Endpoints.
     • Limited. Admin-created token that includes a tag, an expiration date, and access to a limited set of Lucidum APIs.
   • Created By. Lucidum user who created the API token.
   • Created On. Date and time the API token was created.
   • Last Modified By. Lucidum user who last modified the API token.
   • Last Modified On. Date and time the API token was last modified.
   • Expires On. Date and time the API token expires.
4. If you have an Admin user account, you can edit only Limited tokens.
5. To delete a token, find the token you want to delete and then click the Delete icon (trashcan).

   NOTE: You can delete only tokens you have created.

Creating a Limited Token #

To create a Limited Token:
NOTE: Only user account of type Admin can create Limited tokens.

1. Navigate to Settings > API Token Management.
2. In the API Token Management page, click the Add Limited Token icon (plus-sign in upper right).
3. In the Add Limited Token modal page, enter the following:

   

   • Tag. Title for the limited token.
   • Expire Date. Date on which the token expires.
   • Allowed APIs. Select one or more APIs that can be accessed with this token.
4. Click Add.
5. The Token field appears, populate with the Limited Token. Copy the token and store if safely. It will not appear again.
6. The new Limited token appears in the API Token Management page.
7. To use the token, supply it as a bearer token in the API header.