Skip to main content

Cloud-delivered Incident ResponderIncident Responder Documentation

Configure the Microsoft Windows Defender ATP Service

Configure Microsoft Windows Defender Advanced Threat Protection (ATP) as a service to gather information about entities and artifacts, manage files and applications on a host, and use other Microsoft Windows Defender ATP actions.

Last updated: March 22, 2023

  1. Get access to the Microsoft Defender for Endpoints API: create an Azure Active Directory (AAD) application, get an access token to Microsoft Defender for Endpoint, then validate the token.

    When you create the AAD application, ensure you complete certain tasks if your Microsoft Exchange Online account uses OAuth2.0 modern authentication and assign specific permissions for each action:

    Incident Responder action

    API delegated permission

    Add Tag to Host Windows Defender ATP

    Machine.ReadWrite

    Collect Investigation Package Windows Defender ATP

    Machine.CollectForensics

    Find Devices for User Windows Defender ATP

    Machine.Read

    Get Device Info Windows Defender ATP

    Machine.Read

    Get File Information Windows Defender ATP

    File.Read.All

    Get IP Information Windows Defender ATP

    Ip.Read.All

    Get Investigation Package SAS URI Windows Defender ATP

    Machine.CollectForensics

    Get Logged On Users Windows Defender ATP

    User.Read.Alliles

    Get URL Domain Information Windows Defender ATP

    URL.Read.All

    Hunt Domain Windows Defender ATP

    Machine.Read

    Hunt File Windows Defender ATP

    Machine.Read

    Quarantine Host Windows Defender ATP

    Machine.Isolate

    Find Alerts for Device

    Alert.Read

    Find Alerts for Domain Windows Defender ATP

    Alert.Read

    Find Alerts for File Windows Defender ATP

    Alert.Read

    Find Alerts for IP Windows Defender ATP

    Alert.Read

    Find Alerts for Machine Windows Defender ATP

    Alert.Read

    Find Alerts for User Windows Defender ATP

    Alert.Read

    Offboard Machine Windows Defender ATP

    Machine.Offboard

    Un quarantine Host Windows Defender ATP

    Machine.Isolate

    Remove App Restriction Windows Defender ATP

    Machine.RestrictExecution

    Remove Tag from Host Windows Defender ATP

    Machine.ReadWrite

    Restrict App Execution Windows Defender ATP

    Machine.RestrictExecution

    Scan Host Windows Defender ATP

    Machine.Scan

    Stop and Quarantine File Windows Defender ATP

    Machine.StopAndQuarantine

  2. Create an application secret.

  1. In the sidebar, click SETTINGSA grey gear icon, then select Core.

  2. Under SERVICE INTEGRATIONS, select Services.

  3. Select a service:

    • To configure a specific service, hover over a service, then click CONFIGURE. Use the search by vendor or filter by action to find a service.

    • To manually provide the relevant information for a service, click Configure a new serviceA dark blue plus sign..

    • To view all actions for a service, hover over a service, then click the information icon An icon of a grey i inside a grey circle..

  4. Enter information about the service:

    • Service Name – Enter a unique name for the service. By default, the service name is Windows Defender ATP.

    • (Optional) Description – Describe the service.

    • (Optional) Owner – Enter the email address of the person or group responsible for the service. 

    • Tenant ID – Enter the directory (tenant) ID you noted when you created the AAD application.

    • Client ID – Enter the application (client) ID you noted when you created the AAD application.

    • Secret – Enter the application secret you previously created.

  5. To validate the source, select TEST CONNECTIVITY.

  6. Click CREATE SERVICE.