This is a reference page for service providers managing customer Workspaces. For setting up the Defender integration itself, see Microsoft Defender for Endpoint Module and the Microsoft Defender Capability Matrix.
Part 1: Defender’s Native Automations
Microsoft Defender ships three distinct automation mechanisms. They trigger on different signals, act at different layers, and sit at opposite ends of the severity spectrum. Understanding which is which is the key to understanding how ContraForce coordinates with each.AIR
Automated Investigation and Response. Investigates alerts of specific types and applies or queues remediation. Frequently auto-resolves benign incidents.
ZAP
Zero-hour Auto Purge. Retroactively quarantines or junks malicious mail already sitting in the mailbox, up to 48 hours after delivery.
Attack Disruption
Automatic Attack Disruption. Contains active, high-confidence attacks at machine speed, without waiting for approval.
Automated Investigation and Response (AIR)
AIR is triggered by alert type, not by incident severity. Defender launches an automated investigation when it sees alerts such as suspicious email, attachment, or URL activity; compromised-account signals; Zero-hour Auto Purge actions; user submissions (user-reported phishing); user-click alerts; and suspicious mailbox behavior. An analyst can also start an investigation manually. Which alerts launch an investigation is driven by Defender’s Threat-management alert policies, specifically those with Automated investigation = Yes. Once running, an investigation produces findings and recommended actions. Whether Defender applies remediation automatically or holds it for analyst approval depends on the tenant’s automation level: full automation remediates automatically, while semi-automation queues actions in the Action Center for approval.AIR frequently auto-resolves benign incidents. When an investigation finds no threat, Defender resolves the incident on its own. Microsoft notes this is a common outcome in user-submission scenarios, where a user reports a message as phishing and the investigation clears it. This is exactly the pattern ContraForce’s settling window is designed for (see Part 2).
A Defender product change that does not affect the integration. As of 2026-09-01, Microsoft is folding the standalone Defender for Endpoint AIR investigation experience into the default protection stack; it will no longer run as a separate investigation experience or be available for manual triggering in Defender for Endpoint. ContraForce reads incident and alert state, not AIR investigation objects, so this transition does not change how the integration behaves. AIR capabilities for Defender for Office 365 remain available.
Zero-hour Auto Purge (ZAP), Defender for Office 365
ZAP retroactively neutralizes phishing, spam, and malware email, and Microsoft Teams messages, that were already delivered to cloud mailboxes. Because spam and malware signatures update continuously, a message that was clean at delivery can be re-judged as malicious afterward. ZAP acts on that message up to 48 hours after delivery, across all cloud mailboxes. It is on by default for high-confidence phishing and malware. The action ZAP takes depends on the verdict and on the tenant’s anti-spam, anti-malware, and anti-phishing policies: it may quarantine the message or move it to Junk Email. Like AIR, ZAP is driven by verdict and policy, not by incident severity.Automatic Attack Disruption (Defender XDR)
Automatic Attack Disruption correlates signals across Defender XDR into a single high-confidence incident for active, sophisticated attacks: ransomware campaigns, business email compromise, and adversary-in-the-middle. It operates at the incident level and is inherently high severity. This is the opposite end of the spectrum from AIR’s benign auto-resolutions. When Attack Disruption fires, it contains the attack automatically, without approval, regardless of the tenant’s automation-level settings. Its response actions include: contain device, contain IP, isolate device, disable user (including Entra-only cloud-native accounts), revoke user sessions, and OAuth app containment. You can recognize an attack-disruption incident by several signals: the Attack Disruption incident tag in the queue and on the incident page, a (attack disruption) suffix appended to the incident title, the actions listed in the Action Center, and the DisruptionAndResponseEvents advanced-hunting table.Comparison at a Glance
Part 2: How ContraForce Complements Defender’s Automations
ContraForce assumes Defender’s automations are running and coordinates around them in two ways: it makes their status visible to you per Workspace, and it makes the Security Delivery Agent automation-aware at dispatch time so the agent does not investigate an incident Defender already closed.Visibility: The Defender XDR Module Configuration Tab
The Defender XDR module’s Configuration tab gives you a per-Workspace read on what Defender is actually doing, so you are not guessing whether a customer’s automations are on.Native Automations card
A per-mechanism status for AIR, ZAP, and Attack Disruption:
- Active, with an observed count and recency
- Not observed, meaning licensed (or licensing unknown) but no events in the probe window
- Not licensed, asserted only when the license read succeeded and the SKU is absent
- Before any probe has run, the card is empty and prompts you to click Run detection
Detected Products card
Two views of the customer’s Defender footprint side by side:
- License truth: which Defender products the Workspace is licensed for
- Signal truth: which products are actually emitting alerts
An Automation-Aware Security Delivery Agent
The Security Delivery Agent is built to defer to Defender’s own automation at dispatch time. Two behaviors keep it from spending an investigation on work Defender already did.“Not observed” does not disable the settling window. Absence of evidence is not evidence of absence, so a mechanism the probe did not observe is still treated as possibly active. The gate stays conservative rather than assuming an automation is off.
1
Pre-dispatch skip: never act on an incident Defender already handled
Immediately before dispatching the agent, ContraForce re-checks the live Defender incident state. If the incident was resolved by AIR, or was merged or redirected into another incident, the agent is skipped entirely: no investigation runs, no agent compute is spent, and a skipped: handled by Defender automation entry is written to the Workspace activity log for auditability. You keep a clear record of why the agent stood down.
2
Adaptive settling window: give AIR time to auto-resolve quiet incidents
For low and informational severity Defender XDR incidents, ContraForce briefly holds the incident before running the agent, giving Defender’s AIR a chance to auto-resolve it first (the common outcome for user-reported phishing). The length of the hold is derived per Workspace from how quickly that tenant’s incidents actually auto-resolve, bounded to between 5 and 30 minutes. Medium and high severity incidents, and attack-disruption incidents, are never delayed: the agent engages immediately.The window is set automatically from the probe. There is no manual override: the Native Automations card displays the current value as a read-only chip so you can see what the agent is waiting for.
Not yet covered: ZAP dedup and containment guards at action time. Both coordination points below are on the roadmap but are not implemented today. Neither the agent nor a Gamebook currently re-checks ZAP or Defender containment state before proposing a response action:
- ZAP. Because ZAP acts up to 48 hours after delivery, an email remediation can be proposed for a message Defender already purged. ContraForce detects whether ZAP is active in the tenant, but does not check individual messages at action time.
- Attack-disruption containment. ContraForce does not block an action against an entity Defender has already contained.
Guidance for Service Providers
Confirm what is licensed before you rely on it
Confirm what is licensed before you rely on it
Use the Detected Products card to confirm which Defender automations a customer is actually licensed for before you count on them to handle a class of incidents. A “licensed but no signal” gap means an automation you expect to fire may not be.Check that
Organization.Read.All is consented first. Without it there is no license truth, and the gap list is suppressed rather than populated, so it will look clean whether or not gaps exist.Re-run detection after a customer changes their Defender configuration
Re-run detection after a customer changes their Defender configuration
The probe does not refresh on a schedule. If a customer enables an automation, changes licensing, or onboards a new Defender product, the card keeps showing the previous reading until someone clicks Run detection. Check the Last detected timestamp before treating the card as current.
Know the division of labor across the three automations
Know the division of labor across the three automations
Each Defender automation is covered differently today:
- AIR auto-resolution is handled by the settling window plus the pre-dispatch skip.
- ZAP is detected for visibility only. There is no pre-action dedup at Gamebook time yet, so an email action can be proposed for a message ZAP already purged.
- Attack Disruption is never delayed and the agent engages immediately, but ContraForce does not block an action against an already-contained entity.
What This Means for You
- Defender’s automations run on their own terms. AIR triggers on alert type and often auto-resolves benign incidents; ZAP purges bad mail up to 48 hours after delivery; Attack Disruption contains live attacks without approval. None of the three keys off ContraForce incident severity except in the sense that Attack Disruption is inherently high severity.
- ContraForce coordinates at the incident level. The Configuration tab shows you what each automation is doing per Workspace, and the Security Delivery Agent defers to Defender through a pre-dispatch skip and an adaptive settling window.
- You save agent effort without losing coverage. Low and informational severity incidents get a chance to auto-resolve before the agent spends compute on them, while medium, high, and attack-disruption incidents are engaged immediately.
- Action-level coordination is not there yet. ZAP dedup and containment guards at Gamebook-action time are not implemented, so the Action Center remains the source of truth before running an email or containment action.
Related Documentation
Microsoft Defender for Endpoint Module
Consent the module and enable Defender data and response in ContraForce
Microsoft Defender Capability Matrix
Which ContraForce capabilities are available by Defender license tier
Configuring Security Delivery Agents
How the Security Delivery Agent runs on the incident queue
What are Gamebooks?
How Gamebook response actions work
Questions about how ContraForce coordinates with Microsoft Defender’s native automations? Contact us at support@contraforce.com.