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 a List of Available Connectors
To view the list of Connectors on your version of Lucidum:
Navigate to the Lucidum UI
In the left pane, click Connector.
In the Connector page, click Add Connector.
Scroll through the list of available Connectors.
Adding a Connector
To configure a connector for use with Lucidum:
Navigate to the Lucidum UI
In the left pane, click Connector.
In the Connector page, click Add Connector.
Scroll through the list of available Connectors.
When you find the Connector you want to use, mouse over it and click Connect.
In the Settings page for a Connector, notice that each Connector includes a Default profile.
Populate the fields in the Default profile.
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 use the Test button 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”.
Editing a Connector
To edit the settings in an already configured Connector:
Navigate to the Lucidum UI
In the left pane, click Connector.
In the Connector page, use the Search box to search for the Connector you want to edit.
When you find the Connector you want to use, mouse over it and click Edit.
In the Settings page, make one or more changes.
Click Apply Changes.
Test the Connector, if necessary.
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 existing Connector. To do this:
Navigate to the Lucidum UI
In the left pane, click Connector.
In the Connector page, use the Search box to search for the Connector you want to edit.
When you find the Connector you want to use, mouse over it and click Edit.
In the Settings page, click +add.
Populate the fields for the new profile.
For details on configuring each type of Connector, see the specific page for that Connector.
Deleting a Profile from an Existing Connector
Navigate to the Lucidum UI
In the left pane, click Connector.
In the Connector page, use the Search box to search for the Connector you want to edit.
When you find the Connector you want to use, mouse over it and click Edit.
In the Settings page, highlight the profile you want to delete.
Click Delete anyway.
Configuring a Connector to Use a Proxy Server
Log on to your Lucidum system.
In the left pane, click Connector.
If this is a new connector, in the Connector page, click Add Connector.
If this is an existing connector, scroll until you find the Connector you want to edit. Click Connect. The Settings page appears.
If the connector supports a proxy, it will include the Proxy field.
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.
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. You can use the Connect button to manually ingest data on demand.
Navigate to the Lucidum UI
In the left pane, click Connector.
In the Connector page, use the Search box to search for the Connector you want to edit.
When you find the Connector you want to use, mouse over it and click Edit.
In the Settings page, click Connect.
Stop Ingesting Data from a Connector
You can pause or permanently stop ingesting data with an existing Connector. To do this:
Navigate to the Lucidum UI
In the left pane, click Connector.
In the Connector page, use the Search box to search for the Connector you want to edit.
When you find the Connector you want to use, mouse over it and click Edit.
In the Settings page, click Disconnect.
Lucidum stops automatically ingesting data with this Connector.
To enable the Connector at a later date, perform these steps and click on Connect.
On-Demand Ingesting from All Connectors
Lucidum ingests data from all connectors every 24 hours. To ingest all data from all connectors, on demand:
Navigate to the Lucidum UI
In the left pane, click Monitoring.
Select Ingestion Trigger
In the Ingestion Trigger page, click the Ingest All Data button.