# Microsoft Defender

Investigate and manage Microsoft Defender security alerts, incidents, hunting results, secure scores, attack simulations, threat intelligence, and threat submissions through Microsoft Graph.

Category: Security & Ops. Connect from any Opisense bot at https://www.opisense.com/integrations/microsoft-defender/.

## Actions

- **Add Alert Comment**: Append a comment to a Microsoft Defender security alert.
- **Add Incident Comment**: Append an analyst comment to a Microsoft Defender incident.
- **Create Email Submission Policy**: Create an email threat-submission policy with the supplied settings.
- **Create Simulation**: Create an attack simulation using payload, login-page, and landing-page resource IDs.
- **Delete Email Submission Policy**: Delete an email threat-submission policy by its Microsoft Graph identifier.
- **Delete Simulation**: Delete an attack simulation campaign.
- **Get Alert** (read-only): Retrieve the documented properties of a Microsoft Defender security alert.
- **Get Article Indicator** (read-only): Read a Microsoft Defender Threat Intelligence article indicator.
- **Get Email Submission Policy** (read-only): Get one email threat-submission policy by its Microsoft Graph identifier.
- **Get Host Component** (read-only): Read a web component observed on a threat-intelligence host.
- **Get Host Cookie** (read-only): Read a cookie observed on a Microsoft Defender Threat Intelligence host.
- **Get Host Pair** (read-only): Read a parent-child host relationship observed by Microsoft Defender Threat Intelligence.
- **Get Host Port** (read-only): Read a port observed on a Microsoft Defender Threat Intelligence host.
- **Get Host Reputation** (read-only): Get the reputation properties and relationships for a threat-intelligence host.
- **Get Host Tracker** (read-only): Read an internet tracker observed on a Microsoft Defender Threat Intelligence host.
- **Get Host WHOIS** (read-only): Get the WHOIS record associated with a threat-intelligence host.
- **Get Incident** (read-only): Retrieve a Microsoft Defender incident by its identifier.
- **Get Intelligence Profile** (read-only): Get a Microsoft Defender threat-intelligence profile by identifier.
- **Get Intelligence Profile Indicator** (read-only): Get a Microsoft Defender intelligence profile indicator by identifier.
- **Get Landing Page** (read-only): Get a landing page associated with an attack simulation campaign.
- **Get Login Page** (read-only): Get a login page associated with an attack simulation campaign.
- **Get Passive DNS Record** (read-only): Get a Microsoft Defender passive DNS record by identifier.
- **Get Payload** (read-only): Get an attack simulation campaign payload.
- **Get Payload Detail** (read-only): Get detailed content for an attack simulation campaign payload.
- **Get Secure Score** (read-only): Retrieve a Microsoft secure score by its provider-generated identifier.
- **Get Secure Score Control Profile** (read-only): Retrieve a Microsoft secure score control profile by its identifier.
- **Get Simulation** (read-only): Get an attack simulation campaign.
- **Get Simulation Automation** (read-only): Get an attack simulation automation.
- **Get Simulation Landing Page** (read-only): Get the landing page associated with an attack simulation campaign.
- **Get Simulation Login Page** (read-only): Get the login page associated with an attack simulation campaign.
- **Get Simulation Operation** (read-only): Get an attack simulation operation to track a long-running request.
- **Get Simulation Payload** (read-only): Get the payload associated with an attack simulation campaign.
- **Get Simulation Report Overview** (read-only): Get an overview of an attack simulation and training campaign.
- **Get Subdomain** (read-only): Get a Microsoft Defender threat-intelligence subdomain by identifier.
- **Get Threat Article** (read-only): Read a Microsoft Defender Threat Intelligence article by ID.
- **Get Threat Host** (read-only): Read a hostname or IP address detected by Microsoft Defender Threat Intelligence.
- **Get Threat Submission** (read-only): Get one email, file, or URL threat submission by its Microsoft Graph identifier.
- **Get Training** (read-only): Get an attack simulation training resource.
- **Get Training Language Detail** (read-only): Get localized language details for an attack simulation training.
- **Get Vulnerability** (read-only): Get a Microsoft Defender threat-intelligence vulnerability by identifier.
- **Get Vulnerability Component** (read-only): Get a component associated with a Microsoft Defender vulnerability.
- **Get WHOIS History Record** (read-only): Get a Microsoft Defender WHOIS history record by identifier.
- **Get WHOIS Record** (read-only): Get a Microsoft Defender WHOIS record by identifier.
- **List Alerts** (read-only): Get a page of Microsoft Defender security alerts and their properties.
- **List Article Indicators** (read-only): List indicators of threat or compromise associated with a threat article.
- **List Attack Simulation Repeat Offenders** (read-only): Get one page of tenant users who yielded to attacks more than once in attack simulation campaigns.
- **List Email Submission Policies** (read-only): Get the email threat-submission policies and their current settings.
- **List End User Notifications** (read-only): Get one page of attack simulation end-user notification templates.
- **List Host Components** (read-only): List web components observed on a Microsoft Defender Threat Intelligence host.
- **List Host Cookies** (read-only): List cookies observed on a Microsoft Defender Threat Intelligence host.
- **List Host Pairs** (read-only): List all, child, or parent host-pair relationships for a threat-intelligence host.
- **List Host Passive DNS** (read-only): List passive-DNS records associated with a Microsoft Defender Threat Intelligence host.
- **List Host Ports** (read-only): Get one page of ports associated with a Microsoft Defender threat-intelligence host.
- **List Host Reverse Passive DNS** (read-only): Get one page of passive DNS records that resolve to the specified host.
- **List Host Subdomains** (read-only): Get one page of subdomain resources associated with a threat-intelligence host.
- **List Host Trackers** (read-only): Get one page of trackers associated with a threat-intelligence host.
- **List Host WHOIS History** (read-only): Get one page of historical WHOIS records associated with a host.
- **List Incidents** (read-only): Get one page of Microsoft Defender incidents and an opaque continuation cursor.
- **List Intelligence Profile Indicators** (read-only): Get one page of indicators associated with a Microsoft Defender intelligence profile.
- **List Intelligence Profiles** (read-only): Get one page of Microsoft Defender threat-intelligence profiles.
- **List Landing Pages** (read-only): Get one page of landing pages for attack simulation campaigns.
- **List Login Pages** (read-only): Get one page of login pages for attack simulation campaigns.
- **List Payloads** (read-only): Get one page of payloads for attack simulation campaigns.
- **List Secure Score Control Profiles** (read-only): Return one page of Microsoft secure score control profiles and an opaque continuation cursor.
- **List Secure Scores** (read-only): Return one page of daily Microsoft secure scores and an opaque continuation cursor.
- **List Simulation Automation Runs** (read-only): Get one page of runs for an attack simulation automation.
- **List Simulation Automations** (read-only): Get one page of attack simulation automations.
- **List Simulation User Coverage** (read-only): Get one page of attack simulation coverage records for tenant users.
- **List Simulation Users** (read-only): List users and their recorded actions in an attack simulation campaign.
- **List Simulations** (read-only): Get one page of attack simulation campaigns.
- **List Threat Articles** (read-only): List Microsoft Defender Threat Intelligence articles one page at a time.
- **List Threat Submissions** (read-only): List one page of email, file, or URL threat submissions visible to the connected account.
- **List Training User Coverage** (read-only): Get one page of training coverage records for tenant users in attack simulation campaigns.
- **List Trainings** (read-only): Get one page of attack simulation training resources.
- **List Vulnerability Components** (read-only): Get one page of components associated with a Microsoft Defender vulnerability.
- **List WHOIS Record History** (read-only): Get one page of historical records for a Microsoft Defender WHOIS record.
- **List WHOIS Records** (read-only): Get one page of WHOIS records from Microsoft Defender threat intelligence.
- **Merge Incidents**: Merge at least two Microsoft Defender incidents into one incident.
- **Move Alerts**: Move one or more Microsoft Defender alerts to a new or existing incident.
- **Review Email Threat Submission**: Record the administrator's review category for an email threat submission.
- **Run Hunting Query** (read-only): Run a Kusto Query Language query against Microsoft Defender advanced-hunting data for the requested time span or workspace.
- **Submit Email Threat**: Submit email content or a Microsoft Graph message URL for security analysis.
- **Submit File Threat**: Submit base64 file content for security analysis.
- **Submit URL Threat**: Submit a URL for security analysis.
- **Update Alert**: Update one or more mutable properties of a Microsoft Defender security alert.
- **Update Email Submission Policy**: Update one or more settings on an email threat-submission policy.
- **Update Incident**: Update one or more editable properties of a Microsoft Defender incident.
- **Update Secure Score Control Profile**: Update tenant state, assignment, comments, and required vendor information for a Microsoft secure score control profile.
- **Update Simulation**: Update a draft attack simulation, optionally binding a payload by resource ID.
