n8n-nodes-msdefender

This is an n8n community node. It lets you use Microsoft Defender in your n8n workflows.

Microsoft Defender is a comprehensive security solution that helps protect your devices and data from threats. This node allows you to interact with the Microsoft Defender API to perform various security operations, such as managing devices, retrieving threat intelligence, and more.

For a some background, visit I made a n8n node for Microsoft Defender.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

Defender for Endpoint

• Advanced Query: Run advanced queries against Microsoft Defender.
• Alert: Manage and retrieve information about security alerts.
  • Get Many: Retrieve many alerts.
  • Get By ID: Retrieve a specific alert by its ID.
  • Update Alert: Update the properties of a specific alert.
• Remediation: Manage and retrieve information about remediation activities.
  • Get Remediation Activities: Retrieve all remediation activities.
  • Get Remediation Activity: Retrieve a specific remediation activity by ID.
  • Get Devices By Remediation Activity: Retrieve devices exposed in a specific remediation activity by ID
• Machine: Manage and retrieve information about devices.
  • Add Or Remove Tag For Machine
  • Find By Tag
  • Get Many: Retrieve many machines.
  • Get Security Recommendations For Machine
  • List Installed Software For Machine
• Exposure
  • Get Current Exposure Score
  • Get Exposure Score By Machine Groups.
• Machine Actions
  • Isolate Machine
  • Release Machine from Isolation
  • List Machine Actions
  • Offboard Machine
  • Cancel Machine Action
  • Run Antivirus Scan
• Vulnerability
  • Get All Vulnerabilities
  • Get Machines By CVE
  • Get By Machine And Software
• Investigation
  • Get All Investigations
  • Get Investigation By ID
  • Start Investigation on Machine
• Indicator
  • Get All Indicators
  • Submit Indicator
  • Delete Indicator
• Recommendation
  • Get Security Recommendations
  • Get Security Recommendation By ID
  • Get Machines By Security Recommendation
  • Get Vulnerabilities By Security Recommendation
  • Get Recommendations By Software
• Software
  • Get All Software
  • Get Software By ID
  • Get Software Version Distribution
  • Get Machines By Software
  • Get Vulnerabilities By Software
  • Get Missing KBs By Software

Defender XDR

• Incident: Manage and retrieve information about security incidents.
  • Get Many: Retrieve many incidents.
  • Get By ID: Retrieve a specific incident by its ID.
  • Update Incident: Update the properties of a specific incident.

Triggers

• Microsoft Defender for Endpoint Trigger
  • Polling trigger for alerts created or updated
• Microsoft Defender XDR Trigger
  • Polling trigger for incidents created or updated

Credentials

To use this node, you need to set up an Entra ID (Azure AD) application and obtain the necessary credentials to access the Microsoft Defender API.

1. Register an application in the Azure Portal.
2. Assign the required API application permissions to the application for Microsoft Defender (WindowsDefenderATP).
   • AdvancedQuery.Read.All
   • Machine.ReadWrite.All
   • Score.Read.All
   • Machine.Isolate
   • Vulnerability.Read.All
   • SecurityRecommendation.Read.All
   • Machine.Scan
   • Machine.Offboard
3. Assign the required API application permissions to the application for Microsoft Defender XDR (Microsoft Threat Protection).
   • Incidents.ReadWrite.All
4. Grant admin consent for the permissions.
5. Generate a client secret for the application.
6. Note down the Application (client) ID, Directory (tenant) ID, and client secret.

When configuring the Microsoft Defender node in n8n, use the following credentials:

• Client ID: The Application (client) ID from your Azure AD application.
• Client Secret: The client secret generated for your Azure AD application.
• Access Token URL: https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token

There are two separate credentials for Microsoft Defender and Microsoft Defender XDR, so be sure to set up both if you plan to use both nodes.

Compatibility

This node is compatible with latest n8n versions.

Usage

Try it out

Resources

• n8n community nodes documentation

Version history

Changelog