> For the complete documentation index, see [llms.txt](https://docs.oort.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oort.io/integrations/microsoft-defender.md).

# Microsoft Defender

## Overview

Microsoft Defender data collection is available in Cisco Identity Intelligence to discover identities and devices onboarded to Defender.

{% hint style="warning" %}
This integration guide should ***only*** be used by customers participating in an Agentic Visibility Assessment. Paid customers should follow the instructions in the [Microsoft Entra ID Data Integration](https://docs.oort.io/integrations/azure-active-directory-integration.md) guide to create a new integration, if one does not already exist, or modify an existing Entra integration to consume Microsoft Defender related data.
{% endhint %}

### Microsoft Entra ID pre-requisites <a href="#azure-a-d-sign-in-log-availability" id="azure-a-d-sign-in-log-availability"></a>

Before continuing, confirm you have:

* A **Identity Intelligence Admin** account to configure the integration
* A **Microsoft Defender for Endpoint P2, Defender for Business, E5 or E7** license and devices onboarded to Defender. These are required for identity discovery
* Appropriate Entra Licensing - sign-in logs are NOT currently available via Graph API with non-P1 or P2 Entra ID subscriptions, e.g Microsoft Entra ID Free (Reference: [Entra Sign-in Logs](https://docs.microsoft.com/en-us/azure/active-directory/reports-monitoring/concept-sign-ins))
* Access to create an Entra app and an administrator authorized to grant Microsoft Graph application consent, such as a **Privileged Role Administrator**. See [Microsoft’s admin consent requirements](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/grant-admin-consent)

Please note that [Microsoft Entra ID B2C](https://learn.microsoft.com/en-us/azure/active-directory-b2c/overview) is *not* supported

## Manual App Registration Setup Steps <a href="#setup-steps" id="setup-steps"></a>

This section details the manual process to create the Entra ID app registration for Identity Intelligence data collection.

There are 3 high-level steps you need to go through to set up your Microsoft Entra ID API key before connecting it to Identity Intelligence:

1. Setup App registration
2. Assign the App the appropriate permissions
3. Create a client secret in Entra ID
4. Add Entra ID API details to Identity Intelligence Dashboard

### Step 1: Setup App in Microsoft Entra ID <a href="#setup-app-and-api-secret-in-azure-a-d" id="setup-app-and-api-secret-in-azure-a-d"></a>

First, we will create the app in your Microsoft Entra ID tenant

1. Go to ***Microsoft Entra ID...App registrations***
2. Select ***New registration***

   ![](https://docs.oort.io/~gitbook/image?url=https%3A%2F%2F582105988-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FqPSBzsjxd7KYg9DNVZ4l%252Fuploads%252FZQKffyQDaLerCaUTXHBN%252Fimage.png%3Falt%3Dmedia%26token%3D1a3a0cbb-fb02-4408-abe4-ce48427676df\&width=768\&dpr=3\&quality=100\&sign=0eaad9d70b5ba85bff668fd622df313d\&sv=3)
3. Fill in the details for the new app

   * Name this app "Identity Intelligence Data Integration" or something similar
   * Make sure to select “*Accounts in this organizational directory only (`Your Entra ID tenant name` only – Single Tenant)*”
   * **No redirect URI is required - leave these fields blank**

   ![](https://docs.oort.io/~gitbook/image?url=https%3A%2F%2F582105988-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FqPSBzsjxd7KYg9DNVZ4l%252Fuploads%252FclHzLZAqvi4emCYMN5PV%252F482131053-0ac65996-1b03-459e-b35f-cd0d2cd3de77.png%3Falt%3Dmedia%26token%3D3f160a97-adeb-41e0-bf91-2e759b7615dc\&width=768\&dpr=3\&quality=100\&sign=84233003343a4581aff490c66f8bb86b\&sv=3)
4. Select ***Register***
5. Save the following information as it will get entered into the Identity Intelligence dashboard.
   * *Application (client) ID*
   * *Directory (tenant) ID*

<img src="https://docs.oort.io/~gitbook/image?url=https%3A%2F%2F582105988-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FqPSBzsjxd7KYg9DNVZ4l%252Fuploads%252F4YvhzF3HKM5TDPwr5gmw%252Fimage.png%3Falt%3Dmedia%26token%3D8a0a6ff1-c3a3-4e1d-86ae-b23549469a4f&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=0690f4f4a2f4e6898dbdafd3879db76a&#x26;sv=3" alt="" height="561" width="866">

6. Proceed to the [Add API Permissions](#add-api-permissions) section once complete

### Step 2: Add API Permissions

1. Go to ***API Permissions*** under your newly created Identity Intelligence Integration app
2. Select ***Add a permission***<br>

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2Fbc3vQ2QfhtXE72qBqUCY%2Fimage.png?alt=media&amp;token=96d11325-6ee2-4c45-bf4b-1425afc686b9" alt=""><figcaption></figcaption></figure>
3. Select ***Microsoft Graph***<br>

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2FdySiqA5HomykOZr5D3xg%2Fimage.png?alt=media&amp;token=1e814c15-9644-43ef-a2c1-b7e65d10c662" alt=""><figcaption></figcaption></figure>
4. Select ***Application Permissions***
   * NOTE - Permissions to be added below must <mark style="color:red;">**ALL**</mark> be of type **Application**
5. **Read-only permissions:** Please repeat steps 2 through 4 for all of the following permissions listed in step 6
6. Select the read permissions below based on your organization's Entra licensing. Be sure to include `ThreatHunting.Read.All` for Defender data

<table><thead><tr><th width="399.49609375">Read permission</th><th>Required Entra ID Licensing and Details</th></tr></thead><tbody><tr><td><code>Application.Read.All</code><br><code>AuditLog.Read.All</code><br><code>Directory.Read.All</code><br><code>Group.Read.All</code><br><code>GroupMember.Read.All</code><br><code>IdentityRiskEvent.Read.All</code><br><code>MailboxSettings.Read</code><br><code>Policy.Read.All</code><br><code>Reports.Read.All</code><br><code>Synchronization.Read.All</code><br><code>User.Read.All</code><br><code>UserAuthenticationMethod.Read.All</code></td><td>Requires Entra P1 or P2 license (or equivalent)<br>Enables Basic Entra data collection, which is required for integration to function</td></tr><tr><td><code>ThreatHunting.Read.All</code></td><td><strong>Microsoft Defender:</strong> Defender for Endpoint P2 and onboarded devices<br>Required for this integration</td></tr><tr><td><code>AgentCardManifest.Read.All</code><br><code>AgentIdentity.Read.All</code><br><code>AgentIdentityBlueprint.Read.All</code><br><code>AgentIdentityBlueprintPrincipal.Read.All</code><br><code>AgentInstance.Read.All</code></td><td>Requires E7 or Agent 365 licenses<br>Enables Entra agent data collection</td></tr><tr><td><code>IdentityRiskyAgent.Read.All</code><br><code>IdentityRiskyServicePrincipal.Read.All</code><br><code>IdentityRiskyUser.Read.All</code></td><td>Requires Entra P2 license<br>Enables ingestion of Entra Risky Event types</td></tr><tr><td><code>DeviceManagementApps.Read.All</code><br><code>DeviceManagementConfiguration.Read.All</code><br><code>DeviceManagementManagedDevices.Read.All</code></td><td>Requires Intune license<br>Enables ingestion of Intune managed devices</td></tr></tbody></table>

7. Once added to the list, select ***Add Permissions,*** then select ***Grant admin consent**.* Then select ***Yes***

<figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2FBWxPyMgpG7fLVTi0nvZl%2Fimage.png?alt=media&amp;token=8d665dca-dad7-42ca-b41b-628bd2cfdb7d" alt=""><figcaption></figcaption></figure>

8. Proceed to the [#create-api-secret](#create-api-secret "mention") section of the documentation

### Step 3: Create Client secret <a href="#create-api-secret" id="create-api-secret"></a>

1. Go to ***Certificates & Secrets*** under your Identity Intelligence Integration app
2. Select <mark style="color:blue;">**New client secret**</mark>
3. Fill in the description, such as "Identity Intelligence Integration", and the desired Expiration timeframe for the secret, (i.e. 12 months). Select ***Add***<br>

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2FJeJSm6Act7mXImSNuMNx%2Fimage.png?alt=media&amp;token=cae99a18-b727-460f-a682-2e758e18a5cd" alt=""><figcaption></figcaption></figure>
4. Select the **copy** icon to copy and save both the Secret ID and Secret Value to a secure location. These will be used later to finish the integration set up

   * <mark style="color:$warning;">**Important**</mark><mark style="color:$warning;">:</mark> Once you leave this page you **WILL NOT** be able to get the secret value again. If lost, you will have to delete and create a new one

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2FLVe7cjaLJ8jgzyjGGfZP%2Fimage.png?alt=media&amp;token=f19957b2-a6ab-4d38-8abb-68e03633fa60" alt=""><figcaption></figcaption></figure>
5. You can now proceed to the [#add-azure-a-d-integration-to-oort-dashboard](#add-azure-a-d-integration-to-oort-dashboard "mention")

### Step 4: Create Microsoft Defender Integration in Identity Intelligence <a href="#add-azure-a-d-integration-to-oort-dashboard" id="add-azure-a-d-integration-to-oort-dashboard"></a>

Finally, we will add the integration in the Identity Intelligence dashboard

1. Login to Identity Intelligence with an Identity Intelligence Admin role
2. Using the left hand menu bar, navigate to the **Integrations** page. Select the ***Add Integration*** button
3. Locate the Microsoft Defender integration tile and select the ***Add Integration*** button within that tile
4. Fill in the details for the Microsoft Defender Integration. Enter the values saved from earlier on in the Microsoft Entra ID setup for all fields except *Name*

   * *Name - The display name for the Defener Integration that will be used to recognize the integration throughout Identity Intelligence*
   * *Directory ID*
   * *Application ID*
   * *Secret ID*
   * *Secret VALUE*
   * \[If [Copilot Data Ingestion](#add-azure-a-d-integration-to-oort-dashboard) is enabled] *Add the Copilot environments with "Configured" status, taken from the output of the script in previous configuration step*

   <figure><img src="https://582105988-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPSBzsjxd7KYg9DNVZ4l%2Fuploads%2F4ssWPqfnh0pBCWFTrdf4%2FScreenshot%202026-10-13%20at%202.06.03%E2%80%AFPM.png?alt=media&amp;token=829a0a9d-4670-41f3-be56-d00f6ba14dcb" alt=""><figcaption></figcaption></figure>
5. Select **Connect** to test the connectivity. This may take a few minutes to complete
6. Once the connectivity test is successful, select **Save**. You will now see the integration listed on the Integrations page. Ensure that the integration's Connectivity Status is `Connected`
7. On the right hand side of the row for your Defender integration, select the **3-dot** button to open the pop-up menu. Select **Collect Now** to start the first data ingestion. You can also skip this step and it will happen automatically within the next 24 hours.
8. Congratulations, you have successfully set up the Microsoft Defender Integration!
