Connectors

What are connectors?

Connectors connect third-party software to Identity Security Insights, giving you a tenant-by-tenant view of your organization's overall security posture.

How are they useful?

Connectors help you address critical identity and privilege risks, ensuring a more secure environment with:

• Comprehensive visibility: They provide a holistic view of your organization's privilege landscape, identifying both hidden and known privileges across multiple systems.
• Proactive detection: By continuously monitoring and analyzing identity and account information, they can detect potential security threats before they become critical issues.
• Automated updates: Once configured, the connectors automatically pull data and update dashboards and reports with new or changed recommendations and detections.
• Simplified management: They simplify identity security management by providing easy-to-deploy connectors across on-premises, cloud, and SaaS environments.

Connectivity status

Connectors with a Status set to On actively scan and provide recommendations for the source service. Connectors with a status of Off are paused and do not scan the service or provide new recommendations until manually turned on.

Connectivity displays whether or not the connector is appropriately configured.

• Connected: The connector is appropriately configured and can scan and provide recommendations for the source service.
• Warning: The connector is ingesting data, but some connector requests are failing. Additional information is kept on the connector's activity history page.
• Failed: The connector is unable to scan or communicate with the source service. Click Failed to go to the connector's activity history page.
• Connector Off: The connector has been paused from scanning and providing recommendations.
• Pending Agent Registration: In the case of Microsoft Active Directory, the connector is waiting to be registered with the installer.

Manage connectors

You can manage your existing connectors via the Configured tab on the Connectors page in Identity Security Insights.

Create a connector

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays.

2. Click the Available tab.

3. Locate the type of connector you wish to add and click Create Connector.

4. From the table of contents In the Insights documentation, locate the type of connector you want to create and follow the specific procedures.

View a list of your existing connectors

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays with the Configured tab open by default.
2. On the Configured tab, view all of your configured connectors' names, activity, type, status, and connectivity.
3. View all available connectors within Insights on the Available tab.

Turn off an active connector

Turning a connector off pauses the collection. All settings are retained.

🚧

IMPORTANT

You cannot turn off an active Insights Collector. To stop these, you must delete them.

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays with the Configured tab open by default.
2. On the Configured tab, locate the connector you want to turn off.
3. Click Actions menu > Turn Off Connector.
   The connector pauses scans and new recommendations, and Insights displays the Connectivity status as Connector Off.

Turn on an inactive connector

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays with the Configured tab open by default.
2. On the Configured tab, locate the connector you want to turn on.
3. Click Actions menu > Turn On Connector.
   The connector immediately begins to scan and, if applicable, offer new recommendations.

Open a connector

Opening a connector displays the connector's Overview page with high-level information about the selected connector. From this page, you can edit the name, delete the connector, and turn it on or off.

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays.

2. Click the Available tab.

3. Locate the connector in the list.

4. Click the connector's name.
   The connector's Overview page displays by default.

View a connector's settings

Use the Settings page to review the connection information for your selected connector. Depending on the connector type, you can update configuration requirements such as the connector's domain, API keys, usernames, authentication rules, and other credentials.

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays.

2. Click the Available tab.

3. Locate the connector in the list.

4. Click the connector's name.
   The connector's Overview page displays by default.

5. Click Settings.
   The collector's settings display.

View a connector's activity history

View a list of the date and time of any updates or changes made to the connector. For connectors with a connectivity status of Failed or Warning, you can expand the Activity Timeline entry to view a summary of the error to aid in troubleshooting.

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays.

2. Click the Available tab.

3. Locate the connector in the list.

4. Click the connector's name.
   The connector's Overview page displays by default.

5. Click Activity History.
   The collector's history displays.

Delete a connector

1. From the top left menu, click Insights > Connectors.
   The Connectors page displays with the Configured tab open by default.
2. On the Configured tab, locate the connector you want to turn on.
3. Click Actions menu > Delete Connector.
   The connector deletes and scans stop.