You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/sentinel/automate-responses-with-playbooks.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Automate threat response with playbooks in Microsoft Sentinel | Microsoft
3
3
description: This article explains automation in Microsoft Sentinel, and shows how to use playbooks to automate threat prevention and response.
4
4
author: yelevin
5
5
ms.topic: conceptual
6
-
ms.date: 02/21/2022
6
+
ms.date: 04/10/2022
7
7
ms.author: yelevin
8
8
ms.custom: ignite-fall-2021
9
9
---
@@ -74,14 +74,14 @@ Azure Logic Apps communicates with other systems and services using connectors.
74
74
75
75
-**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.
76
76
77
-
#### Two kinds of Logic Apps
77
+
#### Two types of Logic Apps
78
78
79
79
Microsoft Sentinel now supports two Logic Apps resource types:
80
80
81
81
-**Logic App (Consumption)**, based on the classic, original Logic Apps engine, and
82
82
-**Logic App (Standard)**, based on the new Logic Apps engine.
83
83
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.
85
85
86
86
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:
87
87
- Attach them to automation rules and/or analytics rules.
Copy file name to clipboardExpand all lines: articles/sentinel/tutorial-respond-threats-playbook.md
+75-10Lines changed: 75 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -70,29 +70,91 @@ Get a more complete and detailed introduction to automating threat response usin
70
70
71
71
Follow these steps to create a new playbook in Microsoft Sentinel:
72
72
73
+
# [Logic Apps Consumption](#tab/LAC)
73
74
### Prepare the playbook and Logic App
74
75
75
76
1. From the **Microsoft Sentinel** navigation menu, select **Automation**.
76
77
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**.
78
79
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.":::
80
81
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.
82
83
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":::
84
85
85
-
1.Enter your**Subscription**and **Resource group**, and give your playbook a name under **Logic app name**.
86
+
1.In the**Basics**tab:
86
87
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.
88
89
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**.
90
91
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.
92
93
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.
94
95
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.
96
158
97
159
1. Select the **Blank Logic App** template.
98
160
@@ -120,6 +182,9 @@ Every playbook must start with a trigger. The trigger defines the action that wi
120
182
> [!NOTE]
121
183
> 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).
122
184
185
+
186
+
---
187
+
123
188
### Add actions
124
189
125
190
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