Microsoft Defender Documentation

repository·public·Indexed 41 days ago

https://github.com/microsoftdocs/defender-docs

Technical documentation for Microsoft Defender, including guides for Microsoft Defender for Endpoint onboarding, Intune integration, and the use of the Defender deployment tool for Windows devices.

Tokens
235K
Snippets
251
Records
950
Agent score
52%

What's inside Microsoft Defender

  1. Overview of Microsoft Defender for Endpoint on Windows

    public

    Microsoft Defender for Endpoint on Windows provides a comprehensive security suite for Windows endpoints, focusing on preventative protection, post-breach detection, automated investigation, and response.

    It is applicable to the following plans:

    • Microsoft Defender for Endpoint Plan 1
    • Microsoft Defender for Endpoint Plan 2
    • Microsoft Defender for Endpoint for servers
    • Microsoft Defender for Business servers

    Core security pillars include:

    • Autonomous protection: AI-driven automation to disrupt attacks and shield assets.
    • Next-generation protection: Behavior-based, cloud-delivered antivirus and attack surface reduction.
    • Endpoint detection and response (EDR): Deep visibility and rapid investigation of advanced attacks.
    • Vulnerability management: Identification and prioritization of security gaps.
    • Automated investigation and response (AIR): Automated playbooks for alert remediation.
    • Device and network discovery: Identification of unmanaged endpoints and IoT devices.
  2. Overview of Defender for Cloud CLI

    public

    The Defender for Cloud CLI is a developer-focused command-line tool designed to orchestrate security scans both locally on developer terminals and within CI/CD pipelines (such as GitHub Actions, Azure DevOps, Jenkins, and Bitbucket).

    Key capabilities include:

    • Universal Scanning: Run security scans from any environment with minimal configuration.
    • Scanner Orchestration: Unify multiple security engines (e.g., container image analysis) under a single tool with consistent output and exit codes.
    • Cloud Integration: Automatically upload findings to Microsoft Defender for Cloud to gain code-to-runtime visibility, attack-path context, and centralized prioritization.
    • Developer Experience: Provides concise console output and actionable remediation guidance designed for pipelines and pull requests.
  3. Stream logs to Microsoft Sentinel via Logstash and DCR-based API

    public

    You can use the Microsoft Sentinel Logstash output plugin to stream logs from external data sources into custom or standard tables in Microsoft Sentinel or Log Analytics. This method uses Data Collection Rules (DCRs) to provide full control over the output schema, allowing you to:

    • Define specific column names and data types.
    • Perform ingestion-time transformations, such as filtering or enrichment.
    • Ingest custom logs into custom tables or Syslog streams into the standard Log Analytics Syslog table.

    Note: This feature is currently in public preview and is provided without an SLA. The plugin sends JSON-formatted data to your workspace using the Logs Ingestion API.

  4. Use the Dragos Notifications via Cloud Sitestore Connector

    public

    The Dragos connector allows Dragos Platform notification data to be viewed in Microsoft Sentinel for triaging OT cyber threat events.

    Supported Log Analytics Tables

    TableDCR supportLake-only ingestion
    DragosAlerts_CLYesYes

    Prerequisites

    • Dragos Sitestore API access: A user account with notification:read permission and an API key.
  5. Deploy Microsoft Defender endpoint security to Windows devices

    public

    The Defender deployment tool is a lightweight, self-updating application used to onboard and offboard Windows devices to Microsoft Defender for Endpoint. It automates prerequisite checks, handles migrations from older solutions, and provides both an interactive UI for manual onboarding and a command-line interface for large-scale, automated deployments (e.g., via Group Policy or orchestration platforms).

    Key Features:

    • Prerequisite handling: Automatically checks for and remediates required updates.
    • Automation: Supports command-line parameters and reusable configuration files.
    • Passive mode: Supports setting Defender Antivirus to passive mode on Windows 7 and Server operating systems during migrations.
    • VDI support: Ensures Virtual Desktop Infrastructure devices appear as a single device in the portal even if recreated under the same hostname.
    • Security guardrails: Requires a deployment key generated in the Microsoft Defender portal to prevent accidental onboarding.
    • Offline capability: Supports onboarding and offboarding without active connectivity.
  6. Configure Defender for Endpoint settings categories

    public

    The Defender for Endpoint settings menu allows you to manage the following functional areas:

    • General settings: Modify settings that were defined during the initial onboarding process.
    • Permissions: Manage portal access using Role-Based Access Control (RBAC) and device groups.
    • APIs: Enable threat intelligence and SIEM (Security Information and Event Management) integrations.
    • Rules: Configure suppression rules and automation settings.
    • Device management: Perform onboarding and offboarding of devices.
    • Network assessments: Select specific devices to be scanned regularly and added to the device inventory.
  7. Protect your ServiceNow environment with Microsoft Defender for Cloud Apps

    public

    You can connect ServiceNow to Microsoft Defender for Cloud Apps to monitor user activity, detect anomalous behavior, and identify sensitive data exposure. This connection helps mitigate threats such as compromised accounts, insider threats, data leakage, and unmanaged BYOD devices.

    Key protection capabilities include:

    • Threat Detection: Identifying compromised accounts and malicious insiders using machine-learning anomaly detection.
    • Data Protection: Discovering, classifying, and labeling regulated or sensitive data (e.g., PII, PCI, PHI).
    • Compliance Enforcement: Applying DLP (Data Loss Prevention) and collaboration policies.
    • Forensics: Utilizing activity audit trails for investigations.
  8. Armis Devices Data Connector Overview

    public

    The Armis Device connector ingests device information from the Armis platform into Microsoft Sentinel via the Armis REST API. It uses Armis's agentless discovery capabilities to identify managed and unmanaged devices.

    Data Ingestion Details:

    • Log Analytics Table: Armis_Devices_CL
    • DCR Support: Not currently supported.
    • Lake-only ingestion: No.

    Prerequisites:

    • Permissions: Microsoft.Web/sites permissions (Read/Write) to create Azure Function Apps.
    • Credentials: An Armis Secret Key (obtainable from Armis Settings > API Management).
    • Parser: This connector requires a Kusto Function parser. You must create the Kusto functions alias ArmisDevice by following the instructions at https://aka.ms/sentinel-ArmisDevice-parser.
  9. Overview of Generic SIEM Integration

    public

    You can integrate Microsoft Defender for Cloud Apps with a generic SIEM server to centralize monitoring of alerts and activities from connected apps. This allows for automated security procedures and correlation between cloud and on-premises events.

    How it works: A SIEM agent runs on your server, pulls alerts and activities from Microsoft Defender for Cloud Apps using RESTful APIs, and streams them to your SIEM via Syslog messages.

    Data Forwarding Behavior:

    • Upon initial integration, the agent forwards activities and alerts from the last two days.
    • For all subsequent data, it forwards alerts and activities based on the filters configured during setup.
    • If integration is disabled for an extended period and then re-enabled, the agent will again forward the past two days of data before continuing with real-time data.
  10. What is a File policy in Microsoft Defender for Cloud Apps

    public

    A File policy is an API-based policy used to control organizational content in the cloud. It uses over 20 file metadata filters (such as owner and sharing level) and content inspection results to trigger governance actions.

    Each policy consists of four main components:

    • File filters: Granular conditions based on file metadata.
    • Content inspection: Narrows policies based on DLP (Data Loss Prevention) engine results. You can use custom or preset expressions, set exclusions, define the number of matches required, and use anonymization to mask usernames.
    • Actions: Automated governance actions applied when violations are found. These are categorized into collaboration actions, security actions, and investigation actions.
    • Extensions: Allows content inspection via 3rd-party engines for enhanced DLP or anti-malware capabilities.
  11. SPF TXT record syntax and components

    public

    An SPF TXT record follows the syntax defined in RFC 7208. The basic structure is:

    v=spf1 <valid mail sources> <enforcement rule>

    Components

    1. Version Identifier

    • v=spf1: Identifies the record as an SPF TXT record.

    2. Valid Mail Sources

    You can specify sources using Domains or IP addresses:

    • Domains (include:): Specifies other services as authorized senders. Most Microsoft 365 organizations must include include:spf.protection.outlook.com.
    • IP Addresses (ip4: or ip6:): Specifies the publicly resolvable IP address or CIDR range of the source system. This is typically used for on-premises Exchange hybrid deployments.

    3. Enforcement Rules

    Determines how receiving systems handle mail from unauthorized sources:

    • -all (Hard Fail): Recommended for Microsoft 365. Tells receivers to reject/discard unauthorized mail. Works best when paired with DMARC.
    • ~all (Soft Fail): Tells receivers that unauthorized mail is likely not legitimate but should be accepted and marked (e.g., sent to Junk).
    • ?all (Neutral): Suggests no specific action. Use this only for testing; it is not recommended for production.
    v=spf1 ip4:192.168.0.10 ip4:192.168.0.12 include:spf.protection.outlook.com -all