Skip to content

Commit c6fe917

Browse files
committed
Finish testing new playbook procedure
1 parent 6850960 commit c6fe917

File tree

7 files changed

+34
-39
lines changed

7 files changed

+34
-39
lines changed

docs/platform-services/automation-service/intro-to-automation-service.md

Lines changed: 34 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -126,62 +126,57 @@ Let’s use the Automation Service to create a playbook for use in Cloud SIEM.
126126
1. Use the following parameters to configure the node. If a field is not listed, keep the default value. Make sure you fill out the listed configuration fields in order, as some fields will only appear in the dialog box after you’ve selected fields above it.
127127
* **Name**. Type "Get Insight Details".
128128
* **Integration**. Sumo Logic Cloud SIEM
129-
* **Type**. Enrichment
130-
* **Action**. Get Insight
131-
* **Insight ID**. Insight ID<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-add-node.png')} alt="Add node" style={{border: '1px solid gray'}} width="500" />
129+
* **Type**. **Enrichment**
130+
* **Action**. **Get Insight**
131+
* **Insight ID**. Click the gear icon and select **Playbook inputs** and then **input.readableId**.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-add-node.png')} alt="Add node" style={{border: '1px solid gray'}} width="500" />
132132
1. Click **Create** when finished.
133133
1. Add another action to the playbook by hovering your mouse over the **Get Insight Details** node you just created and clicking the **+** icon. <br/><img src={useBaseUrl('img/platform-services/automation-service/intro-add-new-node.png')} alt="Add another node" style={{border: '1px solid gray'}} width="500" />
134134
1. Choose the **Action** node tpe.
135135
1. In the **Add Node** dialog box, use the parameters outlined below:
136136
* **Name**. Type "Get VirusTotal Info".
137-
* **Integration**. VirusTotal V3
138-
* **Type**. Enrichment
139-
* **Action**. IP Reputation
140-
* **IPs**. Click the cog icon on the right, and select the "Get Insight Details" action. Then find the "output.entity.ip.address" field and select it.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-get-virus-total-node.png')} alt="Add Virus Total node" style={{border: '1px solid gray'}} width="600" />
137+
* **Integration**. **VirusTotal V3**
138+
* **Type**. **Enrichment**
139+
* **Action**. **IP Reputation**
140+
* **IPs**. Click the gear icon and select **Playbook inputs** then **input.entity.value**.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-get-virus-total-node.png')} alt="Add Virus Total node" style={{border: '1px solid gray'}} width="500" />
141141
1. Click **Create** to save the new action.
142142
1. Add another action to the playbook by clicking the **+** icon on the **Get Virus Total Info** node you just created. Use the parameters outlined below:
143143
* **Name**. Type "Add Entity Enrichment".
144-
* **Integration**. Sumo Logic Cloud SIEM
145-
* **Type**. Notification
146-
* **Action**. Add Entity Enrichment
147-
* **Entity ID**. Click the cog icon and select "Get Insight Details" and "output.entity.id".
144+
* **Integration**. **Sumo Logic Cloud SIEM**
145+
* **Type**. **Notification**
146+
* **Action**. **Add Entity Enrichment**
147+
* **Entity ID**. Click the gear icon and select **Get Insight Details** and **output.entity.id**.
148148
* **Enrichment Title**. Type "VirusTotal IP Reputation".
149-
* **Enrichment**. Click the cog icon and select "Get VirusTotal Info" and "output.raw".<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-add-entity-enrichment-node.png')} alt="Add entity enrichment node" style={{border: '1px solid gray'}} width="600" />
149+
* **Enrichment**. Click the gear icon and select **Get VirusTotal Info** and **output.raw**.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-add-entity-enrichment-node.png')} alt="Add entity enrichment node" style={{border: '1px solid gray'}} width="500" />
150150
1. Click **Create** to save the action.
151151
1. Playbooks also allow "condition" nodes that can switch execution branches depending on the true/false results of a given expression. Let’s add a condition node to our playbook that will differentiate the execution branch depending on the severity of the insight.
152152
1. Hover your mouse over your last action (the blue **Add Entity Enrichment** action) and click the **+** icon.
153153
1. Choose a **Condition** node.
154154
1. Click **Create**.
155155
1. Hover your mouse over the new condition node and click the pencil icon to edit it.
156156
1. For the top **Select a value**, select **Get Insight Details** and the **output.severity** option. Make sure **==** is selected in the middle row.
157-
1. For the bottom **Select a value** field, add a manual value: **High**.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-condition.png')} alt="Add condition node" style={{border: '1px solid gray'}} width="400" />
157+
1. For the bottom **Select a value** field, add a manual value: **HIGH**.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-condition.png')} alt="Add condition node" style={{border: '1px solid gray'}} width="400" />
158158
1. . Click **Update** to save the condition node.
159-
1. Click the ‘plus’ icon under the condition node to create a new node. Select "Action" for this new node.
160-
1. Set the Name for this action to "Send Notification Email".
161-
1. . For the Integration, select "Basic Tools". Set Type to be "Notification" and Action to be "Send Email".
162-
1. . For Recipients, enter an email address (real or fake). Make sure you hit Enter after typing the email address to signal the Recipients field to parse and accept the email address.
163-
1. Type in a subject into the Subject field "High Severity Insight detected".
164-
1. When composing content for an email notification, you have the option of using input parameters from earlier nodes in the playbook in addition to any desired custom text. Click on the "{ }" icon to add a parameter field to your HTML Content (Body) text.
165-
166-
27. Click on the red parameter box that appears and select a source for the desired input parameter (for instance: "Insight.Severity" or "Get Insight Details.output.name"). The parameter box will turn green once you have selected a valid source parameter. You can add custom text before or after the source parameter.
167-
168-
28. Add one or more source parameters and accompanying custom text to outline what you want the email to say (for instance, explain that a high severity insight has been detected with the following details: name, timestamp, etc).
169-
170-
29. Click Create when finished with this action.
171-
172-
30. When you’ve created your final node(s) for your playbook, manually drag the mouse cursor from the gray connection circle on the right side of the Email Notification node to the left connection area of the "End" node. Drag and connect the "failure" end of the condition node to the End node as well.
173-
174-
31. Verify that the Start > End node sequence for all branches have been completed – it will look more or less like the screenshot below. (Note that you can always drag playbook elements anywhere in the playbook canvas for clarity or organization).
175-
176-
<img src={useBaseUrl('img/platform-services/automation-service/intro-completed-playbook.png')} alt="Completed playbook" style={{border: '1px solid gray'}} width="700" />
177-
178-
32. Click the disk (Save) icon at the bottom to save your playbook.
179-
180-
33. You can test your playbook before publishing by going to the "triple dot" icon in the upper right corner and selecting "Run Test".
181-
182-
34. After testing and troubleshooting playbook details (if needed), click the "Publish" (clipboard) icon next to the edit/pencil icon to publish your playbook. (You can add a description here if you wish)
183-
184-
Congrats! You have successfully created a playbook in Sumo Logic's Automation Service!
159+
1. Click the **+** icon under the condition node to create a new node.
160+
1. Select **Action** for this new node.
161+
1. For **Node name** type "Send Notification Email".
162+
1. . For the **Integration**, select **Basic Tools**. Set **Type** to be **Notification** and **Action** to be **Send Email**.
163+
1. . For **Recipients**, enter an email address (real or fake). Make sure you press Enter after typing the email address to signal the **Recipients** field to parse and accept the email address.
164+
1. Type in in the **Subject** field "High severity insight detected".
165+
1. When composing content for an email notification, you have the option of using input parameters from earlier nodes in the playbook in addition to any desired custom text. Click on the **{ }** icon to add a parameter field to your **HTML Content (Body)** text.
166+
1. Click on the red parameter box that appears and select a source for the desired input parameter (for instance, **Get Insight Details.output.name**). The parameter box will turn green once you have selected a valid source parameter. You can add custom text before or after the source parameter. Add one or more source parameters and accompanying custom text to outline what you want the email to say. For instance, explain that a high severity insight has been detected with the following details: name, timestamp, etc.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-notification-email.png')} alt="Add notification email node" style={{border: '1px solid gray'}} width="500" />
167+
1. Click **Create** when finished with this action.
168+
1. When you’ve created your final nodes for your playbook, manually drag the mouse cursor from the gray connection circle on the right side of the **Send Notification Email** node to the left connection area of the **End** node. Drag and connect the "failure" end of the condition node to the End node as well.
169+
1. Verify that the **Start > End** node sequence for all branches have been completed. It will look more or less like the screenshot below. (Note that you can always drag playbook elements anywhere in the playbook canvas for clarity or organization).<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-completed-playbook.png')} alt="Completed playbook" style={{border: '1px solid gray'}} width="800" />
170+
1. At the bottom of the screen, click the **Publish** (clipboard) icon next to the **Edit** (pencil) icon to publish your playbook. (You can add a description here if you want.)
171+
1. Toggle the playbook from **Enabled** to **Disabled**. (You don't want this playbook to automatically run. It's only for manual testing purposes.)
172+
1. Test your playbook:
173+
1. Search in Cloud SIEM for an insight with "HIGH" severity and copy the insight ID.
174+
1. In your playbook, go to the kebab icon in the upper right corner and select **Run Test**.
175+
1. For **Input** select **Insight** and in **ID** enter the insight ID.
176+
1. Click **Run**.<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-test-playbook.png')} alt="Test playbook" style={{border: '1px solid gray'}} width="500" />
177+
1. The playbook runs. If errors occur, click the nodes with errors and [troubleshoot the playbook](/docs/platform-services/automation-service/automation-service-playbooks/#troubleshoot-playbooks).<br/><img src={useBaseUrl('img/platform-services/automation-service/intro-test-playbook-results.png')} alt="Test playbook results" style={{border: '1px solid gray'}} width="800" />
178+
179+
Congratulations. You have now successfully created a playbook in Sumo Logic's Automation Service.
185180

186181
## Create a custom automation
187182

37.3 KB
Loading
-92.4 KB
Loading
19.3 KB
Loading
262 KB
Loading
191 KB
Loading
36.8 KB
Loading

0 commit comments

Comments
 (0)