Setting up connectors

Ivanti Neurons connectors enable you to import data about your organization, such as device or user data, into the Ivanti Neurons Platform. A connector keeps the details of which data to gather, where to gather it from, and when and how frequently to import that information into Neurons.

There are two types of available connectors: cloud and on-premises. Cloud connectors import data from cloud-hosted services such as Microsoft Azure or AWS. On-premises connectors import data from specific, on-premises source applications such as Ivanti Endpoint Manager, or they are generic, such as the CSV connector. On-premises connectors require that you also set up a local connector server by installing a provided utility.

You can have as many connector servers and connectors as you need to gather data when and how you want. Each connector server can have multiple connectors, even of the same type or accessing the same source application. You can set up both cloud and on-premises connectors if your work environment supports both.

User roles other than the administrator may need to view and set up connectors. To do so, those roles will need to be assigned Connectors permissions. For details, see Access Control.

About connector servers

On-premises connectors require that you install a connector server utility on a local Windows server that has access to your data source. This utility is a preconfigured Ivanti Neurons agent that can relay data to Neurons from the source application (for example, Endpoint Manager).

It is important to understand the distinction between the connector server utility that is installed on a local server and the connector that is set up in the Ivanti Neurons console. The connector server utility performs functions locally and then connects to Neurons using information configured in the connector.

The connector server uses HTTPS (port 443) to communicate. For more information about URLs and IP addresses, see this article in the Community: Ivanti Neurons URL and IP White List.

The following minimum requirements are required for a connector server:

Getting started

To get started connecting to an on-premises source application, you first need to populate Neurons with a local connector server. By default, new users will find that the Connectors > Connector Servers page displays just a Cloud option until an on-premises connector server is added.

Use the Connector Servers page to set up a connector for a cloud-based service.

A local connector server is not required for cloud connectors that import data from cloud-hosted services—you can immediately add one or more of those connectors to the Cloud option on the Connector Servers page. To set up a cloud connector, see the Ongoing tasks section below.

  1. Log into your Ivanti Neurons account as Administrator.

  2. In the left navigation pane, click Admin > Connectors.

    Open the Connectors page by clicking Admin > Connectors in the left navigation pane.

  3. Click the Create new connector button.

    Create a first connector server by clicking the Create new connector button.

  4. On the Available Connectors page, click the Download connector utility button to download the connector server utility.

    Download the connector server utility, which is required to set up an on-premises connector.

    The prompt to download the utility appears. Click Download.

    Click the Download button to download and install the connector server utility.

  5. On a server in your environment that has access to the source application, run the executable that you downloaded. This will install the connector server. For information on firewall requirements, see this article in the Community: Ivanti Neurons URL and IP White List.

  6. Return to your Neurons web session. It may take a few minutes for the connector server to appear on the Connector Servers page. Once it does, you can add connectors to start gathering data from specific sources at specific times. See the next section for setting up a connector.

After setting up a first connector server, you can add an on-premises connector to it.

Ongoing tasks

Connector servers are only required for on-premises source applications, not cloud-hosted services.

  1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connector Servers.
  2. Click the Add Server button to download the connector server utility.

  3. The prompt to download the utility appears. Click Download.

    prompt to download utility

  4. On a server in your environment, run the executable that you downloaded. This will install the connector server. You'll want to set up the connector server on a device that has access to the data source. For information on firewall requirements, see the article in the Community: Ivanti Neurons URL and IP White List.
  5. Return to your Neurons web session. It may take a few minutes for the connector server to appear on the Connectors page. Once it does, you can add connectors to start gathering data.
  1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connector Servers.
  2. Find the connector server in the list that you want to add a connector to, and click Add Connector. Use the Cloud option to add a cloud connector for a cloud-hosted service.
  3. From the available connectors list, select the type of connector to create. Important: The Jamf Pro connector requires that you enable an option in Jamf Pro before setting it up in Neurons. For details, see Jamf Pro connector. Likewise, some Microsoft cloud connectors require that you create an app in Entra ID before use. For details, see Creating API apps in Entra ID for Microsoft cloud connectors.
  4. Configure the options for the connector. For details about individual connectors, see the full list at the bottom of this topic.

  5. To run the connector immediately, click Save and Run at the top right of the page.

    -Or-

    To save the connector and not have it run until its scheduled time, select the Active check box and click Save.

  6. To monitor the progress of your connectors, set the toggle at the top of the page to Connectors. The list of connectors shows the current status, number of records processed and the number of records that failed to import, as well as last run, next run, and scan duration. The import can take hours if there's a lot of data.

You can also view imported records on the Devices page. For details, see Devices.

  1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
  2. Find the connector that you want to change and click the Click this icon to access more options. icon in the column to the far right.
  3. Select Run now. The connector syncs all current data.
  1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
  2. Find the connector that you want to change and click the Click this icon to access more options. icon in the column to the far right.
  3. Select Disable or Delete. If deleting, you can also select Wipe Data, which will delete all of the data that was imported by the connector. If you don't select this option, the data will be kept in Ivanti Neurons even after you delete the connector.

If you disable a connector, you can re-enable it by going to the same menu and selecting Enable.

You can delete the data that was imported by a connector into Ivanti Neurons. This action will wipe any data that was imported by a given connector, but will leave all other data that was discovered, inventoried, or imported by other connectors you have set up. If the only data for a particular record was imported by the given connector, then the entire record will be deleted.

You can also wipe imported data when deleting a connector or uninstalling a connector server.

  1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.

  2. Find the connector that you want to wipe data from and click the Click this icon to access more options. icon in the column to the far right.

  3. Select Wipe Data.

  1. Click Admin > Connectors and make sure the toggle at the top of the page is set to Connector servers.
  2. Find the connector server that you want to uninstall and click the delete icon icon at the top right corner.

  3. To wipe all data imported by the listed connectors, select Wipe Data. If you don't select this option, the data retrieved by the connectors will be kept in Ivanti Neurons even after you uninstall the connector server and associated connectors.

  4. Click Delete or Delete all if connectors are associated with it. The data retrieved by the connectors will be kept in Ivanti Neurons.

For an overview of attributes that are imported by connectors, and how attributes are mapped to Target Attributes, see Connector data mapping.

For information about the available connectors, see the following pages: