Skip to content

Commit 8f8ef67

Browse files
committed
Continued work 3
1 parent bca910f commit 8f8ef67

10 files changed

+78
-13
lines changed

articles/sentinel/automate-responses-with-playbooks.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Automate threat response with playbooks in Microsoft Sentinel | Microsoft
33
description: This article explains automation in Microsoft Sentinel, and shows how to use playbooks to automate threat prevention and response.
44
author: yelevin
55
ms.topic: conceptual
6-
ms.date: 02/21/2022
6+
ms.date: 04/10/2022
77
ms.author: yelevin
88
ms.custom: ignite-fall-2021
99
---
@@ -74,14 +74,14 @@ Azure Logic Apps communicates with other systems and services using connectors.
7474

7575
- **Dynamic fields:** Temporary fields, determined by the output schema of triggers and actions and populated by their actual output, that can be used in the actions that follow.
7676

77-
#### Two kinds of Logic Apps
77+
#### Two types of Logic Apps
7878

7979
Microsoft Sentinel now supports two Logic Apps resource types:
8080

8181
- **Logic App (Consumption)**, based on the classic, original Logic Apps engine, and
8282
- **Logic App (Standard)**, based on the new Logic Apps engine.
8383

84-
**Logic Apps Standard** features a single-tenant, containerized environment that provides fixed pricing, single apps containing multiple workflows, easier API connections management, native network capabilities such as virtual networking (VNet) and private endpoints support, built-in CI/CD features, better Visual Studio integration, a new version of the Logic Apps Designer, and more.
84+
**Logic Apps Standard** features a single-tenant, containerized environment that provides higher performance, fixed pricing, single apps containing multiple workflows, easier API connections management, native network capabilities such as virtual networking (VNet) and private endpoints support, built-in CI/CD features, better Visual Studio integration, a new version of the Logic Apps Designer, and more.
8585

8686
You can leverage this powerful new version of Logic Apps by creating new Standard workflows in the Logic Apps environment. These workflows will then be available to you as playbooks in Microsoft Sentinel, where you can use them the same ways you use legacy Logic App Consumption playbooks:
8787
- Attach them to automation rules and/or analytics rules.
41 KB
Loading
11.8 KB
Loading
52.7 KB
Loading
55.9 KB
Loading
34.2 KB
Loading
45 KB
Loading
-35.4 KB
Loading

articles/sentinel/tutorial-respond-threats-playbook.md

Lines changed: 75 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -70,29 +70,91 @@ Get a more complete and detailed introduction to automating threat response usin
7070

7171
Follow these steps to create a new playbook in Microsoft Sentinel:
7272

73+
# [Logic Apps Consumption](#tab/LAC)
7374
### Prepare the playbook and Logic App
7475

7576
1. From the **Microsoft Sentinel** navigation menu, select **Automation**.
7677

77-
1. On the top menu, select **Create** and **Add new playbook**.
78+
1. From the top menu, select **Create** and then, depending on which you want to create, either **Playbook with incident trigger** or **Playbook with alert trigger**.
7879

79-
:::image type="content" source="./media/tutorial-respond-threats-playbook/add-new-playbook.png" alt-text="Add a new playbook":::
80+
:::image type="content" source="./media/tutorial-respond-threats-playbook/add-new-playbook.png" alt-text="Add a new Consumption playbook.":::
8081

81-
A new browser tab will open and take you to the **Create a logic app** wizard.
82+
Either way, the **Create playbook** wizard will appear.
8283

83-
:::image type="content" source="./media/tutorial-respond-threats-playbook/create-playbook.png" alt-text="Create a logic app":::
84+
:::image type="content" source="./media/tutorial-respond-threats-playbook/create-playbook-LAC.png" alt-text="Create a logic app":::
8485

85-
1. Enter your **Subscription** and **Resource group**, and give your playbook a name under **Logic app name**.
86+
1. In the **Basics** tab:
8687

87-
1. For **Region**, select the Azure region where your Logic App information is to be stored.
88+
1. Select the **Subscription**, **Resource group**, and **Region** of your choosing from their respective drop-down lists. The chosen region is where your Logic App information will be stored.
8889

89-
1. If you want to monitor this playbook's activity for diagnostic purposes, mark the **Enable log analytics** check box, and enter your **Log Analytics workspace** name.
90+
1. Enter a name for your playbook under **Playbook name**.
9091

91-
1. If you want to apply tags to your playbook, click **Next : Tags >** (not connected to tags applied by automation rules. [Learn more about tags](../azure-resource-manager/management/tag-resources.md)). Otherwise, click **Review + Create**. Confirm the details you provided, and click **Create**.
92+
1. If you want to monitor this playbook's activity for diagnostic purposes, mark the **Enable diagnostics logs in Log Analytics** check box, and choose your **Log Analytics workspace** from the drop-down list.
9293

