How do you set up Attack simulation training in Microsoft 365?
Attack simulation training needs Microsoft 365 E5 or Defender for Office 365 Plan 2. In the Defender portal, open Email & collaboration > Attack simulation training, choose a technique such as Credential Harvest, pick a payload, target users, assign training and schedule the launch. Tell leadership first, measure reports as well as clicks, and never use results to punish staff.
On this page 8 sections
Microsoft 365 has a built-in phishing simulator that sends realistic but harmless lures, records who clicks or reports, and assigns short training. Used well, it shows where your people need help. Used badly, it teaches staff to hide mistakes. This guide covers licensing, every simulation technique, the setup wizard, reports, and how to run tests fairly.
Who can use Attack simulation training?
Microsoft says Attack simulation training "requires a Microsoft 365 E5 or Microsoft Defender for Office 365 Plan 2 license" (Microsoft Learn). Business Premium includes Plan 1, not Plan 2, so most small businesses need an add-on. See Defender for Office 365 Plan 1 vs Plan 2.
Two other options at the time of writing (October 2026):
- E3 trial subset. Microsoft offers E3 customers a trial with "the ability to use a Credential Harvest payload and the ability to select 'ISA Phishing' or 'Mass Market Phishing' training experiences." Nothing else is included.
- 90-day Plan 2 trial, from the trials hub in the Defender portal.
The tool is at Email & collaboration > Attack simulation training in the Defender portal (https://security.microsoft.com/attacksimulator).
Permissions
Use the narrowest Microsoft Entra role that fits:
| Role | What it allows |
|---|---|
| Attack Simulation Administrator | Create and manage all parts of simulation campaigns |
| Attack Payload Author | Create payloads only; can't launch simulations or view tenant reports |
| Security Reader or Security Operator | View simulations and reports, without editing |
| Security Administrator | Full access, plus other security settings |
There are no PowerShell cmdlets for Attack simulation training. Automation goes through the Microsoft Graph API.
Which attack techniques can you simulate?
Microsoft offers seven social engineering techniques. All except How-to Guide come from the MITRE ATT&CK framework (Microsoft Learn).
| Technique | What the user sees | When the user counts as compromised |
|---|---|---|
| Credential Harvest | A link to a fake sign-in page | Enters credentials |
| Malware Attachment | An attachment that would run code, such as a macro | Opens it and selects Enable Editing |
| Link in Attachment | An attachment containing a link to a sign-in page | Opens it, clicks and enters credentials |
| Link to Malware | A link to a file on a well-known file-sharing site | Clicks and enters credentials |
| Drive-by URL | A link to a site that tries to run background code | Clicks the link (a click alone counts) |
| OAuth Consent Grant | A link that asks the user to grant an app access to data | Accepts the permissions prompt |
| How-to Guide | A teaching message, such as how to report phishing | Not a test |
The compromise definitions come from Microsoft's reporting documentation. Credential Harvest, Link to Malware, Drive-by URL and OAuth Consent Grant can use QR codes instead of links (Microsoft Learn), which is useful practice for QR code phishing. OAuth simulations map to the real attack in OAuth consent phishing.
What are payloads, login pages and landing pages?
- Payload: the simulated email, with its link or attachment. Microsoft provides many built-in payloads. You can copy and edit one, or write your own. Built-in payloads can't be edited directly.
- Login page: the fake sign-in page used by Credential Harvest and Link in Attachment payloads.
- Landing page: where users end up after they act on the payload, usually a short explanation.
- Payload automation: turns real phishing detected in Microsoft 365 into harmless simulations.
Each payload shows a predicted compromise rate, which uses data across Microsoft 365 to estimate the share of people likely to fall for it. Use it to pick a payload that's realistic rather than impossible.
Two content rules to know: payloads containing terms such as "IRS" or "Internal Revenue Service" are blocked, and Microsoft says customers remain responsible for deciding the appropriate use of any payload, including ones that show third-party brands (Microsoft Learn).
How do you launch a simulation?
Go to Attack simulation training > Simulations > Launch a simulation (Microsoft Learn):
- Select technique. Start with Credential Harvest; it's the most common real attack.
- Name and describe the simulation. You can Save and close as a draft at any point after this.
- Select a payload and login page. Choose one that matches lures your business really receives, such as a shared-document notice.
- Target users. Include everyone or choose specific users and groups. Microsoft finds Entra groups "easier to manage". Shared mailboxes aren't supported.
- Exclude users who shouldn't be tested, such as people on leave.
- Assign training. The default, Microsoft training experience (Recommended) with Assign training for me (Recommended), picks modules based on each user's history. You can choose modules yourself, redirect to your own training URL, or pick No training. The due date is 30 days after the simulation ends by default, or 15 or 7 days.
- Select a landing page.
- Select end user notifications: training assignment and reminder messages, plus an optional positive reinforcement notification for people who report the simulation.
- Launch details. Launch now or schedule. The simulation ends after two days by default, which is also the minimum, and you can set up to 30 days. Enable region aware time zone delivery sends messages during each user's working hours.
- Review, use Send a test to see the message yourself, then Submit.
Microsoft recommends that you "assign training for each simulation, as employees who go through training are less susceptible to similar attacks." Turn on positive reinforcement too. Thanking people who report is how you build the habit you actually want.
Things that break simulations
- Other security tools clicking links. Microsoft says email security applications, endpoint software, Outlook add-ins and automated triage playbooks can create false clicks and compromises. It recommends exempting all simulation URLs and domains in those tools, and notes "we don't send simulation messages from a static list of IP addresses."
- Browsers blocking simulation URLs. Google Safe Browsing may show "Deceptive site ahead" for some simulation URLs. Test the URL in your browsers first.
- Reporting mailbox detonation. If reported messages go to a custom mailbox without the right exclusions, Safe Links or Safe Attachments can detonate them and assign training to users who reported correctly. See user reported message settings.
- Audit logging off. Reports rely on the audit log. Microsoft says that if it's off, reports appear empty and training assignments are blocked.
Third-party simulation tools need a different setup, described in our guide to the advanced delivery policy for phishing simulations.
What do the reports show?
The Overview and Reports tabs summarize results, and the Attack simulation report gives detail (Microsoft Learn):
| Report | What it tells you |
|---|---|
| Simulation coverage | Share of users who have and haven't received a simulation |
| Training completion | Completed, in progress and incomplete training |
| Repeat offenders | Users compromised in consecutive simulations (two by default) |
| Behavior impact on compromise rate | Actual compromise rate compared with the predicted rate |
| Per-simulation report | Compromised users, users who reported, clicks, reads, deletes, replies and forwards |
Simulation data is kept for 18 months unless you delete it (Microsoft Learn). Two reporting details matter: simulation messages reported through non-Microsoft report buttons aren't counted, and on-premises mailboxes don't show read, forward, delete or report data.
The most useful number isn't the click rate. It's how many people reported the message, and how fast. A falling click rate can just mean easier payloads; a rising report rate means your team is acting as an early warning system.
How do you run simulations ethically?
The UK's National Cyber Security Centre warns about "unhelpful 'us vs them' scenarios that phishing simulations may engender, where staff may feel they are being tested by the security team" (NCSC). It also says training is "the layer that is often over-emphasised in phishing defences." Follow these rules:
- Tell leadership first. Agree the purpose, the schedule and who sees named results. Executives get phished too, so include them in the targets.
- Tell staff that simulations happen, in general terms. Don't announce dates.
- Never punish a click. No public lists, no disciplinary action, no performance reviews. People who fear blame stop reporting real attacks.
- Avoid cruel lures. Fake bonuses, layoffs, pay changes or health scares damage trust. Microsoft's payload restrictions and your HR team are a useful check.
- Celebrate reports. Use positive reinforcement notifications and mention good catches in team meetings.
- Limit who sees named data. Share aggregate results widely, individual results narrowly.
- Fix systems, not just people. If a payload fools half the company, ask why that kind of message reaches inboxes, and whether a process such as phoning to confirm bank changes would stop the real version.
Our guide to email security awareness training for small businesses covers building a reporting culture in more depth.
A simple first-year plan
- Month 1: send a How-to Guide simulation on reporting phishing. No test, just teaching.
- Month 2: run a Credential Harvest simulation with an easy payload, training assigned and positive reinforcement on.
- Every 2 to 3 months: rotate techniques: Link in Attachment, QR code, OAuth Consent Grant.
- Each time: review report rate, training completion and repeat offenders. Offer extra help, not penalties.
- Yearly: share an aggregate summary with leadership and adjust.
Next steps
- Check your license: Attack simulation training appears only with E5 or Plan 2.
- Write a one-page simulation policy with leadership and HR before the first launch.
- Exempt Microsoft's simulation URLs in any other security tools that scan links, so clicks are real.
- Make reporting easy with the built-in Report button, and keep real phishing out of inboxes. iBlockSpam filters phishing and spoofing at the MX; see how it works.
Browse our other setup guides.
Frequently asked questions
Which license do I need for Attack simulation training?
Microsoft 365 E5 or Defender for Office 365 Plan 2. Microsoft also offers E3 customers a limited trial that includes only a Credential Harvest payload and two training experiences. Business Premium includes Plan 1, so it doesn't include Attack simulation training unless you add Plan 2 licenses.
Does Microsoft store passwords that users type into a credential harvest simulation?
No. Microsoft's FAQ says anything entered on the credential harvest sign-in page is discarded silently, and only the click is recorded to capture the compromise event. Microsoft states that it doesn't collect, log or store the details users enter. Even so, tell users afterwards to treat any real password they typed as exposed by habit.
Why does a simulation show clicks from users who say they didn't click?
Usually another security tool opened the link. Microsoft lists email security applications, Outlook add-ins, endpoint security software and automated triage playbooks as common causes. Clicks a few seconds after delivery from an IP address that isn't yours or Microsoft's point to a scanner. Exempt Microsoft's simulation URLs and domains in those tools.
How long does Microsoft keep phishing simulation results?
18 months. Microsoft's FAQ lists simulation metadata, user activity in simulations and user activity in training as retained for 18 months unless an admin deletes the simulation first. If the whole tenant is deleted, Attack simulation training data is deleted after 90 days.
How long does a Microsoft phishing simulation run?
Between two and 30 days. On the Launch details page, the number of days to end the simulation defaults to two, which is also the minimum, and can be set up to 30. Microsoft stops capturing interaction after the end date you choose, though training events still update until the training due date.
Sources
- Microsoft Learn: Get started using Attack simulation training
- Microsoft Learn: Simulate a phishing attack with Attack simulation training
- Microsoft Learn: Reports for Attack simulation training
- Microsoft Learn: Attack simulation training deployment considerations and FAQ
- Microsoft Learn: Microsoft Defender for Office 365 data retention
- NCSC: Phishing attacks: defending your organisation
See how your domain measures up
Run a free Email Health Check: MX, SPF, DKIM, DMARC and transport security in one scan, with the raw records shown. No sign-up.
Keep reading
How do you set up the advanced delivery policy for phishing simulations in Microsoft 365?
Set up the Microsoft 365 advanced delivery policy for third-party phishing simulations and SecOps mailboxes: domains, sending IPs, URLs, limits and pitfalls.
9 min read Choosing a filterDefender for Office 365 Plan 1 vs Plan 2: which do you need?
What Exchange Online Protection includes, what Defender for Office 365 Plan 1 and Plan 2 add, which Microsoft 365 plans include each, and list prices.
9 min read Running email day to dayHow do you set up the Report button and user reported settings in Microsoft 365?
Set up the Outlook Report button in Microsoft 365: user reported settings, a reporting mailbox, reviewing reports on the Submissions page and sending users feedback.
10 min read