Skip to content

Commit 9764d7d

Browse files
author
ecfan
committed
Fix references to integration service environment and naming
1 parent fda806e commit 9764d7d

File tree

2 files changed

+34
-20
lines changed

2 files changed

+34
-20
lines changed

articles/sentinel/automation/create-playbooks.md

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Playbooks are collections of procedures that can be run from Microsoft Sentinel
1919
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.
2020

2121
> [!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.
2323
2424
[!INCLUDE [unified-soc-preview](../includes/unified-soc-preview.md)]
2525

@@ -28,11 +28,11 @@ This article describes how to create and manage Microsoft Sentinel playbooks. Yo
2828
To create and manage playbooks, you need access to Microsoft Sentinel with one of the following Azure roles:
2929

3030
- **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
3232

3333
For more information, see [Microsoft Sentinel playbook prerequisites](automate-responses-with-playbooks.md#prerequisites).
3434

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.
3636

3737
## Create a playbook
3838

@@ -58,11 +58,16 @@ Follow these steps to create a new playbook in Microsoft Sentinel:
5858
- **Playbook with alert trigger**
5959
- **Playbook with entity trigger**
6060

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).
6262

63-
## Prepare your playbook's Logic App
63+
## Prepare your playbook's logic app
6464

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).
6671
6772
### [Consumption](#tab/consumption)
6873

@@ -74,23 +79,32 @@ Do the following to create your playbook:
7479

7580
1. In the **Basics** tab:
7681

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.
7883

7984
1. Enter a name for your playbook under **Playbook name**.
8085

8186
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.
8287

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).
8498
8599
1. Select **Next : Connections >**.
86100

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).
88102

89103
Select **Next : Review and create >** to continue.
90104

91105
1. In the **Review and create** tab, review the configuration choices you made, and select **Create and continue to designer**.
92106

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.
94108

95109
:::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":::
96110

@@ -111,7 +125,7 @@ After selecting the **Blank playbook** option, a new browser tab opens with the
111125
1. In the **Basics** tab, enter the following details:
112126

113127
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.
115129
1. For **Plan type**, select **Standard**.
116130
1. Select **Next : Hosting >**.
117131

@@ -127,35 +141,35 @@ After selecting the **Blank playbook** option, a new browser tab opens with the
127141
> [!NOTE]
128142
> This monitoring is **not required for Microsoft Sentinel** and **will cost you extra**.
129143
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**.
131145

132146
1. In the **Review + create** tab, review the configuration choices you made, and select **Create**.
133147

134148
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."
135149

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.
137151

138152
Unlike with classic Consumption playbooks, you're not done yet. Now you must create a workflow.
139153

140154
#### Create a workflow for your playbook
141155

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.
143157

144158
1. In the **New workflow** pane that appears:
145159

146160
1. Enter a meaningful name for your workflow.
147161
1. Under **State type**, select **Stateful**. Microsoft Sentinel doesn't support the use of stateless workflows as playbooks.
148162
1. Select **Create**.
149163

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.
151165

152166
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.
153167

154168
1. From the workflow details page, select **Designer**.
155169

156170
1. The **Designer** page opens and you're prompted to add a trigger and continue designing the workflow. For example:
157171

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":::
159173

160174
#### Add your trigger
161175

@@ -279,8 +293,8 @@ The **Active playbooks** tab shows your playbooks with the following details:
279293
|Column name |Description |
280294
|---------|---------|
281295
|**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. |
284298

285299
Select a playbook to open its Azure Logic Apps page, which shows more details about the playbook. On the Azure Logic Apps page:
286300

articles/sentinel/automation/logic-apps-playbooks.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,12 +52,12 @@ Microsoft Sentinel supports both *consumption* and *standard* Azure Logic Apps r
5252

5353
## Playbook authentications to Microsoft Sentinel
5454

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.
5656

5757
For more information, see [Authenticate playbooks to Microsoft Sentinel](../authenticate-playbooks-to-sentinel.md).
5858

5959
## Related content
6060

6161
- [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
6363
- [Create and manage Microsoft Sentinel playbooks](create-playbooks.md)

0 commit comments

Comments
 (0)