Elastic Cloud

Actions for Elastic Cloud

• Send to Elastic Cloud Index. Sends a custom set of Lucidum data to Elastic Cloud.

Use Cases

Below are the possible use cases for this action:

• If you want to run Lucidum “headless”, you can send relevant data to Elastic Cloud on a regular schedule.

• You can send data to Elasticsearch to be indexed, searched, and analyzed.

Prerequisites

Before you can execute actions on Elastic Cloud, you must first create an account on Elastic Cloud and retrieve the following:

• API Key ID

• API Key Secret (value of the key)

https://www.elastic.co/guide/en/cloud/current/ec-api-keys.html

Workflows

• Creating a new Configuration and a new Action

• Creating a new Action from the Location Results page

• Editing a Configuration

• Editing an Action

• Viewing Information about an Action

Elastic Cloud Configuration

• Configuration Name. Identifier for the Configuration. This name will appear in the Lucidum Action Center.

• Cloud ID. Unique identifier for the hosted Elasticsearch cluster on Elasticsearch Service. You can find the Cloud ID in the Elasticsearch Service web console.

• API Key ID. The name of the API key.

• API Key. The value of the API key.

• Max # of Records per Payload. The maximum number of records to send to Elastic Cloud in each action. The default value is “50”.

• Verify SSL. For future use. The default value is “False”.

Create or Edit an Action

You can create the following types of Actions for Elastic Cloud:

• Send to Elastic Cloud Index. Sends a custom set of Lucidum data to Elastic Cloud.

To create an action for Elastic Cloud:

1. Go to the Create a New Action page.

   

2. In the General step, enter values in these fields:

   • Action Type. Select Send to Elastic Cloud Index from the pulldown options. You can specify which action (patch device or reboot device) later in these steps.

   • Configuration Name. Select an action configuration from the pulldown options.

   • Action Name. Identifier for the action. This name will appear in the Lucidum Action Center.

   • Description. Description of the action.

3. Click the Next (>) icon.

4. The In the Modify Filters page appears.

   

5. In the Modify Filters page, enter the following:

   • Type of Data. This field determines the type of base query that will populate the chart. Choices are

     • Asset. Retrieve information about assets.

     • Asset-IP Mapping. Lucidum uses proprietary machine-learning algorithms to align each asset with an IP address. You can retrieve information about these asset/IP pairs.

     • User. Retrieve information about users.

     • User-IP Mapping. Lucidum uses proprietary machine-learning algorithms to align each user with an IP address. You can retrieve information about these user/IP pairs.

     • Vulnerability. Retrieve information about vulnerabilities.

   • Time Range. This field determines whether the base query that populates the chart will use current data or historical data. Choices are:

     • Current. The default value is from the present day to 7 days old.

     • Historical. The default value is from 8 days old to 30 days old.

     NOTE: You can customize or view the Time Range values in Settings > System Settings > Data Settings.

     • Current uses the value of Data Lookback in Days.

     • Historical uses the value of Data Retention in Days.

6. Click Configure Filters.

7. In the Refine Scope page, you define the query for the assets or users that the action will act upon. For existing actions, this field displays the query for this action. For details on creating and editing queries in Lucidum, see the section on Building Queries.

   

    

8. Click the Apply (page and pencil) icon.

9. Click the Next (>) icon.

10. The Schedule page appears.

    

11. In the Schedule page, enter: 

    • Schedule Type. Define the schedule for the action. Choices are:

      • Recurrence. Specify a frequency for the recurring schedule.

      • After Data Ingestion. The action is executed after data ingestion, which happens at least once every 24 hours and can also be triggered manually.

    • Do not trigger the action unless. Specify the number of results from Filters as a prerequisite for executing the action.

12. Click the Next (>) icon.

13. In the Details step, enter the following:

    

14. In the Details page, enter the following:

    • Output Fields. For the records selected with the Filters field, specify the columns to display. When creating or editing the query in the Filters field, you can select these fields in the Query Results page > Edit Column button.

    • Elastic Cloud Index Name. Specify the Elasticsearch index where you want to store the sent Lucidum data.

    • De-dupe Previous Jobs. In this field, you specify whether you want duplicates of asset IDs (if your query is for assets) or user IDs (if your query is for users). You can specify integers between 0 and the number specified in Settings > System Settings > General > Data Settings > Action Result Retention in Days. This setting specifies the number of days that Lucidum stores action results.

      • If you specify “0” (zero), Lucidum includes all the records from the query in each delivery to Elastic Cloud.

      • If you specify “1” (one), Lucidum examines the previous webhook payload and excludes records for asset IDs or user IDs that were sent in the delivery to Elastic Cloud.

      • If you specify “2” (two), Lucidum examines the last two webhook payloads and excludes records for asset IDs or user IDs that were sent in the previous two deliveries to Elastic Cloud.