Skip to content

Commit ecde244

Browse files
committed
updated text
1 parent 17edacb commit ecde244

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

defender-xdr/microsoft-xdr-auditing.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Search the audit log for events in Microsoft Defender XDR
3-
description: Learn about the Microsoft Defender XDR activities that are logged in the Microsoft 365 audit log.
3+
description: Learn how to use the audit log to search for Microsoft Defender XDR activities to help with investigation.
44
ms.service: defender-xdr
55
ms.author: diannegali
66
author: diannegali
@@ -10,19 +10,21 @@ audience: ITPro
1010
ms.collection:
1111
- m365-security
1212
- tier3
13-
ms.topic: overview
13+
ms.topic: concept-article
1414
ms.date: 01/14/2025
1515
search.appverid: met150
1616
appliesto:
1717
- Microsoft Defender for Endpoint Plan 2
1818
- Microsoft Defender XDR
19+
20+
#customer intent: As a SOC analyst, I want to learn how to use the audit log to search for Microsoft Defender XDR activities to help with investigation.
1921
---
2022

2123
# Search the audit log for events in Microsoft Defender XDR
2224

2325
[!INCLUDE [Microsoft Defender XDR rebranding](../includes/microsoft-defender.md)]
2426

25-
The audit log can help you investigate specific activities across Microsoft 365 services. In the Microsoft Defender portal, Microsoft Defender XDR and Microsoft Defender for Endpoint activities are audited. Some of the activities audited are:
27+
The audit log helps you investigate specific activities across Microsoft 365 services. In the Microsoft Defender portal, Microsoft Defender XDR and Microsoft Defender for Endpoint activities are audited. Some of the activities audited are:
2628

2729
- Changes to data retention settings
2830
- Changes to advanced features
@@ -34,27 +36,25 @@ The audit log can help you investigate specific activities across Microsoft 365
3436

3537
For a complete list of Microsoft Defender XDR activities that are audited, see [Microsoft Defender XDR activities](#microsoft-defender-xdr-activities) and [Microsoft Defender for Endpoint activities](#microsoft-defender-for-endpoint-activities).
3638

37-
## Requirements
39+
Auditing is automatically turned on for Microsoft Defender XDR. Features that are audited are logged in the audit log automatically. Auditing can also collect audit logs from GCC environments.
40+
41+
## Prerequisites
3842

3943
To access the audit log, you need to have the **View-Only Audit Logs** or **Audit Logs** role in Exchange Online. By default, those roles are assigned to the Compliance Management and Organization Management role groups.
4044

4145
> [!NOTE]
4246
> Global administrators in Office 365 and Microsoft 365 are automatically added as members of the Organization Management role group in Exchange Online.
4347
44-
## Turn on auditing
45-
46-
Auditing is automatically turned on for Microsoft Defender XDR. Features that are audited are logged in the audit log automatically. Auditing can also collect audit logs from GCC environments.
47-
4848
Microsoft Defender XDR uses the [Microsoft Purview auditing solution](/purview/audit-solutions-overview). Before you can look at the audit data in the Microsoft Defender portal, you need to turn on auditing in the Microsoft Purview compliance portal. For more information, see [Turn auditing on or off](/purview/audit-log-enable-disable).
4949

5050
> [!IMPORTANT]
51-
> Global Administrator is a highly privileged role that should be limited to scenarios when you can't use an existing role. Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization.
51+
> Global Administrator is a highly privileged role that should be limited to scenarios when you can't use an existing role. Microsoft recommends that you use roles with the fewest permissions. Using accounts with lower permissions helps improve security for your organization.
5252
53-
## Using the audit search in Microsoft Defender XDR
53+
## Using audit search
5454

5555
Follow these steps to search the audit log:
5656

57-
1. To get audit logs for Microsoft Defender XDR activities, navigate to the [Microsoft Defender portal's Audit page](https://security.microsoft.com/auditlogsearch) or go to the [Purview compliance portal](https://compliance.microsoft.com) and select **Audit**.
57+
1. Navigate to the [Microsoft Defender portal's Audit page](https://security.microsoft.com/auditlogsearch) or go to the [Purview compliance portal](https://compliance.microsoft.com) and select **Audit**.
5858

5959
:::image type="content" source="/defender/media/defender/unified-audit-log-xdr.png" alt-text="Screenshot of the unified audit log page in Microsoft Defender XDR " lightbox="/defender/media/defender/unified-audit-log-xdr.png":::
6060

@@ -86,7 +86,7 @@ For a list of all events that are logged for user and admin activities in Micros
8686
- [Response action activities in Defender for Endpoint in the audit log](/purview/audit-log-activities#microsoft-defender-for-endpoint-reponse-actions-activities)
8787
- [Roles settings activities in Defender for Endpoint in the audit log](/purview/audit-log-activities#microsoft-defender-for-endpoint-roles-settings-activities)
8888

89-
## Using a PowerShell script
89+
## Search for events using a PowerShell script
9090

9191
You can use the following PowerShell code snippet to query the Office 365 Management API to retrieve information about Microsoft Defender XDR events:
9292

@@ -100,10 +100,10 @@ Search-UnifiedAuditLog -StartDate 2023/03/12 -EndDate 2023/03/20 -RecordType <ID
100100
>[!NOTE]
101101
> See the API column in Audit activities included for the record type values.
102102
103+
For more information, see [Use a PowerShell script to search the audit log](/purview/audit-log-search-script)
104+
103105
## See also
104106

105-
- [Search the audit log in the compliance center](/purview/audit-new-search)
106-
- [Use a PowerShell script to search the audit log](/purview/audit-log-search-script)
107107
- [Detailed properties in the audit log](/purview/audit-log-detailed-properties)
108108
- [Export, configure, and view audit log records](/purview/audit-log-export-records)
109109
- [Office 365 Management Activity API reference](/office/office-365-management-api/office-365-management-activity-api-reference)

0 commit comments

Comments
 (0)