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/automation/create-playbooks.md
+32-18Lines changed: 32 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ Playbooks are collections of procedures that can be run from Microsoft Sentinel
19
19
This article describes how to create and manage Microsoft Sentinel playbooks. You can later attach these playbooks to analytics rules or automation rules, or run them manually on specific incidents, alerts, or entities.
20
20
21
21
> [!NOTE]
22
-
> Playbooks in Microsoft Sentinel are based on workflows built in [Azure Logic Apps](/azure/logic-apps/logic-apps-overview), which means that you get all the power, customizability, and built-in templates of Logic Apps. Additional charges may apply. Visit the [Azure Logic Apps](https://azure.microsoft.com/pricing/details/logic-apps/) pricing page for more details.
22
+
> Playbooks in Microsoft Sentinel are based on workflows built in [Azure Logic Apps](/azure/logic-apps/logic-apps-overview), which means that you get all the power, customizability, and built-in templates of logic apps. Additional charges may apply. Visit the [Azure Logic Apps](https://azure.microsoft.com/pricing/details/logic-apps/) pricing page for more details.
@@ -28,11 +28,11 @@ This article describes how to create and manage Microsoft Sentinel playbooks. Yo
28
28
To create and manage playbooks, you need access to Microsoft Sentinel with one of the following Azure roles:
29
29
30
30
-**Logic App Contributor**, to edit and manage logic apps
31
-
-**Logic App operator**, to read, enable, and disable logic apps
31
+
-**Logic App Operator**, to read, enable, and disable logic apps
32
32
33
33
For more information, see [Microsoft Sentinel playbook prerequisites](automate-responses-with-playbooks.md#prerequisites).
34
34
35
-
We recommend that you read [Azure Logic Apps for Microsoft Sentinel playbooks](logic-apps-playbooks.md) before creating your playbook.
35
+
We recommend that you read [Azure Logic Apps for Microsoft Sentinel playbooks](../automation/logic-apps-playbooks.md) before creating your playbook.
36
36
37
37
## Create a playbook
38
38
@@ -58,11 +58,16 @@ Follow these steps to create a new playbook in Microsoft Sentinel:
58
58
-**Playbook with alert trigger**
59
59
-**Playbook with entity trigger**
60
60
61
-
For more information, see [Supported logic app types](logic-apps-playbooks.md#supported-logic-app-types) and [Supported triggers and actions in Microsoft Sentinel playbooks](playbook-triggers-actions.md).
61
+
For more information, see [Supported logic app types](../automation/logic-apps-playbooks.md#supported-logic-app-types) and [Supported triggers and actions in Microsoft Sentinel playbooks](playbook-triggers-actions.md).
62
62
63
-
## Prepare your playbook's Logic App
63
+
## Prepare your playbook's logic app
64
64
65
-
Select one of the following tabs for details about how to create a logic app for your playbook, depending on whether you're using a *Consumption* or *Standard* workflow. For more information, see [Supported logic app types](logic-apps-playbooks.md#supported-logic-app-types).
65
+
Select one of the following tabs for details about how to create a logic app for your playbook, depending on whether you're using a *Consumption* or *Standard* workflow. For more information, see [Supported logic app types](../automation/logic-apps-playbooks.md#supported-logic-app-types).
66
+
67
+
> [!TIP]
68
+
>
69
+
> If your playbooks need access to protected resources that are inside or connected to an Azure virtual network,
70
+
> [create a Standard logic app workflow instead](/azure/logic-apps/create-single-tenant-workflows-azure-portal).
66
71
67
72
### [Consumption](#tab/consumption)
68
73
@@ -74,23 +79,32 @@ Do the following to create your playbook:
74
79
75
80
1. In the **Basics** tab:
76
81
77
-
1. Select the **Subscription**, **Resource group**, and **Region** of your choosing from their respective drop-down lists. The selected region is where your Logic App information is stored.
82
+
1. Select the **Subscription**, **Resource group**, and **Region** of your choosing from their respective drop-down lists. The selected region is where your logic app information is stored.
78
83
79
84
1. Enter a name for your playbook under **Playbook name**.
80
85
81
86
1. If you want to monitor this playbook's activity for diagnostic purposes, select the **Enable diagnostics logs in Log Analytics** check box, and select your **Log Analytics workspace** from the drop-down list.
82
87
83
-
1. If your playbooks need access to protected resources that are inside or connected to an Azure virtual network, [you might need to use an integration service environment (ISE)](/azure/logic-apps/connect-virtual-network-vnet-isolated-environment-overview). If so, select the **Associate with integration service environment** check box, and select the relevant ISE from the drop-down list.
88
+
> [!NOTE]
89
+
>
90
+
> If the option exists to **Associate with integration service environment**, you can select this environment until August 31, 2024.
91
+
> However, Integration Service Environment (ISE) retires on August 31, 2024 and is longer available as a deployment environment,
92
+
> due to a dependency on Azure Cloud Services (classic), which retires at the same time.
93
+
>
94
+
> However, you can create and use a Standard logic app workflow, which runs in single-tenant Azure Logic Apps and provides the same
95
+
> capabilities as an ISE plus more. For example, Standard workflows support using private endpoints for inbound traffic so that your
96
+
> workflows can communicate privately and securely with virtual networks. Standard workflows also support virtual network integration
97
+
> for outbound traffic. For more information, see [Secure traffic between virtual networks and single-tenant Azure Logic Apps using private endpoints](/azure/logic-apps/secure-single-tenant-workflow-virtual-network-private-endpoint).
84
98
85
99
1. Select **Next : Connections >**.
86
100
87
-
1. In the **Connections** tab, we recommend leaving the default values, configuring Logic Apps to connect to Microsoft Sentinel with managed identity. For more information, see [Authenticate playbooks to Microsoft Sentinel](authenticate-playbooks-to-sentinel.md).
101
+
1. In the **Connections** tab, we recommend leaving the default values, configuring logic apps to connect to Microsoft Sentinel with managed identity. For more information, see [Authenticate playbooks to Microsoft Sentinel](authenticate-playbooks-to-sentinel.md).
88
102
89
103
Select **Next : Review and create >** to continue.
90
104
91
105
1. In the **Review and create** tab, review the configuration choices you made, and select **Create and continue to designer**.
92
106
93
-
Your playbook will take a few minutes to be created and deployed, after which you see the message "Your deployment is complete" and you're taken to your new playbook's [Logic App Designer](/azure/logic-apps/logic-apps-overview). The trigger you chose at the beginning is automatically added as the first step, and you can continue designing the workflow from there.
107
+
Your playbook will take a few minutes to be created and deployed, after which you see the message "Your deployment is complete" and you're taken to your new playbook's [designer in Azure Logic Apps](/azure/logic-apps/logic-apps-overview). The trigger you chose at the beginning is automatically added as the first step, and you can continue designing the workflow from there.
94
108
95
109
:::image type="content" source="../media/tutorial-respond-threats-playbook/logic-app-blank.png" alt-text="Screenshot of logic app designer screen with opening trigger." lightbox="../media/tutorial-respond-threats-playbook/logic-app-blank.png":::
96
110
@@ -111,7 +125,7 @@ After selecting the **Blank playbook** option, a new browser tab opens with the
111
125
1. In the **Basics** tab, enter the following details:
112
126
113
127
1. Select the **Subscription** and **Resource Group** of your choosing from their respective drop-down lists.
114
-
1. Enter a name for your Logic App. For **Publish**, select **Workflow**. Select the **Region** where you wish to deploy the logic app.
128
+
1. Enter a name for your logic app. For **Publish**, select **Workflow**. Select the **Region** where you wish to deploy the logic app.
115
129
1. For **Plan type**, select **Standard**.
116
130
1. Select **Next : Hosting >**.
117
131
@@ -127,35 +141,35 @@ After selecting the **Blank playbook** option, a new browser tab opens with the
127
141
> [!NOTE]
128
142
> This monitoring is **not required for Microsoft Sentinel** and **will cost you extra**.
129
143
130
-
1. Optionally, select **Next : Tags >** to apply tags to this Logic App for resource categorization and billing purposes. Otherwise, select **Review + create**.
144
+
1. Optionally, select **Next : Tags >** to apply tags to this logic app for resource categorization and billing purposes. Otherwise, select **Review + create**.
131
145
132
146
1. In the **Review + create** tab, review the configuration choices you made, and select **Create**.
133
147
134
148
Your playbook takes a few minutes to be created and deployed, during which you see some deployment messages. At the end of the process you're taken to the final deployment screen, where you see the message: "Your deployment is complete."
135
149
136
-
1. Select **Go to resource**. You're taken to the main page of your new Logic App.
150
+
1. Select **Go to resource**. You're taken to the main page of your new logic app.
137
151
138
152
Unlike with classic Consumption playbooks, you're not done yet. Now you must create a workflow.
139
153
140
154
#### Create a workflow for your playbook
141
155
142
-
1. From your Logic App's details page, select **Workflows > + Add**. It might take a few moments for the **+ Add** button to become active.
156
+
1. From your logic app's details page, select **Workflows > + Add**. It might take a few moments for the **+ Add** button to become active.
143
157
144
158
1. In the **New workflow** pane that appears:
145
159
146
160
1. Enter a meaningful name for your workflow.
147
161
1. Under **State type**, select **Stateful**. Microsoft Sentinel doesn't support the use of stateless workflows as playbooks.
148
162
1. Select **Create**.
149
163
150
-
Your workflow is saved and appears in the list of workflows in your Logic App.
164
+
Your workflow is saved and appears in the list of workflows in your logic app.
151
165
152
166
1. Select the new workflow to proceed and access your workflow details page. Here you can see all the information about your workflow, including a record of all the times it runs.
153
167
154
168
1. From the workflow details page, select **Designer**.
155
169
156
170
1. The **Designer** page opens and you're prompted to add a trigger and continue designing the workflow. For example:
157
171
158
-
:::image type="content" source="../media/tutorial-respond-threats-playbook/logic-app-standard-designer.png" alt-text="Screenshot of Logic App Standard designer." lightbox="../media/tutorial-respond-threats-playbook/logic-app-standard-designer.png":::
172
+
:::image type="content" source="../media/tutorial-respond-threats-playbook/logic-app-standard-designer.png" alt-text="Screenshot shows designer in Standard logic app workflow." lightbox="../media/tutorial-respond-threats-playbook/logic-app-standard-designer.png":::
159
173
160
174
#### Add your trigger
161
175
@@ -279,8 +293,8 @@ The **Active playbooks** tab shows your playbooks with the following details:
279
293
|Column name |Description |
280
294
|---------|---------|
281
295
|**Status**| Indicates if the playbook is enabled or disabled. |
282
-
|**Plan**| Indicates whether the playbook uses the *Standard* or *Consumption* Azure Logic Apps resource type. <br><br>Playbooks of the *Standard* type use the `LogicApp/Workflow` naming convention, which reflects how a Standard playbook represents a workflow that exists alongside other workflows in a single Logic App. <br><br>For more information, see [Azure Logic Apps for Microsoft Sentinel playbooks](logic-apps-playbooks.md). |
283
-
|**Trigger kind**| Indicates the Azure Logic Apps trigger that starts this playbook: <br><br>- **Microsoft Sentinel Incident/Alert/Entity**: The playbook is started with one of the Sentinel triggers, including incident, alert, or entity <br>- **Using Microsoft Sentinel Action**: The playbook is started with a non-Microsoft Sentinel trigger but uses a Microsoft Sentinel action <br>- **Other**: The playbook doesn't include any Microsoft Sentinel components <br>- **Not initialized**: The playbook was created, but contains no components, neither triggers no actions. |
296
+
|**Plan**| Indicates whether the playbook uses the *Standard* or *Consumption* Azure Logic Apps resource type. <br><br>Playbooks of the *Standard* type use the `LogicApp/Workflow` naming convention, which reflects how a Standard playbook represents a workflow that exists alongside other workflows in a single logic app. <br><br>For more information, see [Azure Logic Apps for Microsoft Sentinel playbooks](../automation/logic-apps-playbooks.md). |
297
+
|**Trigger kind**| Indicates the trigger in Azure Logic Apps that starts this playbook: <br><br>- **Microsoft Sentinel Incident/Alert/Entity**: The playbook is started with one of the Sentinel triggers, including incident, alert, or entity <br>- **Using Microsoft Sentinel Action**: The playbook is started with a non-Microsoft Sentinel trigger but uses a Microsoft Sentinel action <br>- **Other**: The playbook doesn't include any Microsoft Sentinel components <br>- **Not initialized**: The playbook was created, but contains no components, neither triggers no actions. |
284
298
285
299
Select a playbook to open its Azure Logic Apps page, which shows more details about the playbook. On the Azure Logic Apps page:
Copy file name to clipboardExpand all lines: articles/sentinel/automation/logic-apps-playbooks.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -52,12 +52,12 @@ Microsoft Sentinel supports both *consumption* and *standard* Azure Logic Apps r
52
52
53
53
## Playbook authentications to Microsoft Sentinel
54
54
55
-
Azure Logic Apps must connect separately and authenticate independently to each resource, of each type, that it interacts with, including to Microsoft Sentinel itself. Logic Apps uses [specialized connectors](/connectors/connector-reference/) for this purpose, with each resource type having its own connector.
55
+
Azure Logic Apps must connect separately and authenticate independently to each resource, of each type, that it interacts with, including to Microsoft Sentinel itself. Azure Logic Apps uses [specialized connectors](/connectors/connector-reference/) for this purpose, with each resource type having its own connector.
56
56
57
57
For more information, see [Authenticate playbooks to Microsoft Sentinel](../authenticate-playbooks-to-sentinel.md).
58
58
59
59
## Related content
60
60
61
61
-[Resource type and host environment differences](/azure/logic-apps/logic-apps-overview#resource-environment-differences) in the Azure Logic Apps documentation
62
-
-[Microsoft Sentinel Logic Apps connector](/connectors/azuresentinel/) in the Azure Logic Apps documentation
62
+
-[Microsoft Sentinel connector for Azure Logic Apps](/connectors/azuresentinel/) in the Azure Logic Apps documentation
63
63
-[Create and manage Microsoft Sentinel playbooks](create-playbooks.md)
0 commit comments