Microsoft Endpoint Defender
Visualize Microsoft Endpoint Defender resources, map Endpoint Defender users to employees, and monitor changes through queries and alerts.
- Installation guide
- Microsoft Endpoint Defender data model
To use this integration, you must have:
- An Azure account with an App Registration to provide credentials for the JupiterOne integration to authenticate with Microsoft Graph APIs. The App Registration also defines the permissions the integration requires and which the target tenant must authorize.
- An Active Directory tenant to target for data ingestion. It is possible to target the Active Directory tenants defined in the Azure account holding the App Registration.
- A Microsoft Defender for Endpoint account to create devices and run attacks via simulation technique, which can track vulnerabilities data, user groups creation and mapping users to devices.
Configuration in Microsoft Defender for Endpoint
In Microsoft Defender for Endpoint:
- Create a Microsoft Defender for Endpoint account.
- Add devices.
In the Azure Portal
- Navigate to App Registrations.
- Click New Registration.
- Enter a name for the app.
- Select the supported account type.
- Click Register.
Add API permissions
In your new app registration, go to API Permissions under Manage in the left-side panel.
- If your app has already been assigned the
User.Read permission, remove it using the context menu. It is not needed for the integration to run.
- If a warning appears saying "This scope is required for proper application functionality.", it can be safely ignored.
- Click Add a permission > Microsoft Graph.
- When presented with "What type of permissions does your application require?", select Application permissions.
- Add the
- Click Add permissions.
- Click Add a permission again.
- Under APIs my organization uses, search "WindowsDefenderATP" and click the result.
- When presented with "What type of permissions does your application require?", select Application permissions and add the following:
- Click Add permission.
- Grant admin consent for the API permissions.
Add Client Secret
- In your app registration, click Certificates & secrets.
- Under Client Secrets, click New client secret.
- Add a description for the secret.
- Select a secret expiration that matches your needs for secret rotation.
- Click Add.
- Copy the secret value using the Copy to Clipboard icon (highlighting and copying will not copy the full value).
Granted API Permissions usage
- Read organization information
- Needed for creating the Account entity
- Read directory data
- Needed for creating User, Group, and GroupUser entities
- Read machine information
- Needed for creating Device and HostAgent entities
- Read user profiles
- Needed for creating User entities
- Read Threat and Vulnerability Management vulnerability information
- Needed for creating Vulnerability entity
Finalize in JupiterOne
To install the Microsoft Defender for Endpoint integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Microsoft Defender for Endpoint. Click New Instance to begin configuring your integration.
Creating a configuration requires the following:
The Account Name used to identify the Microsoft Defender for Endpoint account in JupiterOne. Ingested entities will have this value stored in
AccountNametoggle is enabled.
Description to assist in identifying the integration instance, if desired.
Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as
DISABLEDand manually execute the integration.
Client Secret value that you copied earlier.
Tenant (Directory ID) and Client ID (Application ID), located in your App Registration's Overview tab.
Click Create once all values are provided to finalize the integration.
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
The following entities are created:
|Resources||Entity ||Entity |
The following relationships are created:
|Source Entity ||Relationship ||Target Entity |
The following mapped relationships are created:
|Source Entity ||Relationship ||Target Entity ||Direction|