View and Manage Entities
This topic has information about the Entities page in CSE UI, which lists all of the Entities in CSE and their Activity Scores, and the Entities > Details page, which presents information about a particular Entity, including Signals and Insights associated with the Entity.
The Entities page is useful for monitoring Entities that are close to having an Insight created. On the Entities > Details page, you can view Signals and Insights for an Entity, and, as desired, manually create an Insight from Signals associated with the Entity.
You can also update the tags, suppression state, and Criticality assigned to Entities, as described below in the Update Multiple Entities section below.
In CSE, an Entity is a unique actor that a Signal fired upon. CSE has a number of built-in Entity types:
- IP Address
- MAC Address
- User Agent
You can create custom Entity types as well. For more information, see Create a Custom Entity Type.
When a Signal is fired, if an Entity doesn’t already exist in CSE for the item that the Signal fired on, CSE creates an Entity for it. For more information about Entities and Signal and Insight generation, see Insight Generation Process.
About the Entities list page
To view the Entities page, click Entities at the top of the CSE UI.
Here’s a screenshot of the Entities page.
|a||This area shows the total number of unique Entities in CSE.|
|b||In the Filters area, you can filter the list of Entities by Activity Score, Hostname, IP Address, Username, Tags, Type, and Suppressed.|
|c||In this area you can sort Entities by Activity Score, Name, or Type.|
|d||The Import Metadata option allows you to upload a .csv file of updates to Entity tags, suppression state, and Criticality, as described in Update Multiple Entities.|
|e||Shows the Entity Type and its value.|
|f||The Criticality column shows whether a Criticality has been assigned to the Entity. A Criticality adjusts the severity of Signals for specific Entities based on some risk factor or other consideration. If a Criticality hasn't been assigned to an Entity, the column contains "default".|
|g||The current Activity Score for the Entity, which by default is the sum of the severities of the Signals that have fired on the Entity over the previous two weeks. For more information, see Understanding Entity Activity Scores, in the Insight Generation Process topic.|
|h||If you see a link below the Entity value, it’s a tag. You can click it to filter Entities by that tag.|
|i||If an Entity has the Suppressed indicator, that means that Signals will not be fired on the Entity.|
About the Entities Details page
When you click an Entity on the Entities page, a details page for the Entity appears.
|a||Suppression slider. Shows whether or not the Entity is currently suppressed. You can use the slider to suppress the Entity so that it is excluded from the Insight generation process.|
|b||Tags. Lists any tags assigned to the Entity. You can add a new tag, select a tag to assign, or remove a tag from the Entity.|
|c||Criticality. An Entity’s Criticality is a setting that adjusts the severity of Signals that fire on the Entity, based on a risk factor or other consideration. You can reset the Criticality here.|
|d||Metadata. This section lists the contents of enrichment fields that were added during Record processing.|
|e||Inventory. If the selected Entity is standard Entity type (as opposed to a custom Entity type), this area provides selected information about the Inventory object associated with the Entity. (Inventory information is not provided for custom entity types.) Inventory data is customer or 3rd-party provided information that describes devices and users along with contact information and job descriptions. CSE joins inventory data on demand with data from Entities in Insights data to provide context to Signals.|
|f||Notes. Contains any notes added to the Entity.|
|g||Audit Log. This area will list any audit events that have been logged for the Entity. An audit log is generated each time an Entity is suppressed or unsuppressed.|
|h||Recent Activity. Provides a count of how many Signals or Insights included the Entity within the last 30 days. Click the plus sign (+) next to Signals or Insights to expand the list.|
|i||Activity tab. This tab displays a visualization of Signals on the Entity over time.The x-axis is time, the y-axis is severity. The icons represent Signals.|
|j||Enrichments tab. If you use CSE’s automation as a service, Entity enrichments obtained from Cloud SOAR may be available on this tab.|
|k||Entity Timeline. If the selected Entity is a username, an Entity Timeline tab is present. For more information, see Entity Timeline.|
|l||Create Insight. You can use this option to create an Insight on the Entity, as described below in Create an Insight, below.|
|m||The Current State section lists Signals that were generated for the Entity during the current Detection Window that are not already part of an Insight. (The Detection Window is the period over which CSE evaluates Signals, which is 14 days, by default. The Detection Window is configured on the Content > Custom Insights page in the CSE UI.)|
|n||The Prior Activity section lists Signals that were generated for the Entity prior to the current Detection window, and all Insights for the Entity.|
About the Entity Timeline tab
The Entity Timeline tab provides visibility into Entity inventory data, Entity relationships, Records, Signals, and Insights over a default three-day time period. This view gives information about what else the Entity doing before, during, and after Signals and Insights involving the Entity were generated.
The right side of the tab organizes Records by Record Type and vendor, with a Record count. For example, the screenshot below indicates that there were two email Records from Microsoft Office 365 at 4:41:02 AM. The orange icon to the left of the Record summary indicates that the Record aggregation contains a Signal. The indented item below the Record summary is a link to the Signal.
Similarly, a red icon indicates that the Record set contains an Insight, and the link below the summary is a link to the Insight.
You can view a summary of the Records in a Record set by clicking on it. The Records are listed on the right side of the Entity Timeline tab. To view the complete Record, click the link in the upper right corner of the card for a Record.
Create an Insight
You can create an Insight for an Entity based on one or more Signals on the Entity. To do so, checkmark each Signal you want to include in the Insight, and click Create Insight.
The page refreshes and shows the selected Signals grouped in a new Insight.
Update multiple Entities
This section describes how to update the tags, suppression state, or Criticality for one or more Entities.
Update Entities from the UI
- Click Entities at the top of the CSE UI.
- Note that there is a checkbox at the left end of each Entity row, and one above the Entities list.
- Click the top checkbox to select all of the Entities on the page, or click the checkbox next to each Entity you want to update.
- Note that once you select an Entity, three options appear at the top of the Entities list. See the instructions for each option below:
- After selecting the Entities you want to update, click Update Tags.
- Click the down arrow to display the options:
- Add. Select this option to add one or more tags to the Entity, without affecting any tags already assigned to the Entity. You’re prompted to select a tag. If you select a schema tag, you’re prompted to select a tag value. You can select multiple tags to add.
- Remove. Select his option to remove one or more tags from the Entity. You’re prompted to select a tag. If you select a schema tag, you’re prompted to select a tag value. You can select multiple tags to remove. If a selected Entity doesn't have the specified tags, no change will be made to the Entity.
- Replace. Select this option to remove all of the tags currently assigned to the Entity and add one or more specified tags. You’re prompted to select a tag. If you select a schema tag, you’re prompted to select a tag value. info
When you use the Replace option, be sure to specify new tags. If you don't, the existing tags will still be removed.
- As you select tags, they’ll appear in the update popup.
- When you are done selecting tags, click Update Entity Tags.
- After selecting the Entities you want to update, click Update Suppression.
- The Update Suppression popup appears, with the suppression toggle set to Not Suppressed.
- If you want to unsuppress the selected Entities, click Update Entity Suppression. Otherwise, if you want to suppress the Entity, toggle the slider to Suppressed, supply a comment if desired, and then click Update Entity Suppression.
- After selecting the Entities you want to update, click Update Criticalities.
- The Update Criticalities popup appears.
- If you want to assign default Criticality to the selected Entities, click Update Entity Criticalities. Otherwise, use the down arrow to view defined Criticalities, select one, and then click Update Entity Criticalities.
Import Entity updates from a CSV file
You can update Entities by uploading a .csv file to CSE.
CSV file format
There are two supported formats. The difference is in how you identify the target Entity.
- Format 1—You use the
idfield to specify a target Entity.
id, suppressed, criticality, tags, tags_to_add, tags_to_remove
- Format 2—You use the
valuefields to specify the target Entity.
type, value, suppressed, criticality, tags, tags_to_add, tags_to_remove
Regardless of the format you use, there are a couple of approaches to updating Entity tags.
- You can use
tags_to_removeto add new tags and remove existing tags, respectively.
- You can use a
tagsvalue to specify replacement tags. This will remove all existing tags and add all of the specified replacement tags.
See the next section for column definitions.
The table below defines the columns in the .csv file.
- The first row of the .csv file must contain all supported columns.
- The .csv file must contain either values in the
idcolumn or values in both the
valuecolumn, and a value in at least one other column.
- If a row has a value in the
tagscolumn, it can’t have values in either the
|This field is required for Format 1.|
To form the id field value, concatenate the Entity
You can optionally specify an Entity’s sensor zone as a part of the
|This field is required for Format 2.|
Identifies the type of Entity, one of:
|This field is required for Format 2.|
The value of the Entity, for example, for an IP address:
|Identifies the sensor zone for the Entity. |
Don’t include this column if you are specifying Entity sensor zones in the
|When true, CSE suppresses the Entity.|
|Assigns a Criticality to the Entity. (An Entity’s Criticality is a setting that adjusts the severity of Signals that fire on the Entity, based on a risk factor or other consideration.) You can only specify a Criticality that has already been configured in CSE. Allowable values:|
|The tags to assign to the target. This column can’t be present if the file contains a tags_to_add or tags_to_remove column.|
Specify a schema key tag as
To assign multiple tags, enclose them in double quotes. For example:
|The tag to assign to the target Entity. This column can’t be present if the file contains a tags column.|
Specify a schema key tag as
|The tag to remove from the target Entity. This column can’t be present if the file contains a tags column.|
Specify a schema key tag as
Example CSV files
Format 1 example
Format 2 example
Upload CSV file
After creating file, click Import Metadata in the upper right of the Entities page and upload the file.