Axonius Documentation

    Ivanti Neurons for ITSM

    Ivanti Neurons for ITSM is a service management platform with CMDB capabilities for asset lifecycle and configuration management.

    Use Cases the Adapter Solves

    • Comprehensive Asset Visibility: Gain complete visibility into configuration items (CIs) and employee data managed in Ivanti Neurons for ITSM to identify unmanaged or misconfigured assets.
    • CMDB Data Enrichment: Correlate ITSM asset data with other sources to verify configuration accuracy, track asset ownership, and improve asset lifecycle management.
    • Compliance and Governance: Monitor device compliance status, encryption status, and patch levels to ensure adherence to security policies and regulatory requirements.

    Asset Types Fetched

    • Devices
    • Users

    Data Retrieved through the Adapter

    Devices

    • Hostname, Device Name, Serial Number
    • Operating System, Make, Model
    • Compliance Status, Encryption Status, Patch Status
    • Assigned To Name, Owner Name

    Users

    • Display Name, Email Address
    • Department, Job Title
    • Location

    Before You Begin

    Required Ports


    • TCP port 443 (HTTPS)

    Authentication Methods

    REST API Key Authentication

    The adapter authenticates using a REST API key via the Authorization header. The API key is created in the Ivanti Neurons for ITSM Configuration Console and passed as rest_api_key={api_key}.

    APIs

    Axonius uses the Ivanti Neurons for ITSM OData API. The following endpoints are called:

    • GET /api/odata/businessobject/ConfigurationItems - Retrieves configuration items (devices) with expanded AssignedTo and Owner information
    • GET /api/odata/businessobject/Employees - Retrieves employee information (users)

    Required Permissions

    The account used for the adapter must have administrative permissions to access the API endpoints.

    Note: The exact permission names should be confirmed with your Ivanti Neurons for ITSM administrator or Ivanti support, as the API documentation is not publicly available.

    Supported From Version

    Supported from Axonius version [x.x.x]

    Setting Up Ivanti Neurons for ITSM to Work with Axonius


    To configure Ivanti Neurons for ITSM for integration with Axonius:

    1. Log in to the Ivanti Neurons for ITSM Configuration Console as an administrator.
    2. Navigate to Security Controls > API Keys.
    3. Create a new REST API Key with appropriate permissions to access Configuration Items and Employees.
    4. Copy the Reference ID of the API key for use in Axonius.
    5. Ensure the API key has read access to the OData API endpoints for business objects.

    Connecting the Adapter in Axonius

    Navigate to the Adapters page, search for Ivanti Neurons for ITSM, and click on the adapter tile.

    Click Add Connection.

    To connect the adapter in Axonius, provide the following parameters:

    Required Parameters

    1. Host Name or IP Address - Base URL for the Ivanti Neurons for ITSM tenant. Must include the protocol prefix (https://). Example: https://yourtenant.ivanti.com
    2. REST API Key - REST API Key created via Configuration Console > Security Controls > API Keys. This is the Reference ID of the API key.
    3. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

    Optional Parameters

    1. HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
    2. HTTPS Proxy User Name - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.
    3. HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.

    To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.



    Updated 1 day ago