Azure Logic Apps for Microsoft Sentinel playbooks
Microsoft Sentinel playbooks are based on workflows built in Azure Logic Apps, a cloud service that helps you schedule, automate, and orchestrate tasks and workflows across systems throughout the enterprise. Microsoft Sentinel playbooks can take advantage of all the power and capabilities of the built-in templates in Azure Logic Apps.
Azure Logic Apps communicates with other systems and services using various types of connectors. Use the Microsoft Sentinel connector to create playbooks that interact with Microsoft Sentinel.
Note
Azure Logic Apps creates separate resources, so additional charges might apply. For more information, visit the Azure Logic Apps pricing page.
Microsoft Sentinel connector components
Within the Microsoft Sentinel connector, use triggers, actions, and dynamic fields to define your playbook's workflow:
| Component | Description |
|---|---|
| Trigger | A trigger is the connector component that starts a workflow, in this case, a playbook. A Microsoft Sentinel trigger defines the schema that the playbook expects to receive when triggered. The Microsoft Sentinel connector supports the following types of triggers: - Alert trigger: The playbook receives an alert as input. - Entity trigger: The playbook receives an entity as input. - Incident trigger: The playbook receives an incident as input, along with all the included alerts and entities. |
| Actions | Actions are all the steps that happen after the trigger. Actions can be arranged sequentially, in parallel, or in a matrix of complex conditions. |
| Dynamic fields | Dynamic fields are temporary fields that can be used in the actions that follow your trigger. Dynamic fields are determined by the output schema of triggers and actions, and are populated by their actual output. |
Azure Logic Apps also supports other types of connectors, such as managed connectors, which wrap around API calls, or custom connectors. For more information, see Azure Logic Apps connectors and their documentation and Create your own custom Azure Logic Apps connectors.
Supported logic app types
Microsoft Sentinel supports both Consumption and Standard logic apps:
Consumption: Runs in multitenant Azure Logic Apps, and uses the classic, original Azure Logic Apps engine.
Standard: Runs in single-tenant Azure Logic Apps, and uses a more recently designed Azure Logic Apps engine.
Standard resources offer higher performance, fixed pricing, multiple workflow capability, easier API connections management, built-in network capabilities and CI/CD features, and more. However, the following playbook functionality differs for Standard logic apps in Microsoft Sentinel:
Feature Description Creating playbooks Playbook templates aren't currently supported for Standard workflows, which means that you can't use a template to create your playbook directly in Microsoft Sentinel.
Instead, create your workflow manually in Azure Logic Apps to use it as a playbook in Microsoft Sentinel.Private endpoints If you're using Standard workflows with private endpoints, Microsoft Sentinel requires you to define an access restriction policy in Logic apps to support those private endpoints in any playbooks based on Standard workflows.
Without an access restriction policy, workflows with private endpoints might still be visible and selectable in Microsoft Sentinel, but running them will fail.Stateless workflows While Standard workflows support both stateful and stateless in Azure Logic Apps, Microsoft Sentinel doesn't support stateless workflows.
For more information, see Stateful and stateless workflows.
Playbook authentications to Microsoft Sentinel
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 for this purpose, with each resource type having its own connector.
For more information, see Authenticate playbooks to Microsoft Sentinel.
Related content
- Resource type and host environment differences in the Azure Logic Apps documentation
- Microsoft Sentinel connector for Azure Logic Apps in the Azure Logic Apps documentation
- Create and manage Microsoft Sentinel playbooks