> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Defender for Endpoint

> Microsoft Defender for Endpoint is an enterprise endpoint security platform designed to help enterprise networks prevent, detect, investigate, and respond to advanced threats.

## Creating a Microsoft Defender For Endpoints connection

Create the connection by using one of the following methods:

* [OAuth](#using-oauth)
* [App Registration](#using-app-registration)

### Using OAuth

#### Creating your connection

1. In the Blink platform, navigate to the **Connections** page > **Add connection**. A New Connection dialog box opens displaying icons of external service providers available.
2. Select the **Microsoft Defender For Endpoints** icon. A dialog box with name of the connection and connection methods appear.
3. (Optional) Edit the name of the connection. At a later stage you cannot edit the name.
4. Click **OAuth** to authenticate using OAuth.
5. Sign in using your credentials.

<Info>
  Need admin approval? please refer to the [Need Admin
  Approval](/docs/integrations/microsoft-defender-for-endpoints/admin-approval)
  guide.
</Info>

### Using App Registration

To create the connection you need:

* A Client ID
* A Client Secret
* A Tenant ID

#### Obtaining the credentials

1. Log into the [Azure Portal](https://portal.azure.com/#home).

2. Go to the *Microsoft Entra ID* resource.

   <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/azure_active_directory.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=57246fca73df6e9ce3f39594b5c944bf" alt="Azure Active Directory Resource" width="2760" height="1602" data-path="img/ActiveDirectory/azure_active_directory.png" />

3. In the left-hand menu, click **App registrations**.

   <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/app_registrations.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=aa4834712de9b57c079d56adb68abc7f" alt="App Registrations" width="495" height="853" data-path="img/ActiveDirectory/app_registrations.png" />

4. Create a new application registration or click on one of your existing applications.

   <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/my_app1.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=bc11b1db3698cb119e105eaa7e699f6b" alt="My App" width="2628" height="1138" data-path="img/ActiveDirectory/my_app1.png" />

5. In the left-hand menu, click **API permissions**.

   <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/api_permissions.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=b0ed7c3e06ffd15e35fb078b7b3f0e78" alt="API Permissions" width="320" height="853" data-path="img/ActiveDirectory/api_permissions.png" />

6. Click **Add a permission** > **APIs my organization uses** > **WindowsDefenderATP**.

   <img src="https://mintcdn.com/blinkops-2/6JIG4C9X2ValYH_B/img/Microsoft-Defender-Endpoints/ATP.png?fit=max&auto=format&n=6JIG4C9X2ValYH_B&q=85&s=af7960f0bb22a9f8b97393bdc6623492" alt="Add Permission" width="2640" height="1668" data-path="img/Microsoft-Defender-Endpoints/ATP.png" />

7. Choose **Application permissions** and mark the permissions you wish to add.

   <img src="https://mintcdn.com/blinkops-2/6JIG4C9X2ValYH_B/img/Microsoft-Defender-Endpoints/alert_permissions_atp.png?fit=max&auto=format&n=6JIG4C9X2ValYH_B&q=85&s=0760061c5191a54c1c5450d3cd7e14a1" alt="Application Permissions" width="1696" height="1260" data-path="img/Microsoft-Defender-Endpoints/alert_permissions_atp.png" />

To support all Blink actions, these are the required **application** permissions:

| Required Permissions      |
| ------------------------- |
| Alert.Read.All            |
| Alert.ReadWrite.All       |
| Machine.LiveResponse      |
| Machine.Read.All          |
| Machine.ReadWrite.All     |
| Machine.StopAndQuarantine |
| Machine.Isolate           |
| AdvancedQuery.Read.All    |
| Machine.Scan              |

8. Click **Add permissions** to save the changes.

9. Click **Grant admin consent for `<your tenant>`** on the API permissions page. **Only admins can grant consent**.

   <img src="https://mintcdn.com/blinkops-2/6JIG4C9X2ValYH_B/img/Microsoft-Defender-Endpoints/grant_admin_consent_atp.png?fit=max&auto=format&n=6JIG4C9X2ValYH_B&q=85&s=523ed07111ed2630117ae4e94f711b6d" alt="Grant Admin Consent" width="3298" height="1442" data-path="img/Microsoft-Defender-Endpoints/grant_admin_consent_atp.png" />

10. Confirm that the added permissions are now verified.

    <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/granted_ATP.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=b2cb48772794fec0016d39782f545f7a" alt="Granted Admin Consent" width="2094" height="414" data-path="img/ActiveDirectory/granted_ATP.png" />

11. Navigate to **Overview** and Copy your **client ID** and **tenant ID**.

    <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/client_tenant.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=7faa71341ef29fce86e62d436472e630" alt="Client ID & Tenant ID" width="3438" height="1266" data-path="img/ActiveDirectory/client_tenant.png" />

12. Create a new **client secret**.

    <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/secret.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=9d1dfac219ab431a28a8c0d5219b96f1" alt="Client Secret" width="3250" height="1252" data-path="img/ActiveDirectory/secret.png" />

13. Copy the **secret value**.

    <img src="https://mintcdn.com/blinkops-2/LiDiL34PEmIGHJGK/img/ActiveDirectory/secret_value.png?fit=max&auto=format&n=LiDiL34PEmIGHJGK&q=85&s=8c7709585443b3044f2c17e3e9493ed9" alt="Client Secret" width="2672" height="1312" data-path="img/ActiveDirectory/secret_value.png" />

#### Creating your connection

1. In the Blink platform, navigate to the **Connections** page > **Add connection**. A New Connection dialog box opens displaying icons of external service providers available.

2. Select the **Microsoft Defender For Endpoints** icon. A dialog box with name of the connection and connection methods appear.

3. (Optional) Edit the name of the connection. At a later stage you cannot edit the name.

4. Select **App Registration** as the method to create the connection.

5. Fill in the parameters:

   * The Client ID
   * The Client Secret
   * The Tenant ID

6. (Optional) Click **Test Connection** to test it.

7. Click **Create connection**. The new connection appears on the **Connections** page.

### Interactive Tutorial Guides

You can also refer to the following tutorial guides for a more in-depth understanding of how to create a Microsoft Defender for Endpoints connection.

[Creating a Microsoft Defender for Endpoints Connection](https://demo.arcade.software/hbo7amE0DcnM6b4dbTg1?embed\&show_copy_link=true)

[Creating a Microsoft Defender for Endpoints Connection in Blink Ops](https://demo.arcade.software/4OHHVHZqJV6hyH2ESBCb?embed\&show_copy_link=true)
