Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊
Spycloud Conditional access playbook
| Attribute | Value |
|---|---|
| Type | Playbook |
| Solution | SpyCloud Enterprise Protection CCF |
| Source | View on GitHub |
This playbook uses 3 Logic App connectors / built-in actions:
| Connector / Action | Type | Connections | Actions |
|---|---|---|---|
azuresentinel |
Managed | 1 | 4 |
office365 |
Managed | 1 | 1 |
http |
Built-in | 0 | 7 |
azuresentinel (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Entities_-_Get_Accounts | post | /entities/account |
— |
| Add_comment_to_incident | post | /Incidents/Comment |
— |
| Add_comment_to_incident_-_Password_Latest | post | /Incidents/Comment |
— |
| Add_comment_to_incident_-_user_disable | post | /Incidents/Comment |
— |
office365 (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Send_an_email_-to_manager | post | /v2/Mail |
— |
http (Built-in)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Get_User_Details | GET | https://graph.microsoft.com/v1.0/users/@{concat(items('For_each')?['Name'],'@',items('For_each')?['UPNSuffix'])}?$select=id,displayName,accountEnabled,lastPasswordChangeDateTime,userPrincipalName |
— |
| Add_user_to_Conditional_Access_Group | POST | https://graph.microsoft.com/v1.0/groups/@{parameters('Azure_CA_Group_Object_ID')}/members/$ref |
— |
| HTTP_-_Disable_User | PATCH | https://graph.microsoft.com/v1.0/users/@{concat(items('For_each')?['Name'],'@',items('For_each')?['UPNSuffix'])} |
— |
| HTTP_-_Revoke_User_Sessions | POST | https://graph.microsoft.com/v1.0/users/@{concat(items('For_each')?['Name'],'@',items('For_each')?['UPNSuffix'])}/revokeSignInSessions |
— |
| Force_Password_Reset | PATCH | https://graph.microsoft.com/v1.0/users/@{concat(items('For_each')?['Name'],'@',items('For_each')?['UPNSuffix'])} |
— |
| GetAccessToken | POST | @concat(variables('loginUrl'), parameters('TenantID'), '/oauth2/v2.0/token') |
— |
| Log_ingestion | POST | @variables('log_ingestion_api') |
— |
This playbook automates Azure AD / Entra ID identity response actions when SpyCloud breach data identifies compromised user credentials.
Capabilities
SpyCloud_ConditionalAccessLogsV2_CLThe deployment also creates the Microsoft Sentinel automation rule that invokes this playbook, so no separate wiring step is needed. See Automation rule below.
SpyCloud_ConditionalAccessLogsV2_CL (Section 2.2)The solution template names its data collection rule SpyCloudwatchlist-DCR, but Microsoft Sentinel does not create it under that name. When you connect the data connector, Sentinel provisions the rule itself as Microsoft-Sentinel-SpyCloudwatchlist-DCR-<guid> and pairs it with an auto-generated asi-<guid> data collection endpoint. Searching for SpyCloudwatchlist-DCR in the portal will not find it, and if the connector has been connected more than once there will be several, only the most recent of which is in use.
Read both values from the live connector rather than hunting through the resource list:
SUB=<subscription-id>; RG=<resource-group>; WS=<workspace-name>
az rest --method get --url "https://management.azure.com/subscriptions/$SUB/resourceGroups/$RG/providers/Microsoft.OperationalInsights/workspaces/$WS/providers/Microsoft.SecurityInsights/dataConnectors?api-version=2023-02-01-preview" --query "value[?properties.dcrConfig] | [0].properties.dcrConfig.{immutableId: dataCollectionRuleImmutableId, endpoint: dataCollectionEndpoint}"
All four pollers share the same rule and endpoint, so any one of them gives the right answer. Grant the App Registration Monitoring Metrics Publisher on that same rule.
This deployment creates a Microsoft Sentinel automation rule alongside the Logic App, and Sentinel refuses to create an automation rule unless it already has permission to run playbooks in the target resource group. Without it the deployment fails with:
Missing required permissions for Microsoft Sentinel on the playbook resource '.../SpyCloud_Conditional_Access_Playbook'
Grant it once per resource group, before deploying either playbook:
az role assignment create \
--role "Microsoft Sentinel Automation Contributor" \
--assignee 98785600-1bb7-4fb9-b9fa-19afe2c8a360 \
--scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>
98785600-1bb7-4fb9-b9fa-19afe2c8a360 is the fixed application ID for Azure Security Insights. In the portal, use Access control (IAM) on the resource group → Add role assignment → Microsoft Sentinel Automation Contributor → search for Azure Security Insights.
This permission has always been required for the automation to work. It is now enforced at deployment time rather than allowing a rule to be created that silently never fires.
All settings are supplied at deployment time. There is no post-deployment parameter editing.
azuredeploy.json)office365 API connection created by the deployment| Parameter | Type | Default | Description |
|---|---|---|---|
| PlaybookName | String | SpyCloud_Conditional_Access_Playbook | Name of the Logic App resource |
| Notify_Users_Emails | String | — | Email address(es) for notifications, semicolon-separated |
| Force_Password_Reset_On_Next_SignIn | String | false | Forces password reset at next sign-in for affected users |
| Disable_User | String | false | Disables affected Entra ID user accounts |
| Add_User_To_Azure_CA_Group | String | false | Adds affected users to the Conditional Access enforcement group |
| Azure_CA_Group_Object_ID | String | — | Object ID of the Entra ID Conditional Access group |
| Revoke_User_Sessions | String | false | Revokes all active sign-in sessions for affected users |
| ClientID | String | — | App Registration Client ID |
| TenantID | String | — | Azure Tenant ID |
[Content truncated...]
Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊
↑ Back to Playbooks · Back to SpyCloud Enterprise Protection CCF