Setting up connectors

Connectors enable you to import data about your organization, such as device data or user data, in to the Neurons Platform. There are connectors specific to applications, such as the Ivanti Endpoint Manager connector, or there are generic connectors, such as the CSV connector.

To set up a connector, you usually need to install the connector server utility on your network, first. If you are connecting to a cloud-hosted service, you may not need to install a connector server.

Next, you need to create connectors for the server that are configured to gather data from specific sources at specific times.

  • The connector server is software that you install in your local environment that can relay data to Neurons from the data source (for example, Endpoint Manager). The connector server uses HTTPS (port 443) to communicate. For more information about URLs and IP addresses, see the article in the Community: Ivanti Neurons URL and IP White List.

    The connector server has the following minimum system requirements:

  • A connector keeps the details of which data to gather, where to gather it from, and when and how frequently to relay that information to Ivanti Neurons. Each connector is associated with a specific connector server.

You can have as many connector servers and connectors as you need to gather data when and how you want to. 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.

  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.

    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.
  3. From the list, select the type of connector to create. Important: The Jamf Pro connector requires that you enable an option in Jamf Pro before selecting and setting it up in Neurons. Otherwise, the connector will not work as intended. For details, see Jamf Pro connector.
  4. Configure the options for the connector.

  5. To run the connector immediately, click Save and Run.

    -Or-

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

  6. To monitor the progress of connectors, click the Connectors tab and set the toggle at the top of the page to Connectors. The list of connectors shows the start and stop times for the connector, as well as the number of records processed and the number of records that failed to import. 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 More Options icon in the far-right column.
  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 More Options icon in the far-right column.
  3. Select Disable or Delete.

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

  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 More Options icon at the top right corner.
  3. Click Delete connector server.

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