Ivanti CMDB

Ivanti CMDB (Configuration Management Database) is a central repository that stores detailed information about an organization's IT assets such as hardware, software, networks, and their interrelationships. It plays a key role in enabling efficient IT management and service delivery and is an integral component of the Ivanti ITSM platform.

For detailed information, please refer to Ivanti’s official website.

Integration Method: API

Tables: Device Inventory Info (5001)

This integration supports the following type of events.

Note:

Ivanti ITSM does not offer a built-in versioning system. As of this document preparation, the latest release was in Q1, 2025.

Prerequisites

• The user should have access to the Ivanti ITSM portal.

• The user should have access to the DataBee console.

Configuration Overview

1. Create an API Credentials with required permissions to fetch the data.

   1. Create Role

   2. Create User

   3. Create API Key

2. Create Ivanti CMDB Data Feed in the DataBee console with the required API credentials.

   DataBee Parameter	Ivanti Parameter
   API Base URL(<instance>)	Base URL
   Access Key	Reference ID

Ivanti Configuration

1. Log in to Ivanti ITSM portal as an administrator.

2. Copy the base URL as shown below for later use.
    

Before creating the API credentials, you need to create the user and role that has the necessary permissions to access the API.

Create Role

1. From the sidebar, select Settings.
    

2. From the SETTINGS window, navigate to Users and Permissions > Roles and Permissions.
    

3. From the Roles and Permissions section, select ADD NEW.
    

4. On the “Role Details” section, enter the ‘Role’ and ‘Display Name’ of the role that you want to create, then click on Top Level Tabs.
    

5. On the Top Level Tabs section, click on ADD NEW TAB.
    

6. Select the Analytics Metrics.
    

7. Click on ADD THIS TAB, then select Object Permissions.
    

8. From the “Object Permissions” section, ensure that only the View permission for APITrustedHost is selected (deselect any other preselected permissions if necessary), then click on Permissions to grant roles.
    

9. From Permissions to Grant Roles section, check ivnt_AssetManager, then click Save.
    

Create User

1. From the SETTINGS window, navigate to Users and Permissions > Users.
    

2. From the Users section, select New Employee to Create a User.
    

3. Enter the details of the user and then click on ROLES.
    

4. Click on Link to assign a role to a user.
    

5. Select the role that we created earlier, then click on Select.
    

6. Click on SAVE to create the user.
    

Create API Key

1. From the SETTINGS window, navigate to Security Controls > API Keys.
    

2. From API Keys, select Add Key Group.
    

3. Enter the API Group ‘Name’ and ‘Description’, then select Save Key Group.
    

4. From the sidebar, select API Keys then select the Key Group that we created earlier.
    

5. From the “API Keys” section, select Add API Key to create an API Key.
    

6. From the New API Key window:

   1. Copy the Reference ID for later use, then select On Behalf Of.
       

   2. To select the On Behalf Of, search for the DisplayName matching the user that we created earlier, then click Select.
       

   3. For In Role, select the role that we created earlier, then click Save Key.
       

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
    

2. Search for the Ivanti CMDB and click it as shown below.
    

3. Click on the API Ingest option for collection method.
    

4. Enter feed contact information and click Next.
    

5. In the configuration page, confirm the following:

   • API Base URL: this is the base URL that DataBee will interact with. Replace the instance with base URL.

   • Authorization Method: Custom API Key

   • Access Key: paste the Reference ID generated earlier.

   • Event Types: preselected for all the event types that integration pulls.
      

6. Click Submit.

Troubleshooting Tips

• If you are facing an unauthorized error, it might be due to incorrect credentials or a missing role. Reconfigure the Reference ID by the above mentioned steps and ensure that it is pasted correctly.