Skip to content

Commit c95f1c2

Browse files
authored
DOCS-324 - Cloud SIEM list redesign - Configuration pages (#4763)
* Ingest mappings and log mappings * Finish 'Integrations Configuration' page * Normalization and Custom Types * More configuration tabs * Add multiple standard log mapping image * Entity Groups and Tag Schemas * Update lookup table article
1 parent 67251ff commit c95f1c2

File tree

102 files changed

+145
-142
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

102 files changed

+145
-142
lines changed

docs/cse/administration/create-a-custom-tag-schema.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,8 @@ For more information about tags in Cloud SIEM, see [Using Tags with Insights, Si
2222
## Define a custom tag schema
2323

2424
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Workflow** select **Tag Schemas**.<br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Workflow** select **Tag Schemas**. You can also click the **Go To...** menu at the top of the screen and select **Tag Schemas**.
25-
1. On the **Tag Schemas** page, click **Create**. <br/><img src={useBaseUrl('img/cse/tag-schema-empty.png')} alt="Create tag schema" style={{border: '1px solid gray'}} width="400"/>
26-
1. The **Tag Schema** popup appears.
25+
1. On the **Tag Schemas** page, click **+Add Tag Schema**.
26+
1. The **Add Tag Schemas** popup appears. <br/><img src={useBaseUrl('img/cse/tag-schema-empty.png')} alt="Create tag schema" style={{border: '1px solid gray'}} width="400"/>
2727
1. **Key**. Enter an identifier for the tag you’re defining. It won’t appear in the UI for assigning tags to a content item, unless you leave the **Label** field blank.
2828
1. **Label**. Enter a label for the tag. If you supply a label, that’s what will appear in the UI for assigning tags to a content item.
2929
1. **Content Types**. Select the types that you want the tag to be
@@ -32,7 +32,7 @@ For more information about tags in Cloud SIEM, see [Using Tags with Insights, Si
3232
* **Rule**
3333
* **Entity** The options do not include **Signal** or **Insight**. Signals and Insights inherit tag values from the rule(s) or Custom Insight definition that triggered the Signal or Insight and involved Entities.
3434
1. **Allow Custom Values**. Check this box to allow users to add additional allowable values to the tag schema. Otherwise, when applying the tag users may only select one of the values you define in the **Value Options** section below.
35-
1. **Value Options**. If **Allow Custom Values** is not checked, you must define at least one value for the tag:
35+
1. If **Allow Custom Values** is not checked, you must define at least one value for the tag:
3636
* **Enter Value**. Enter an allowable value for the tag.
3737
* **Enter Label**. Enter a label for the value.
3838
* **Enter Link** (optional). Enter a URL for it to appear in the Actions menu of the tag in any content items to which it’s been applied. Cloud SIEM’s built-in schema tags are examples of schema tags that include a link. The screenshot below shows a link from the **Tactic:TA0002** to associated information on the MITRE site. <br/><img src={useBaseUrl('img/cse/mitre-link.png')} alt="Example MITRE link" style={{border: '1px solid gray'}} width="400"/>

docs/cse/administration/create-cse-actions.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -73,10 +73,10 @@ The notification sent by a Rule Action contains the name of the rule and the re
7373
## Create an Action
7474

7575
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Integrations** select **Actions**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Integrations** select **Actions**. You can also click the **Go To...** menu at the top of the screen and select **Actions**.
76-
1. On the **Actions** page, click **Create**.
77-
1. The **Create Action** popup appears. <br/><img src={useBaseUrl('img/cse/create-action-empty.png')} alt="Create Action dialog" style={{border: '1px solid gray'}} width="500" />
76+
1. On the **Actions** tab, click **+ Add Action**.
77+
1. The **Add Action** popup appears. <br/><img src={useBaseUrl('img/cse/create-action-empty.png')} alt="Create Action dialog" style={{border: '1px solid gray'}} width="400" />
7878
1. **Name**. Enter a name that communicates what the Action does.
79-
1. **Type**. Choose one of the following options, and follow the instructions for that Action type to complete creating your Action.
79+
1. **Action Type**. Choose one of the following options, and follow the instructions for that Action type to complete creating your Action.
8080
* [AWS Simple Notification Service](#aws-simple-notification-service-sns)
8181
* [Demisto](#demistocortex-xsoar)
8282
* [Email](#email)

docs/cse/administration/create-cse-context-actions.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ The Context Actions menu will be available for any of these types, wherever they
3232

3333
## How a user accesses Context Actions
3434

35-
A user runs a Context Action by clicking the Context Action icon next to an Entity, Record field, or IOC and choosing an action from the list that appears. The icon appears when you hover over the value of the item.
35+
A user runs a Context Action by clicking the Context Action icon <img src={useBaseUrl('img/cse/context-action-icon.png')} alt="Context action icon" style={{border: '1px solid gray'}} width="20"/> next to an Entity, Record field, or IOC and choosing an action from the list that appears. The icon appears when you hover over the value of the item.
3636

3737
In the screenshot below, Context Actions are listed below the built-in **Add to Match List** and **Add to Suppressed List** options.
3838

@@ -58,17 +58,18 @@ import Iframe from 'react-iframe'; 
5858
## Configure a Context Action
5959

6060
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Integrations** select **Context Actions**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Integrations** select **Context Actions**. You can also click the **Go To...** menu at the top of the screen and select **Context Actions**.
61-
1. On the **Context Actions** page click **Create**.
62-
1. Create the context action. <br/><img src={useBaseUrl('img/cse/configured-action.png')} alt="Configure action" style={{border: '1px solid gray'}} width="500"/>
63-
1. **Enter Context Action Name**. Enter a name for the Context Action. 
64-
1. Choose whether you want to open a **URL** to an external service or
65-
a **Sumo Logic Query**
66-
1. Enter the URL or log query that the context action will issue.
61+
1. On the **Context Actions** tab click **+ Add Context Action**.
62+
1. Create the context action. <br/><img src={useBaseUrl('img/cse/configured-action.png')} alt="Configure action" style={{border: '1px solid gray'}} width="400"/>
63+
1. **Name**. Enter a name for the Context Action. 
64+
1. **Action Type**. Choose whether you want to open a **Sumo Logic Query** or a **URL** to an external service. 
65+
1. **Query**. Enter the URL or log query that the context action will issue.
6766
For instructions, see:
6867
* [Create a Sumo Logic search URL](#create-a-sumo-logic-search-url)
6968
* [Create a URL to external service](#create-an-url-to-an-external-service)
7069
1. If you chose **Sumo Logic Query** above, the **Timestamp offset** option appears, which set the query time range. The offset can be either -30m or +30m, and it will be applied to the timestamp in the target Record’s [timestamp](/docs/cse/schema/schema-attributes) field.
71-
1. Choose the IOC data types to which the context action will apply. You can select one or more of the following data types listed below. Your context action will be available for any occurrences of the IOCs you select.
70+
1. **Entity Types**. Select the Entity types that the context action will apply to.
71+
1. **Record Properties**. Select the Record properties that the context action will apply to.
72+
1. **IOC Data Types**. Choose the IOC data types to which the context action will apply. You can select one or more of the following data types listed below. Your context action will be available for any occurrences of the IOCs you select.
7273
* **Domain**
7374
* **Entity Types**
7475
* **Hash**

docs/cse/administration/manage-custom-insight-resolutions.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,14 @@ You can define custom *sub-resolutions* for any of the built-in resolutions. Thi
2323
## Create a custom sub-resolution
2424

2525
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Workflow** select **Resolutions**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Workflow** select **Insight Resolutions**. You can also click the **Go To...** menu at the top of the screen and select **Insight Resolutions**.
26-
1. On the **Insight Resolutions** page, click **Create**.
27-
1. The **Create Insight Resolution** page appears.
26+
1. On the **Insight Resolutions** tab, click **+ Add Resolution**.
27+
1. The **Add Insight Resolution** popup appears.
2828
1. **Name**. Enter a meaningful name for the new resolution.
2929
1. **Parent Resolution**. Display the dropdown list and select a built-in resolution.
3030
1. **Description**. (Optional) Enter a description that will help other users understand when to use the new resolution.
31-
1. Click **Create**. <br/><img src={useBaseUrl('img/cse/create-insight-resolution.png')} alt="Create Insight resolution dialog" style={{border: '1px solid gray'}} width="400"/>
32-
1. The new resolution appears on the **Insight Resolutions** page, indented below the parent resolution.
31+
1. Click **Save**. <br/><img src={useBaseUrl('img/cse/create-insight-resolution.png')} alt="Create Insight resolution dialog" style={{border: '1px solid gray'}} width="400"/>
32+
33+
The new resolution appears on the **Insight Resolutions** tab, indented below the parent resolution.
3334

3435
## Close an Insight using a custom resolution
3536

docs/cse/administration/manage-custom-insight-statuses.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ This page has information about creating and managing custom Insight statuses.
1414
To view Insight statuses:
1515

1616
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Workflow** select **Statuses**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Workflow** select **Insight Statuses**. You can also click the **Go To...** menu at the top of the screen and select **Insight Statuses**.
17-
1. This screenshot of the **Statuses** page shows the three Insight statuses that are preconfigured:
17+
1. This screenshot of the **Insight Statuses** tab shows the three Insight statuses that are preconfigured:
1818
* **New**. Insights that have not been worked on yet.
1919
* **In Progress**. Insights that are being investigated. If you want to create custom statuses to represent different types of "in progress" states, you can click the **Enabled** toggle to disable the default **In Progress** status to reduce confusion.
2020
* **Closed**. Insights whose investigations are complete. <br/><img src={useBaseUrl('img/cse/workflow-page.png')} alt="Statuses page" style={{border: '1px solid gray'}} width="700"/>
@@ -26,28 +26,28 @@ Preconfigured Insight statuses cannot be edited or deleted. You can however crea
2626
To create a custom Insight status:
2727

2828
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Workflow** select **Statuses**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Workflow** select **Insight Statuses**. You can also click the **Go To...** menu at the top of the screen and select **Insight Statuses**.
29-
1. On the **Statuses** page, click **Create Status**.
30-
1. On the **New Status** popup, enter a name and description for the status.
29+
1. On the **Insight Statuses** tab, click **+ Add Status**.
30+
1. On the **Add Insight Status** popup, enter a name and description for the status.
3131
1. Click **Color** to select a color for the status. The color will appear on the status on the [Heads Up Display](/docs/cse/get-started-with-cloud-siem/cse-heads-up-display).
3232

3333
## Change the order of Insight statuses
3434

35-
You can change the status of an Insight on the **Details** pane of the page for the Insight. Note that the items in the **Status** dropdown appear in the same order as they do on the **Statuses** page.
35+
You can change the status of an Insight on the **Details** pane of the page for the Insight. Note that the items in the **Status** dropdown appear in the same order as they do on the **Insight Statuses** tab.
3636

3737
<img src={useBaseUrl('img/cse/status-dropdown.png')} alt="Status dropdown" style={{border: '1px solid gray'}} width="300"/>
3838

39-
To change the order that the statuses appear in the **Status** dropdown, you can reorder them on the **Statuses** page, except for **New** and **Closed**. **New** must always be the first status, and **Closed** must always be the last.
39+
To change the order that the statuses appear in the **Status** dropdown, you can reorder them on the **Insight Statuses** tab, except for **New** and **Closed**. **New** must always be the first status, and **Closed** must always be the last.
4040

4141
To change the order of Insight statuses:
4242

4343

4444
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Workflow** select **Statuses**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Workflow** select **Insight Statuses**. You can also click the **Go To...** menu at the top of the screen and select **Insight Statuses**.
45-
1. On the **Statuses** page, each status that can be moved has a handle to the left of its name. <br/><img src={useBaseUrl('img/cse/reorder-icons.png')} alt="Reorder icons" style={{border: '1px solid gray'}} width="200"/>
45+
1. On the **Insight Statuses** tab, each status that can be moved has a handle to the left of its name. <br/><img src={useBaseUrl('img/cse/reorder-icons.png')} alt="Reorder icons" style={{border: '1px solid gray'}} width="600"/>
4646
1. To move a status to a different location on the list, use your mouse to drag it to the desired location.
4747

4848
## Edit or delete a custom Insight status
4949

50-
On the **Statuses** page, you can edit or delete any of the custom Insight statuses that have been created. 
50+
On the **Insight Statuses** tab, you can edit or delete any of the custom Insight statuses that have been created. 
5151

5252
The edit and delete icons are only available for custom statuses.
5353

docs/cse/automation/about-automation-service-and-cloud-siem.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Before you can access the Automation Service from Cloud SIEM, you must first [co
4747

4848
1. To access the Automation Service from Cloud SIEM:
4949
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Integrations** select **Automation**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Integrations** select **Automation**. You can also click the **Go To...** menu at the top of the screen and select **Automation**. <br/>The list of available Cloud SIEM automations appears. Each automation runs a playbook.<br/><img src={useBaseUrl('img/cse/automations-automations-list.png')} alt="Automations list" style={{border: '1px solid gray'}} width="800"/>
50-
1. At the top of the screen, click **Manage Playbooks**.<br/><img src={useBaseUrl('img/cse/automations-manage-playbooks.png')} alt="Manage Playbooks menu option" width="400"/> <br/>The Automation Service screen displays: <br/><img src={useBaseUrl('img/cse/automations-playbook-list.png')} alt="Automation Playbook list" style={{border: '1px solid gray'}} width="800"/>
50+
1. At the top of the screen, click **Manage Playbooks**.<br/><img src={useBaseUrl('img/cse/automations-manage-playbooks.png')} alt="Manage Playbooks menu option" width="300"/> <br/>The Automation Service screen displays: <br/><img src={useBaseUrl('img/cse/automations-playbook-list.png')} alt="Automation Playbook list" style={{border: '1px solid gray'}} width="800"/>
5151
:::note
5252
You can also launch the Automation Service by selecting **Automation** from the main menu: <br/><img src={useBaseUrl('img/cse/automation-menu-in-nav-bar.png')} alt="Automation menu option in the nav bar" style={{border: '1px solid gray'}} width="200"/> <br/>If you also have Cloud SOAR installed, a **Cloud SOAR** option appears instead, since all automation services are provided by Cloud SOAR when it installed in conjunction with Cloud SIEM.
5353
:::

docs/cse/automation/automations-in-cloud-siem.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,10 @@ Now that the playbook is configured, you can add it to an automation.
5555

5656
1. [Create a new automation](#create-an-automation).
5757
1. Select the playbook you created in Step 2.
58-
1. In **Expects attributes for**, select **Entity** or **Insight**.
58+
1. In **Object (expects attributes for)**, select **Entity** or **Insight**.
5959
1. Select whether you want to automatically run the automation when an Insight is created or closed, or to run it manually. (For the purposes of this overview, select **Manually Done**.)
6060
1. Select **Enabled**.
61-
1. Click **Add to List**.
61+
1. Click **Save**.
6262

6363
### Step 4: Run the automation
6464

@@ -92,13 +92,12 @@ To view the automations that have run on Insights or Entities, see [View results
9292
The following procedure provides a brief introduction to how to create an automation. For detailed examples, see [Cloud SIEM Automation Examples](/docs/cse/automation/cloud-siem-automation-examples/).
9393

9494
1. [**Classic UI**](/docs/cse/introduction-to-cloud-siem/#classic-ui). In the top menu select **Configuration**, and then under **Integrations** select **Automation**. <br/>[**New UI**](/docs/cse/introduction-to-cloud-siem/#new-ui). In the top menu select **Configuration**, and then under **Cloud SIEM Integrations** select **Automation**. You can also click the **Go To...** menu at the top of the screen and select **Automation**.
95-
1. At the top of the automations screen, click **Create**. (To modify an existing automation, click on the edit icon for the corresponding automation.)<br/><img src={useBaseUrl('img/cse/automations-automations-list.png')} alt="Automations list" style={{border: '1px solid gray'}} width="800"/>
96-
1. In the **New Automation** dialog, select a **Playbook** from the drop-down list. The playbook must be defined before associating it with an automation. <br/><img src={useBaseUrl('img/cse/automations-new.png')} alt="New Automation" style={{border: '1px solid gray'}} width="400"/>
97-
1. In **Expects attributes for** select whether the playbook will run on an **Entity** or **Insight**. This defines what data payload will be sent to the playbook from Cloud SIEM.
98-
1. If **Entity** is selected, in the **Type** field select one or more Entity types. The playbook will only execute on the Entity types selected.
99-
1. Select one or more **Executes when** Insight triggers: **Insight Created**, **Insight Closed**, or **Manually Done**. If **Manually Done** is not selected, the automation will not appear in any **Actions** menu on Insights or **Automations** menus on Entities.
95+
1. At the top of the **Automation** tab, click **+ Add Automation**. (To modify an existing automation, select the automation and click **Edit**.)<br/><img src={useBaseUrl('img/cse/automations-automations-list.png')} alt="Automations list" style={{border: '1px solid gray'}} width="800"/>
96+
1. In the **Add Automation** dialog, select a **Playbook** from the drop-down list. The playbook must be defined before associating it with an automation. <br/><img src={useBaseUrl('img/cse/automations-new.png')} alt="New Automation" style={{border: '1px solid gray'}} width="400"/>
10097
1. Set the **Status**. Disabled automations will not run automatically and will not appear in any **Actions** or **Automations** menus.
101-
1. Click **Add to List** (or **Update** if editing an existing automation).
98+
1. In **Object (xpects attributes for)** select whether the playbook will run on an **Entity** or **Insight**. This defines what data payload will be sent to the playbook from Cloud SIEM. If **Entity** is selected, in the **Type** field select one or more Entity types. The playbook will only execute on the Entity types selected.
99+
1. For **Execution** select when the automation runs: **Insight Created**, **Insight Closed**, or **Manually Done**. If **Manually Done** is not selected, the automation will not appear in any **Actions** menu on Insights or **Automations** menus on Entities.
100+
1. Click **Save**.
102101

103102
## Run an automation automatically
104103

0 commit comments

Comments
 (0)