Skip to main content
Skip table of contents

Using Connectors

Connectors allow Lucidum to ingest data from your environment and discover, identify, and classify assets, data, and users.

Lucidum includes pre-built connectors for the most commonly used solutions for security, vulnerability scanning, cloud, data warehouse, identity management, logs, network, endpoint management, IP management, file sharing, and devops.

To configure a connector, you provide credentials that allow Lucidum secure, read-only access to a deployed solution.

Viewing the List of Connectors

To view the list of Connectors on your version of Lucidum:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. The connectors are categorized as:

    • Errors. These connectors that have been configured for use but have errors connecting.

    • Disabled. These connectors that have been configured for use but are currently disabled.

    • Enabled. These connectors that have been configured for use and are currently in use.

    • Available. These connectors have not been configured for use.

  5. You can use the Filter Connectors by Group field in the upper right to view connectors by categories like Cloud Security, Application Management. Identity Access Management.

Viewing the Status of a Connector

To view the status of a connector:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. The connector categories provide a high-level status of each connector.

  5. The connectors are categorized as:

    • Errors. These connectors have been configured for use but have errors connecting.

    • Disabled. These connectors have been configured for use but are currently disabled.

    • Enabled. These connectors have been configured for use and are currently in use.

    • Available. These connectors have not been configured for use.

  6. When you find the connector you want to view, click on its icon.

  7. The Settings page appears.

    • If the connector has a red icon in the upper right, it is disabled.

    • If the connector has a green icon in the upper right, it is enabled.

  8. To get immediate information about a connector, you can test the connector.

    • If the profile is configured correctly, Lucidum displays a list of services that are available with the connector.

    • If the profile is not configured correctly, Lucidum displays an error message or the message “Services Not Available”.

  9. For detailed logs about your connectors, contact Lucidum Customer Success.

Adding a Connector

To configure a connector for use with Lucidum:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Available category.

  5. When you find the connector you want to add, click on its icon.

  6. In the Settings page, populate the fields in the Create a New Profile pane. This new profile will be the default profile for the connector.

For details on configuring each type of Connector, see the specific page for that Connector.

Testing a Connector

While in the Settings page, you can click the Test Profile (checklist) icon to test the configuration.

  • If the configuration is correct, Lucidum displays a list of services that are available with the connector.

  • If the Configuration is not correct, Lucidum displays an error message or the message “Services Not Available”.

To test a connector:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Errors, Disabled, or Enabled category. These are connectors that have already been configured.

  5. When you find the connector you want to test, click on its icon.

  6. In the Settings page, in the left pane, select the profile you want to test.

  7. Ensure that the connector is enabled.

  8. Click the text icon.

Editing a Connector

To edit the settings in an already configured Connector:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Errors, Disabled, or Enabled category. These are connectors that have already been configured.

  5. When you find the connector you want to edit, click on its icon.

  6. In the Settings page, in the left pane, select the profile you want to edit.

  7. Edit the fields in the right pane.

  8. Click the Save Profile (disc) icon to save your changes.

Adding an Additional Profile to an Existing Connector

If you want to ingest data from multiple instances of an asset, you can add an additional profile to an already configured connector. To do this:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Errors, Disabled, or Enabled category. These are connectors that have already been configured.

  5. When you find the connector you to which want to add a profile, click on its icon.

  6. In the Settings page, in the left pane, click Create a New Profile.

  7. In the right pane, in the Create a New Profile pane, enter values in the fields.

  8. Click the Save Profile (disc) icon to save your new profile.

  9. To enable the connector, click the Connection Status icon until it shows the green checkmark.

For details on configuring each type of Connector, see the specific page for that Connector.

Deleting a Profile from an Existing Connector

To delete a profile from a connector:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Errors, Disabled, or Enabled category. These are connectors that have already been configured.

  5. When you find the connector you to which want to add a profile, click on its icon.

  6. In the Settings page, in the left pane, find the profile you want to delete and click its Delete (trash can) icon.

Configuring a Connector to Use a Proxy Server

A proxy server allows Lucidum connectors that run on your SaaS account to fetch data securely from your on-premises assets.

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Errors, Disabled, or Enabled category. These are connectors that have already been configured.

  5. In the Settings page, scroll down the field in the right pane. If the connector supports a proxy, it will include the Proxy field.

  6. Enter the following in the Proxy field:

    • 192.168.255.6:3128

    This is the IP address and port number of the proxy service inside the docker container on the proxy server.

For more details on configuring a proxy server, see Configuring a Proxy Server.

Start Ingesting Data with a Connector

After you have successfully configured a Connector, you can immediately start ingesting data with that Connector. To do this:

NOTE: Lucidum automatically ingests data from all Connectors once a day, at midnight.

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Errors, Disabled, or Enabled category. These are connectors that have already been configured.

  5. When you find the connector you want to enable, click on its icon.

  6. In the Settings page, in the right pane, click the Connection Status icon until it shows the green checkmark.

  7. Click the Save Profile (disc) icon to save your changes.

Stop Ingesting Data from a Connector

You can pause or permanently stop ingesting data with an existing Connector. To do this:

  1. Navigate to the Lucidum UI

  2. In the left pane, click the Connectors icon.

  3. In the Connectors page, you can view the list of connectors.

  4. Look for the connector in the Errors, Disabled, or Enabled category. These are connectors that have already been configured.

  5. When you find the connector you want to disable, click on its icon.

  6. In the Settings page, in the right pane, click the Connection Status icon until it shows the red square.

  7. Click the Save Profile (disc) icon to save your changes.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.