Simulation automations for Attack simulation training
Tip
Did you know you can try the features in Microsoft 365 Defender for Office 365 Plan 2 for free? Use the 90-day Defender for Office 365 trial at the Microsoft 365 Defender portal trials hub. Learn about who can sign up and trial terms here.
Applies to Microsoft Defender for Office 365 plan 2
In Attack simulation training in Microsoft 365 E5 or Microsoft Defender for Office 365 Plan 2, simulation automations allow you to run multiple benign cyberattack simulations in your organization. Simulation automations can contain multiple payloads and start on an automated schedule. Creating a simulation automation is very similar to creating an individual simulation, except you also select the payloads and the automation schedule.
For getting started information about Attack simulation training, see Get started using Attack simulation training.
To create a simulation automation, do the following steps:
In the Microsoft 365 Defender portal at https://security.microsoft.com/, go to Email & collaboration > Attack simulation training > Automations tab > Simulation automations.
To go directly to the Automations tab where you can select Simulation automations, use https://security.microsoft.com/attacksimulator?viewid=automations.
On Simulation automations, select
Create automation.
The creation wizard opens. The rest of this article describes the pages and the settings they contain.
Note
At any point during the simulation creation wizard, you can click Save and close to save your progress and continue configuring the simulation later. The incomplete simulation has the Status value Draft on the Simulations tab. You can pick up where you left off by selecting the simulation and clicking Edit simulation.## Name and describe the simulation.
Name and describe the simulation automation
On the Automation name page, configure the following settings:
- Name: Enter a unique, descriptive name for the simulation.
- Description: Enter an optional detailed description for the simulation.
When you're finished, click Next.
Select one or more social engineering techniques
On the Select social engineering techniques page, select one or more of the available social engineering techniques, which were curated from the MITRE ATT&CK® framework. Different payloads are available for different techniques. The following social engineering techniques are available:
- Credential harvest: Attempts to collect credentials by taking users to a well-known looking website with input boxes to submit a username and password.
- Malware attachment: Adds a malicious attachment to a message. When the user opens the attachment, arbitrary code is run that will help the attacker compromise the target's device.
- Link in attachment: A type of credential harvest hybrid. An attacker inserts a URL into an email attachment. The URL within the attachment follows the same technique as credential harvest.
- Link to malware: Runs some arbitrary code from a file hosted on a well-known file sharing service. The message sent to the user will contain a link to this malicious file, opening the file and helping the attacker compromise the target's device.
- Drive-by URL: The malicious URL in the message takes the user to a familiar-looking website that silently runs and/or installs code on the user's device.
- OAuth Consent Grant: The malicious URL asks users to grant permissions to data for a malicious Azure Application.
If you click the View details link in the description, a details flyout opens that describes the technique and the simulation steps that result from the technique.
When you're finished, click Next.
Select a payload and login page
On the Select payload and login page, you need to select an existing payload from the list, or create a new payload.
You can also view the login page that's used in the payload, select a different login page to use, or create a new login page to use.
Payload
On the Select payloads page, select one of the following options:
- Manually select
- Randomize
If you select Randomize, there's nothing to configure on this page, so click Next to continue.
If you select Manually select, you need to select one or more payloads from the list. The following details are shown for each payload:
- Payload name
- Technique: You need to select at least one payload per technique that you selected on the previous page.
- Language: The available values are: English, Spanish, German, Japanese, French, Portuguese, Dutch, Italian, Swedish, Chinese (Simplified), Norwegian Bokmål, Polish, Russian, Finnish, Korean, Turkish, Hungarian, Hebrew, Thai, Arabic, Vietnamese, Slovak, Greek, Indonesian, Romanian, Slovenian, Croatian, Catalan, or Other.
- Click rate: How many people have clicked on this payload.
- Predicted compromise rate: Historical data across Microsoft 365 that predicts the percentage of people who will be compromised by this payload (users compromised / total number of users who receive the payload).
- Simulations launched counts the number of times this payload was used in other simulations.
In the Search box, you can type part of the payload name and press Enter to filter the results.
If you click Filter, the following filters are available:
Complexity: Calculated based on the number of indicators in the payload that indicate a possible attack (spelling errors, urgency, etc.). More indicators are easier to identify as an attack and indicate lower complexity. The available values are:
- High
- Medium
- Low
Language
Add tag(s)
Filter by theme: The available values are: Account activation, Account verification, Billing, Clean up mail, Document received, Expense, Fax, Finance report, Incoming messages, Invoice, Items received, Login alert, Mail received, Password, Payment, Payroll, Personalized offer, Quarantine, Remote work, Review message, Security update, Service suspended, Signature required, Upgrade mailbox storage Verify mailbox, Voicemail, and Other.
Filter by brand: The available values are: American Express, Capital One, DHL, DocuSign, Dropbox, Facebook, First American, Microsoft, Netflix, Scotiabank, SendGrid, Stewart Title, Tesco, Wells Fargo, Syrinx Cloud, and Other.
Filter by industry: The available values are: Banking, Business services, Consumer services, Education, Energy, Construction, Consulting, Financial services, Government, Hospitality, Insurance, Legal, Courier services, IT, Healthcare, Manufacturing, Retail, Telecom, Real estate, and Other.
Current event: The available values are Yes or No.
Controversial: The available values are Yes or No.
When you're finished configuring the filters, click Apply, Cancel, or Clear filters.
If you select a payload from the list by clicking anywhere in the row other than the check box, details about the payload are shown in a flyout:
- The Payload tab contains an example and other details about the payload.
- The Login page tab is available only in Credential Harvest or Link in attachment payloads and is described in the next section.
- The Simulations launched tab contains the Simulation name, Click rate, Compromised rate, and Action.
Login page
Note
The Login page tab is available only in Credential Harvest or Link in attachment payloads.
Select the payload from the list by clicking anywhere in the row other than the check box to open the details flyout.
The Login page tab in the payload details flyout shows the login page that's currently selected for the payload.
To view the complete login page, use the Page 1 and Page 2 links at the bottom of the page for two-page login pages.
To change the login page that's used in the payload, click Change login page.
On the Select login page flyout that appears, The following information is shown for each login page:
- Name
- Language
- Source: For built-in login pages, the value is Global. For custom login pages, the value is Tenant.
- Status: Ready or Draft.
- Created by: For built-in login pages, the value is Microsoft. For custom login pages, the value is the UPN of the user who created the login page.
- Last modified
- Actions: Click
Preview to preview the login page.
To find a login page in the list, use the Search box to find the name of the login page.
Click Filter to filter the login pages by Source or Language.
To create a new login page, click Create new icon. Create new to start the create end user login page wizard. The steps are the same as at Login pages at Attack simulation training > Simulated content library tab. For instructions, see Create login pages.
Back on the Select login page, verify the new login page you created is selected, and then click Save.
Back on the payload details flyout, click Close icon. Close.
When you're finished on the Select a payload and login page, click Next.
Configure OAuth Payload
Note
This page is available only if you selected OAuth Consent Grant on the Select social engineering techniques page. Otherwise, you're taken to the Target users page.
On the Configure OAuth payload page, configure the following settings:
App name
App logo: Click Browse to select a .png, .jpeg, or .gif file to use. To remove a file after you've selected it, click Remove.
Select app scope: Choose one of the following values:
- Read user calendars
- Read user contacts
- Read user mail
- Read all chat messages
- Read all files that user can access
- Read and write access to user mail
- Send mail as a user
When you're finished on the Configure OAuth payload page, click Next.
Target users
On the Target users page, select who will receive the simulation. Configure one of the following settings:
Include all users in your organization: The affected users are show in lists of 10. You can use the Next and Previous buttons directly below the list of users to scroll through the list. You can also use the
Search icon on the page to find affected users.
Include only specific users and groups: Choose one of the following options:
Add users: In the Add users flyout that appears, you can find users and groups based on the following criteria:
Users or groups: In the
Search for users and groups box, you can type part of the Name or Email address of the user or group, and then press Enter. You can select some or all of the results. When you're finished, click Add x users.
Note
Clicking the Add filters button to return to the Filter users by categories options will clear any users or groups that you selected in the search results.
Filter users by categories: Select from none, some, or all of the following options:
- Suggested user groups: Select from the following values:
- All suggested user groups
- Users not targeted by a simulation in the last three months
- Repeat offenders
- Department: Use the following options:
- Search: In the
Search by Department box, you can type part of the Department value, and then press Enter. You can select some or all of the results.
- Select All Department
- Select existing Department values.
- Search: In the
- Title: Use the following options:
- Search: In the
Search by Title box, you can type part of the Title value, and then press Enter. You can select some or all of the results.
- Select All Title
- Select existing Title values.
- Search: In the
After you identify your criteria, the affected users are shown in the User list section that appears, where you can select some or all of the discovered recipients.
When you're finished, click Apply(x), and then click Add x users.
- Suggested user groups: Select from the following values:
Back on the main Target users page, you can use the
Search box to find affected users. You can also click
Delete to remove specific users.
Import: In the dialog that opens, specify a CSV file that contains one email address per line.
After you find and select the CSV file, the list of users are imported and shown on the Targeted users page. You can use the
Search box to find affected users. You can also click
Delete to remove specific users.
When you're finished, click Next.
Assign training
On the Assign training page, you can assign trainings for the simulation. We recommend that you assign training for each simulation, as employees who go through training are less susceptible to similar attacks. The following settings are available:
- Select training content preference: Choose one of the following options:
- Microsoft training experience: This is the default value that has the following associated options to configure:
- Select one of the following options:
- Assign training for me: This is the default and recommended value. We assign training based on a user's previous simulation and training results, and you can review the selections in the next steps of the wizard.
- Select training courses and modules myself: If you select this value, you'll still be able to see the recommended content as well as all available courses and modules in the next step of the wizard.
- Due date: Choose one of the following values:
- 30 days after simulation ends: This is the default value.
- 15 days after simulation ends
- 7 days after simulation ends
- Select one of the following options:
- Redirect to a custom URL: This value has the following associated options to configure:
- Custom training URL (required)
- Custom training name (required)
- Custom training description
- Custom training duration (in minutes): The default value is 0, which means there is no specified duration for the training.
- Due date: Choose one of the following values:
- 30 days after simulation ends: This is the default value.
- 15 days after simulation ends
- 7 days after simulation ends
- No training: If you select this value, the only option on the page is the Next button that takes you to the Landing page page.
- Microsoft training experience: This is the default value that has the following associated options to configure:
Training assignment
Note
The Training assignment page is available only if you selected Microsoft training experience > Select training courses and modules myself on the previous page.
On the Training assignment page, select the trainings that you want to add to the simulation by clicking Add trainings.
On the Add training flyout that appears, you can select the trainings to use on the following tabs that are available:
Recommended tab: Shows the recommended built-in trainings based on the simulation configuration. These are the same trainings that would have been assigned if you selected Assign training for me on the previous page.
All trainings tab: Shows all built-in trainings that are available.
The following information is shown for each training:
- Training name
- Source: The value is Global.
- Duration (mins)
- Preview: Click the Preview button to see the training.
In the
Search box, you can type part of the training name and press Enter to filter the results on the current tab.
Select all trainings that you want to include from the current tab, and then click Add.
Back on the main Training assignment page, the trainings that you selected are shown. The following information is shown for each training:
- Training name
- Source
- Duration (mins)
For each training in the list, select one or more of the following values in the Assign to column to configure who gets the training:
- All users
- Clicked payload
- Compromised
If you don't want to use a training that's shown, click Delete.
When you're finished, click Next.
Landing page
On the Landing page page, you configure the web page that users are taken to if they open the payload in the simulation.
Select landing page preference: The available values depend on your previous payload selections on the Select a payload and login page page as described in the following table:
Payload selection Available values for Select landing page preference Manually select Use Microsoft default landing page
Create your own landing pageUse a custom URL
Note: The Use a custom URL value is not available if you previously selected Malware attachment or Link to malware on the Select social engineering techniques page.
Randomize Use Microsoft default landing page The available Select landing page preference values and their associated settings are described in the following list:
Use Microsoft default landing page. This is the default value, and results in one Microsoft default template, logo, and payload indicator action that's applicable to all payloads.
You need to configure the following additional settings on the Landing page page:
Select landing page layout: Select one of the 5 available landing page templates.
Add logo: Click Browse to find and select a .png, .jpeg, or .gif file to add to all payloads that are selected by Microsoft. The logo size should be a maximum of 210 x 70 to avoid distortion. To remove the logo, click Remove.
Payload indicators: This setting is not available if you previously selected Malware attachment or Link to malware on the Select social engineering techniques page.
Select Add payload indicators to email to help users learn how to identify phishing messages.
You can preview the results by clicking the Open preview panel button in the middle of the page. In the preview flyout that appears, you can use Select payload to preview to see what each payload looks like.
Create your own landing page: This value results in a single payload indicator action that's applied to the selected payloads.
You need to configure the following additional settings on the Landing page page:
Add payload indicators to email: This setting is available to select only if both of the following statements are true:
- You selected Credential harvest, Link in attachment, Drive-by URL, or OAuth Consent Grant on the Select social engineering techniques page.
- You've added the Dynamic tag named Insert Payload content in the landing page content on this page.
Landing page content: Two tabs are available:
- Text: A rich text editor is available to create your landing page. In addition to the typical font and formatting settings, the following settings are available:
Dynamic tag: Select from the following tags:
Tag name Tag value Insert User name ${userName}
Insert First name ${firstName}
Insert Last name ${lastName}
Insert UPN ${upn}
Insert Email ${emailAddress}
Insert Department ${department}
Insert Manager ${manager}
Insert Mobile phone ${mobilePhone}
Insert City ${city}
Insert sender name ${FromName}
Insert sender email ${FromEmail}
Insert Payload subject ${EmailSubject}
Insert Payload content ${EmailContent}
Insert Date ${date|MM/dd/yyyy|offset}
Use from default: Select one of the 5 available landing page templates to start with. You can modify the text and layout in the editing area. To reset the landing page back to the default text and layout of the template, click Reset to default.
Training link: In the Name training URL dialog that appears, enter a link title for the training link, and then click Confirm to add the link to the landing page.
- Code: You can view and modify the HTML code directly.
You can preview the results by clicking the Open preview panel button in the middle of the page. In the preview flyout that appears, you can use Select payload to preview to see what each payload looks like.
- Text: A rich text editor is available to create your landing page. In addition to the typical font and formatting settings, the following settings are available:
Use a custom URL: Add the URL in the Enter the custom landing page URL box that appears. No other options are available on the page.
When you're finished, click Next.
Select end user notification
On the Select end user notification page, select from the following notification options:
Do not deliver notifications: Click Proceed in the alert dialog that appears. If you select this option, you're taken to the Simulation schedule page when you click Next.
Microsoft default notification (recommended): The following additional settings are available on the page:
Select default language: The available values are: Chinese (Simplified), Chinese (Traditional), English, French, German, Italian, Japanese, Korean, Portuguese, Russian, Spanish, and Dutch.
By default, the following notifications are included:
- Microsoft positive reinforcement notification
- Microsoft default training assignment notification
- Microsoft default training reminder notification
For each notification, the following information is available:
- Notifications: The name of the notification.
- Language: If the notification contains multiple translations, the first two languages are shown directly. To see the remaining languages, hover over the numeric icon (for example, +10).
- Type: One of the following values:
- Positive reinforcement notification
- Training assignment notification
- Training reminder notification
- Delivery preferences: For Positive reinforcement notification and Training reminder notification types, the following values are available
- Do not deliver
- Deliver after campaign ends
- Deliver during campaign
- Actions: If you click on the
View icon, the Review notification page appears with the following information:
Preview tab: View the notification message as users will see it.
- To view the message in different languages, use the Select language box.
- Use the Select payload to preview box to select the notification message for simulations that contain multiple payloads.
Details tab: View details about the notification:
- Notification description
- Source: For built-in notifications, the value is Global. For custom notifications, the value is Tenant.
- Notification type: One of the following types base on the notification you originally selected:
- Positive reinforcement notification
- Training assignment notification
- Training reminder notification
- Modified by
- Last modified
When you're finished, click Close.
You're taken to the Simulation schedule page when you click Next.
Customized end user notifications: When you click Next, you're taken to the Training assignment notification page as described in the next sections.
Training assignment notification
The Training assignment notification page is available only if you selected Customized end user notifications on the Select end user notification page.
This page shows the following notifications and their configured languages:
Microsoft default training assignment notification
Any custom training assignment notifications that you previously created.
These notifications are also available in End user notifications on the Simulation content library tab in Attack simulation training at https://security.microsoft.com/attacksimulator?viewid=simulationcontentlibrary. Microsoft default training assignment notification is available on the Global notifications tab. Custom training assignment notifications are available on the Tenant notifications tab. For more information, see End-user notifications for Attack simulation training.
You can select an existing training assignment notification or create a new notification to use:
To select an existing notification, click in the blank area next to the notification name. If you click on the notification name, the notification is selected and a preview flyout appears. To deselect the notification, clear the check box next to the notification.
To search for an existing notification, use the
Search box to search for the name.
Select the notification that you want to use, and then click Next.
To create and use a new notification, click
Create new.
Create new training assignment notification wizard
If you clicked Create new on the Training assignment notification page, a notification creation wizard opens.
The creation steps are identical as described in Create end-user notifications.
Note
On the Define details page, be sure to select the value Training assignment notification for Select notification type.
When you're finished, you're taken back to the Training assignment notification page where the notification that you just created now appears in the list.
Select the notification that you want to use, and then click Next.
Training reminder notification
The Training reminder notification page is available only if you selected Customized end user notifications on the Select end user notification page.
Set frequency for reminder notification: Select Weekly (default) or Twice a week.
Select a reminder notification: This section shows the following notifications and their configured languages:
Microsoft default training reminder notification
Any custom training reminder notifications that you previously created.
These notifications are also available in End user notifications on the Simulation content library tab in Attack simulation training at https://security.microsoft.com/attacksimulator?viewid=simulationcontentlibrary. Microsoft default training reminder notification is available on the Global notifications tab. Custom training reminder notifications are available on the Tenant notifications tab. For more information, see End-user notifications for Attack simulation training.
You can select an existing training reminder notification or create a new notification to use:
To select an existing notification, click in the blank area next to the notification name. If you click on the notification name, the notification is selected and a preview flyout appears. To deselect the notification, clear the check box next to the notification.
To search for an existing notification, use the
Search box to search for the name.
Select the notification that you want to use, and then click Next.
To create and use a new notification, click
Create new.
Create new training reminder notification wizard
If you clicked Create new on the Training reminder notification page, a notification creation wizard opens.
The creation steps are identical as described in Create end-user notifications.
Note
On the Define details page, be sure to select the value Training reminder notification for Select notification type.
When you're finished, you're taken back to the Training reminder notification page where the notification that you just created now appears in the list.
Select the notification that you want to use, and then click Next.
Positive reinforcement notification
The Positive reinforcement notification page is available only if you selected Customized end user notifications on the Select end user notification page.
Delivery preferences: Select one of the following values:
Do not deliver: If you select this option, you're taken to the Simulation schedule page when you click Next.
Deliver after the user reports a phish and campaign ends or Deliver immediately after the user reports a phish: These sections show the following notifications and their configured languages in the Select a positive reinforcement notification section that appears:
Microsoft default positive reinforcement notification
Any custom positive reinforcement notifications that you previously created.
These notifications are also available in End user notifications on the Simulation content library tab in Attack simulation training at https://security.microsoft.com/attacksimulator?viewid=simulationcontentlibrary. Microsoft default positive reinforcement notification is available on the Global notifications tab. Custom positive reinforcement notifications are available on the Tenant notifications tab. For more information, see End-user notifications for Attack simulation training.
You can select an existing positive reinforcement notification or create a new notification to use:
To select an existing notification, click in the blank area next to the notification name. If you click on the notification name, the notification is selected and a preview flyout appears. To deselect the notification, clear the check box next to the notification.
To search for an existing notification, use the
Search box to search for the name.
Select the notification that you want to use, and then click Next.
To create and use a new notification, click
Create new.
Create new positive reinforcement notification wizard
If you clicked Create new on the Positive reinforcement notification page, a notification creation wizard opens.
The creation steps are identical as described in Create end-user notifications.
Note
On the Define details page, be sure to select the value Positive reinforcement notification for Select notification type.
When you're finished, you're taken back to the Positive reinforcement notification page where the notification that you just created now appears in the list.
Select the notification that you want to use, and then click Next.
Simulation schedule
On the Simulation schedule page, select one of the following values:
- Randomized: You still need to select the schedule on the next page, but the simulations will launch at random times with the schedule.
- Fixed
When you're finished, click Next.
Schedule details
What you see on the Schedule details page depends on whether you selected Randomized or Fixed on the previous page.
Randomized: The following settings are available:
- Simulation start section: Configure the following setting:
- Select the date you want the simulations to start from
- Simulation scoping section: Configure the following settings:
- Select the days of the week that simulations are allowed to start on: Select one or more days of the week.
- Enter the maximum number of simulations that can be started between the start and end dates: Enter a value from 1 to 10.
- Randomize send times: Select this setting to randomize the send times.
- Simulation end section: Configure the following setting:
- Select the date you want the simulations to end
- Simulation start section: Configure the following setting:
Fixed: The following settings are available:
- Simulation start section: Configure the following setting:
- Select the date you want the simulations to start from
- Simulation recurrence section: Configure the following settings:
- Select if you want simulations to launch weekly or monthly: Select one of the following values:
- Weekly: This is the default value.
- Monthly
- Enter how often in weeks you want the simulations to recur for: Enter a value from 1 to 99 weeks.
- Select the day of the week you want the simulations to start from
- Select if you want simulations to launch weekly or monthly: Select one of the following values:
- Simulation end section: Selection one of the following values:
- Select the date you want the simulations to end
- Enter the number of occurrences of the simulations to run before ending: Enter a value from 1 to 10.
- Simulation start section: Configure the following setting:
When you're finished, click Next.
Launch details
On the Launch details page, configure the following additional settings for the automation:
Use unique payloads across simulations within an automation: By default, this setting is not selected.
Target all selected users in every simulation run: By default, this setting is not selected.
Target repeat offenders: By default, this setting is not selected. If you select it, configure the following setting that appears:
- Enter the maximum number of times a user can be targeted within this automation: Enter a value from 1 to 10.
Send simulation email based upon the user's current time zone setting from Outlook web app: By default, this setting is not selected.
Display the drive-by technique interstitial data gathered page: This setting is available only if you selected Drive-by URL on the Select social engineering techniques page. You can show the overlay that comes up for drive-by URL technique attacks. By default, the setting is on
. To hide the overlay and go directly to the landing page, turn this setting off
.
Review simulation automation
On the Review simulation automation page, you can review the details of your simulation automation.
You can select Edit in each section to modify the settings within the section. Or you can click Back or select the specific page in the wizard.
When you're finished, click Submit.
Frequently asked questions (FAQ)
This section contains some of the most common questions about Simulation automations.
Why is the Status value under Automation showing Completed, but the Status value under Simulation showing In progress?
Completed on the Simulation automation page means the job of simulation automation is complete, and no more simulations will be created by it. Simulation is a separate entity that will complete after 30 days of simulation launch time.
Why is the simulation end date 30 days after creation, even though I selected an automation end date of one week?
A one week end date for the simulation automation means no new simulations will be created by it after one week. For simulations created by a simulation automation, the default end date is 30 days after the creation of the simulation.
If we have multiple payload techniques (for example, Credential harvest, Link to Malware, and Drive by URL) targeting 300 users, how are the techniques sent to users? Do all payload techniques go to all users, or is the selection random?
If you don't select the Target All Selected Users In Every Run option, all targeted users will be distributed over the maximum number of simulations that are created by the simulation automation.
If you select Target All Selected Users In Every Run, all targeted users will be part of every simulation that's created by the simulation automation.
How does the Randomize option on the Simulation schedule page work?
The **Randomize launch&& option optimally selects a day within the start date and end date range to launch simulations.
How does the Randomize option on the Select payloads page work?
For every run, a technique from the list of selected techniques is chosen, and then a random payload from both Tenant and Global payloads will be chosen. This behavior helps to ensure that the selected payload wasn't part of any previous run for this particular automation.
With a randomized schedule, the maximum number of simulations is between 1 and 10. How does this work?
This number is the maximum number of runs that can be created by this automation. For example, if you select 10, the maximum number of simulations that will be created by this automation is 10. The number of simulations can be fewer depending on the number of targeted users and the availability of payloads.
If I select only one specific day between two days (for example, Wednesday), how many simulations will I see on the Simulation tab?
If there's only one Wednesday between the start date and end date, the automation will have only one valid day to send out the simulation. Even if you selected a higher value for Max number of simulations, this value will get overwritten to one.
How does randomize send times currently work?
Randomize send time works in batches of 1000 users and is meant to be used with a large number of targeted users. If less than 1000 users are involved in simulations created by automations, a randomize send time will not trigger.
Feedback
Submit and view feedback for