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 connectors you can choose from for most of the data sources that Neurons supports: those that run in the cloud and those that use an on-premises connector server. For other data sources, just one of these connector types will be available.

Cloud connectors import data from cloud-hosted services such as Microsoft Azure or AWS; you add them to the Neurons cloud connector server. On-premises connectors import data from local, 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 the Ivanti Neurons Agent with an Agent Policy that has the Connector Server capability enabled.

You can have as many connectors and local connector servers 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.

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 on-premises connector servers

On-premises connectors require that you install the Ivanti Neurons Agent with an Agent Policy that has the Connector Server capability enabled, on a local Windows server that has access to your data source. This enables data to be relayed to Neurons from the source application (for example, Endpoint Manager).

An on-premises connector server uses HTTPS (port 443) to communicate. Learn more about Required URLs, IP addresses and ports.

The following minimum requirements are required for an on-premises connector server:

An on-premises connector server is not required for cloud connectors.

Getting started

To get started connecting to an on-premises source application, you first need to populate Neurons with an on-premises connector server.

By default, new users will find that the Connectors > Connector Servers page displays just a Cloud connector server option until an on-premises connector server is added. A local connector server is not required for cloud connectors—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 Neurons Agent button to download the Ivanti Neurons Agent with the Infrastructure Agents policy, which has the Connector Server capability enabled by default. Alternatively, create an Agent Policy with the Connector Server capability and install using that. For more details refer to Agent Policies.
    The download dialog appears. Click Download.

  5. On a server in your environment that has access to the source application, run the executable that you downloaded. This will install the agent with the policy. For information on firewall requirements, refer to Required URLs, IP addresses and ports.

  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

  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.

    4. 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 apps in Entra ID for Microsoft 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 ellipsis icon 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 ellipsis icon 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 ellipsis icon 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.

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: