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:
- Microsoft Server operating system that is compatible with the Ivanti Neurons Agent installation
- Intel Core i7 processor at 2.5 GHz
- 8 GB of RAM
- 40 GB of disk space
- Broadband internet connection
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.
-
Log into your Ivanti Neurons account as Administrator.
-
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. -
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.
-
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.
Ongoing tasks
- Click Admin > Connectors and make sure the toggle at the top of the page is set to Connector Servers.
- 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.
- From the available connectors list, select the type of connector to create.
- Configure the options for the connector. For details about individual connectors, see the full list at the bottom of this topic.
- 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. - 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.
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.
You can also view imported records on the Devices page. For details, see Devices.
- Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
- Find the connector that you want to change and click the icon in the column to the far right.
- Select Run now. The connector syncs all current data.
- Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
- Find the connector that you want to change and click the icon in the column to the far right.
- 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.
- Click Admin > Connectors and make sure the toggle at the top of the page is set to Connectors.
- Find the connector that you want to wipe data from and click the icon in the column to the far right.
- Select Wipe Data.
- Click Admin > Connectors and make sure the toggle at the top of the page is set to Connector servers.
- Find the connector server that you want to uninstall and click the icon at the top right corner.
-
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.
- 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:
- Adobe connector
- Amazon Web Services (AWS) connector
- Catchpoint connector - BETA
- CDW CSV Import connector
- CrowdStrike connector
- Cynerio connector
- Dell Warranty connector
- Generic File Import (CSV) connector
- Google Chrome Enterprise connector
- Google Workspace connector
- Insight connector
- Intel Endpoint Management Assistant connector
- Ivanti Avalanche connector
- Ivanti Cherwell Service Management connector
- Ivanti Data Center Discovery connector
- Ivanti Desktop & Server Management connector
- Ivanti Endpoint Manager connector
- Ivanti Endpoint Security connector
- Ivanti Neurons for ITSM connector
- Ivanti Neurons for MDM connector
- Ivanti Neurons for Service Mapping connector - BETA
- Ivanti Patch for Configuration Manager
- Ivanti Pulse Profiler connector
- Ivanti Security Controls connector
- Jamf Pro connector
- Lenovo Warranty connector - BETA
- Microsoft 365 connector
- Microsoft Active Directory connector
- Microsoft Azure connector
- Microsoft Configuration Manager connector
- Microsoft Defender for Endpoint connector
- Microsoft Entra ID connector
- Microsoft Intune connector
- Okta connector
- OneLogin connector
- Qualys connector
- Rapid7 connector
- Salesforce connector
- ServiceNow connector
- Tenable connector
- VMware vCenter connector
- Workspace ONE connector