93-
1. While your playbook is being created and deployed (this will take a few minutes), you will be taken to a screen called **Microsoft.EmptyWorkflow**. When the "Your deployment is complete" message appears, click **Go to resource.**
94+
1. If your playbooks need access to protected resources that are inside or connected to an Azure virtual network, [you may need to use an integration service environment (ISE)](../logic-apps/connect-virtual-network-vnet-isolated-environment-overview.md). If so, mark the **Associate with integration service environment** check box, and select the desired ISE from the drop-down list.
9495

95-
1. You will be taken to your new playbook's [Logic Apps Designer](../logic-apps/logic-apps-overview.md), where you can start designing the workflow. You'll see a screen with a short introductory video and some commonly used Logic App triggers and templates. [Learn more](../logic-apps/logic-apps-create-logic-apps-from-templates.md) about creating a playbook with Logic Apps.
96+
1. Select **Next : Connections >**.
97+
98+
1. In the **Connections** tab:
99+
100+
Ideally you should leave this section as is, configuring Logic Apps to connect to Microsoft Sentinel with managed identity. [Learn about this and other authentication alternatives](authenticate-playbooks-to-sentinel.md).
101+
102+
Select **Next : Review and create >**.
103+
104+
1. In the **Review and create** tab:
105+
106+
Review the configuration choices you have made, and select **Create and continue to designer**.
107+
108+
1. Your playbook will take a few minutes to be created and deployed, after which you will see the message "Your deployment is complete" and you will be taken to your new playbook's [Logic App Designer](../logic-apps/logic-apps-overview.md), where you can start designing the workflow.
109+
110+
:::image type="content" source="media/tutorial-respond-threats-playbook/logic-app-blank-LAC.png" alt-text="Screenshot of logic app designer screen with opening trigger.":::
111+
112+
# [Logic Apps Standard](#tab/LAS)
113+
114+
### Prepare the Logic App and workflow
115+
116+
1. From the **Microsoft Sentinel** navigation menu, select **Automation**.
117+
118+
1. From the top menu, select **Create** and then **Blank playbook**.
119+
120+
:::image type="content" source="./media/tutorial-respond-threats-playbook/add-new-playbook.png" alt-text="Add a new Standard playbook.":::
121+
122+
A new browser tab will open and take you to the **Create Logic App** wizard.
123+
124+
:::image type="content" source="./media/tutorial-respond-threats-playbook/create-logic-app-basics.png" alt-text="Create a Standard logic app.":::
125+
126+
1. In the **Basics** tab:
127+
128+
1. Select the **Subscription** and **Resource Group** of your choosing from their respective drop-down lists.
129+
130+
1. Enter a name for your Logic App. For **Publish**, choose **Workflow**. Select the **Region** where you wish to deploy the logic app.
131+
132+
1. For **Plan type**, choose **Standard**.
133+
134+
1. Select **Next : Hosting >**.
135+
136+
1. In the **Hosting** tab:
137+
138+
1. For **Storage type**, choose **Azure Storage**, and choose or create a **Storage account**.
139+
140+
1. Choose a **Windows Plan**.
141+
142+
1. Select **Next : Monitoring >**.
143+
144+
1. In the **Monitoring** tab:
145+
146+
1. If you want to enable performance monitoring in Azure Monitor for this application, leave the toggle on Yes. Otherwise, toggle it to No.
147+
148+
> [!NOTE]
149+
> This monitoring is **not required for Microsoft Sentinel** and **will cost you extra**.
150+
151+
1. Select **Next : Review + create >**.
152+
153+
1. In the **Review + create** tab:
154+
155+
Review the configuration choices you have made, and select **Create**.
156+
157+
1. Your playbook will take a few minutes to be created and deployed, after which you will see the message "Your deployment is complete" and you will be taken to your new playbook's [Logic App Designer](../logic-apps/logic-apps-overview.md), where you can start designing the workflow. You'll see a screen with a short introductory video and some commonly used Logic App triggers and templates. [Learn more](../logic-apps/logic-apps-create-logic-apps-from-templates.md) about creating a playbook with Logic Apps.
96158

97159
1. Select the **Blank Logic App** template.
98160

@@ -120,6 +182,9 @@ Every playbook must start with a trigger. The trigger defines the action that wi
120182
> [!NOTE]
121183
> When you choose a trigger, or any subsequent action, you will be asked to authenticate to whichever resource provider you are interacting with. In this case, the provider is Microsoft Sentinel. There are a few different approaches you can take to authentication. For details and instructions, see [**Authenticate playbooks to Microsoft Sentinel**](authenticate-playbooks-to-sentinel.md).
122184
185+
186+
---
187+
123188
### Add actions
124189

125190
Now you can define what happens when you call the playbook. You can add actions, logical conditions, loops, or switch case conditions, all by selecting **New step**. This selection opens a new frame in the designer, where you can choose a system or an application to interact with or a condition to set. Enter the name of the system or application in the search bar at the top of the frame, and then choose from the available results.

0 commit comments

Comments
 (0)