Register and configure the Microsoft Defender for Endpoint in the Microsoft Azure portal

Register the Microsoft Defender for Endpoint application in the Microsoft Azure portal and grant the read and write access to the application.

Before you begin

Role required: Application developer, Tenant administrator.

Procedure

1. Log in to the Microsoft Azure portal.

2. Enter App registrations in the Search box, and click Click New registration.

3. Enter a name for your application and the redirect URI, and click Register.

   An example name is Microsoft Defender for Endpoint. The Redirect URI is used while providing admin consent for the application.

4. In the App registrations page, select the application that you registered in Step 3.

5. Under Manage, select Certificates & secrets.

6. To create a client secret, select New client secret.

7. Copy the client secret and save it.

   In case you forgot the client secret, you can generate a new client secret.

8. Navigate to Manage > API Permissions.

9. Click Add a permission.

10. In the Request API permissions window, click the APIs my organization uses tab.

11. Search for and select WindowsDefenderATP.

12. In the WindowsDefenderATP permissions, select Application permissions.

    Enabling this permission ensures that the application runs as a background service or daemon without a signed-in user.

13. Add the following application level permissions and grant admin consent for the newly added API permissions.

    Permission	Permission Display Name
    Machine.Read.All	Read all machine profiles
    User.Read.All	Read user profiles
    Machine.Isolate	Isolate machine
    Machine.RestrictExecution	Restrict code execution
    Machine.Scan	Scan machine
    Machine.StopAndQuarantine	Stop and Quarantine
    URL.Read.All	Read URLs
    File.Read.All	Read file profiles
    Ip.Read.All	Read IP address profiles
    Ti.ReadWrite.All	Read and write Indicators