Connectors

What are connectors?

Connectors connect third-party software to Identity Security Insights to give you a comprehensive view of your 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 working as expected; no action is needed.
• Off: Indicates the connector was either manually disabled or automatically deactivated due to invalid credentials persisting for over a week.
• Pending: Applies to new connectors that have not finished a first event or inventory scan. Additionally, applies to the Insights Collector when no data has yet been received from the on-prem agent after setup.
• Action Required: Customer action is needed to resolve an issue. Click this status to open the Overview page, where a banner provides clear guidance.

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 connectivity details

View a list of the date and time of any updates or changes made to the connector. Details include latest status for each job type (like Inventory or Events) and surfaces issues and actions required, if any.

This page also contains a link to a the connector's report.

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 Connectivity Details.
   The collector's details display.

6. Optionally, click View report to go to Reporting.

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.