Skip to content

Commit 2161d26

Browse files
authored
Merge branch 'main' into robmazz-portal
2 parents e6012c5 + 124254f commit 2161d26

File tree

87 files changed

+618
-698
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

87 files changed

+618
-698
lines changed

.openpublishing.redirection.defender-endpoint.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,16 @@
124124
"source_path": "defender-endpoint/non-windows.md",
125125
"redirect_url": "/defender-endpoint/microsoft-defender-endpoint",
126126
"redirect_document_id": true
127+
},
128+
{
129+
"source_path": "defender-endpoint/configure-endpoints-non-windows.md",
130+
"redirect_url": "/defender-endpoint/onboarding",
131+
"redirect_document_id": true
132+
},
133+
{
134+
"source_path": "defender-endpoint/configure-server-endpoints.md",
135+
"redirect_url": "/defender-endpoint/onboard-windows-server-2012r2-2016",
136+
"redirect_document_id": true
127137
}
128138
]
129139
}

CloudAppSecurityDocs/activity-filters-queries.md

Lines changed: 48 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ This article provides descriptions and instructions for Defender for Cloud Apps
1313

1414
## Activity filters
1515

16-
Below is a list of the activity filters that can be applied. Most filters support multiple values as well as *NOT* to provide you with a powerful tool for policy creation.
16+
Below is a list of the activity filters that can be applied. Most filters support multiple values and *NOT* to provide you with a powerful tool for policy creation.
1717

1818
- Activity ID - Search only for specific activities by their ID. This filter is useful when you connect Microsoft Defender for Cloud Apps to your SIEM (using the SIEM agent) and you want to further investigate alerts using Defender for Cloud Apps.
1919

@@ -30,7 +30,7 @@ Below is a list of the activity filters that can be applied. Most filters suppor
3030
- Activity type - Search for the app activity.
3131

3232
> [!NOTE]
33-
> Apps are added to the filter only if there is activity for that app.
33+
> Apps are added to the filter only if there's activity for that app.
3434
3535
- Administrative activity – Search only for administrative activities.
3636

@@ -56,7 +56,7 @@ Below is a list of the activity filters that can be applied. Most filters suppor
5656

5757
- IP address – The raw IP address, category, or tag from which the activity was performed.
5858
- Raw IP address - Enables you to search for activities that were performed on or by raw IP addresses. The raw IPs can equal, don't equal, start with, or don't start with a particular sequence.
59-
- IP category - The category of the IP address from which the activity was performed, for example, all activities from the administrative IP address range. The categories need to be configured to include the relevant IP addresses. Some IPs may be categorized by default. for example, there are IP addresses that are considered by Microsoft threat intelligence sources will be categorized as risky. To learn how to configure the IP categories, see [Organize the data according to your needs](ip-tags.md).
59+
- IP category - The category of the IP address from which the activity was performed, for example, all activities from the administrative IP address range. The categories need to be configured to include the relevant IP addresses. Some IPs might be categorized by default. for example, there are IP addresses that are considered by Microsoft threat intelligence sources will be categorized as risky. To learn how to configure the IP categories, see [Organize the data according to your needs](ip-tags.md).
6060
- IP tag - The tag of the IP address from which the activity was performed, for example, all activities from anonymous proxy IP addresses. Defender for Cloud Apps creates a set of built-in IP tags that aren't configurable. Additionally, you can configure your IP tags. For more information about configuring your IP tags, see [Organize the data according to your needs](ip-tags.md).
6161
The built-in IP tags include the following:
6262
- Microsoft apps (14 of them)
@@ -88,7 +88,7 @@ Below is a list of the activity filters that can be applied. Most filters suppor
8888
- User domain - Search for a specific user domain.
8989
- User organization - The organizational unit of the user who performed the activity, for example, all activities performed by EMEA_marketing users. This is only relevant for connected Google Workspace instances using organizational units.
9090
- User group - Specific user groups that you can import from connected apps, for example, Microsoft 365 administrators.
91-
- User name - Search for a specific username. To see a list of users in a specific user group, in the **Activity drawer**, select the name of the user group. Clicking will take you to the Accounts page, which lists all the users in the group. From there, you can drill down into the details of the accounts of specific users in the group.
91+
- User name - Search for a specific username. To see a list of users in a specific user group, in the **Activity drawer**, select the name of the user group. Clicking takes you to the Accounts page, which lists all the users in the group. From there, you can drill down into the details of the accounts of specific users in the group.
9292
- The **User group** and **User name** filters can be further filtered by using the **As** filter and selecting the role of the user, which can be any of the following:
9393
- Activity object only - meaning that the user or user group selected didn't perform the activity in question; they were the object of the activity.
9494
- Actor only - meaning that the user or user group performed the activity.
@@ -132,7 +132,7 @@ Defender for Cloud Apps also provides you with **Suggested queries**. Suggested
132132

133133
- Sharing activities - Filters all your activities to display only those activities that involve sharing folders and files, including creating a company link, creating an anonymous link, and granting read/write permissions.
134134

135-
- Successful log-in - Filters all your activities to display only those activities that involve successful sign-ins, including impersonate action, impersonate sign-in, single sign-o sign-ins, and sign-in from a new device.
135+
- Successful log in - Filters all your activities to display only those activities that involve successful sign-ins, including impersonate action, impersonate sign-in, single sign-o sign-ins, and sign-in from a new device.
136136

137137
![query activities.](media/queries-activity.png)
138138

@@ -162,22 +162,59 @@ For example:
162162

163163
![Filter after selecting investigate 6 months back.](media/filter-six-months-back.png)
164164

165-
#### Export activities six months back (Preview)
166165

167-
You can export all activities from up to six months by clicking the Export button in the top-left corner
166+
### Export activities six months back (Preview)
167+
168+
169+
You can export all activities from the past six months by clicking the Export button in the top-left corner of the Activity log page.
170+
168171
![Click the export icon to export records.](media/activity-filters-queries/export-button-of-activity-logs.png)
169172

173+
When exporting data:
170174

175+
- You can choose a date range of up to six months.
176+
- You can choose to exclude private activities.
177+
- The exported file is limited to 100,000 records and is delivered in CSV format.
171178

179+
Once the export is complete, the file is available under **Exported reports**.
172180

173-
When exporting data, you can choose a date range of up to six months, and have the ability to exclude private activities.
174-
The exported file is limited to 100,000 records and will be in CSV format.
181+
To access exported files and check export status, navigate to **Reports -> Cloud Apps** in Microsoft 365 Defender portal to view the status of the export process and access past exports.
175182

176-
The result file will be accessible under the **Exported reports**. Users can navigate to **Reports -> Cloud Apps** in Microsoft 365 Defender portal to view the status of the export process and access past exports.
177-
Reports that include private activities will be marked with an Eye icon in the reports page.
183+
Reports that include private activities are marked with an Eye icon in the reports page.
178184

179185
![eye-icon](media/activity-filters-queries/eye-icon-to-indicate-private-report.png)
180186

187+
> [!NOTE]
188+
>Exporting and viewing activity data up to six months back is restricted to specific roles with elevated permissions.
189+
190+
The following roles are supported:
191+
192+
- `INVITED_ADMIN`
193+
194+
- `GLOBAL_ADMINISTRATOR`
195+
196+
- `SECURITY_ADMINISTRATOR`
197+
198+
- `MCAS_ADMINISTRATOR`
199+
200+
- `DISCOVERY_ADMIN`
201+
202+
- `SECURITY_OPERATOR`
203+
204+
- `COMPLIANCE_ADMIN`
205+
206+
- `SECURITY_READER`
207+
208+
- `GLOBAL_READER`
209+
210+
- `URBAC_ROLES_GLOBAL_ADMINISTRATOR`
211+
212+
- `URBAC_ROLES_COMPLIANCE_ADMINISTRATOR`
213+
214+
- `URBAC_ROLES_SECURITY_READER`
215+
216+
- `URBAC_ROLES_SECURITY_OPERATOR`
217+
181218
## Next steps
182219

183220
> [!div class="nextstepaction"]

CloudAppSecurityDocs/index.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@ metadata:
1010
ms.service: defender-for-cloud-apps
1111
ms.topic: landing-page
1212
ms.collection: na
13-
author: batamig
14-
ms.author: bagol
1513
ms.date: 11/09/2021
1614

1715
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new

CloudAppSecurityDocs/network-requirements.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
22
title: Network requirements
33
description: This article describes the IP addresses and ports you need to open to work with Defender for Cloud Apps.
4-
ms.date: 04/04/2024
4+
ms.date: 04/06/2025
55
ms.topic: reference
66
---
77

88
# Network requirements
99

1010
>[!IMPORTANT]
1111
>
12-
> **Take Immediate Action by April, 21 2025**, to ensure optimal service quality and prevent the interruption of some services: Please update your firewall rules to allow outbound traffic on port 443 for the following IP addresses: 13.107.228.0/24, 13.107.229.0/24, 13.107.219.0/24, 13.107.227.0/24, 150.171.97.0/24. Alternatively, if you currently allow outbound traffic based on Azure service tags, please add the new Azure service tag, ‘AzureFrontDoor.MicrosoftSecurity’ to your allowlist. This tag will be adjusted to reflect the above range by April 21, 2025.
12+
> **Take Immediate Action by April, 21 2025**, to ensure optimal service quality and prevent the interruption of some services. Update your firewall rules to allow outbound traffic on port 443 for the following IP addresses: 13.107.228.0/24, 13.107.229.0/24, 13.107.219.0/24, 13.107.227.0/24, 150.171.97.0/24. Alternatively, if you currently allow outbound traffic based on Azure service tags, please add the new Azure service tag, ‘AzureFrontDoor.MicrosoftSecurity’ to your allowlist. This tag will be adjusted to reflect the above range by April 21, 2025.
13+
> This change only affects commercial customers of Microsoft Defender for Cloud Apps. Customers connected to the Gov US1 or GCC datacenters won't be affected.
1314
1415
This article provides a list of ports and IP addresses you need to allow and allowlist to work with Microsoft Defender for Cloud Apps.
1516

CloudAppSecurityDocs/release-notes.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,6 @@ ms.topic: overview
77

88
# What's new in Microsoft Defender for Cloud Apps
99

10-
>[!IMPORTANT]
11-
>
12-
> **Take Immediate Action by April, 21 2025**, to ensure optimal service quality and prevent the interruption of some services. This change will only affect your organization if you are using a firewall allowlist that restricts outbound traffic based on IP addresses or Azure service tags. Please update your firewall rules to allow outbound traffic on port 443 for the following IP addresses:13.107.228.0/24, 13.107.229.0/24, 13.107.219.0/24, 13.107.227.0/24, 150.171.97.0/24. Alternatively use as an additional Azure service tag, ‘AzureFrontDoor.MicrosoftSecurity’, that will be adjusted to reflect the above range by April 21, 2025. This update should be completed and the IP addresses or new Azure service tag added to your firewall's allowlist by April 21, 2025. Learn more: [Network requirements](https://aka.ms/MDANetworkDocs).
1310
>
1411
*Applies to: Microsoft Defender for Cloud Apps*
1512

@@ -23,6 +20,12 @@ For more information on what's new with other Microsoft Defender security produc
2320

2421
For news about earlier releases, see [Archive of past updates for Microsoft Defender for Cloud Apps](release-note-archive.md).
2522

23+
>[!IMPORTANT]
24+
>
25+
> **Take Immediate Action by April, 21 2025**, to ensure optimal service quality and prevent the interruption of some services. This change will only affect your organization if you're using a firewall allowlist that restricts outbound traffic based on IP addresses or Azure service tags. Update your firewall rules to allow outbound traffic on port 443 for the following IP addresses: 13.107.228.0/24, 13.107.229.0/24, 13.107.219.0/24, 13.107.227.0/24, 150.171.97.0/24. Alternatively use as an additional Azure service tag, ‘AzureFrontDoor.MicrosoftSecurity’, that will be adjusted to reflect the above range by April 21, 2025. This update should be completed and the IP addresses or new Azure service tag added to your firewall's allowlist by April 21, 2025.
26+
> This change only affects commercial customers of Microsoft Defender for Cloud Apps. Customers connected to the Gov US1 or GCC datacenters won't be affected.
27+
> Learn more: [Network requirements](https://aka.ms/MDANetworkDocs).
28+
2629

2730
## April 2025
2831

defender-endpoint/TOC.yml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -162,10 +162,12 @@
162162
- name: Onboard server devices
163163
href: onboard-server.md
164164
items:
165-
- name: Onboarding Windows Server overview
165+
- name: Onboard Windows Server version 1803, Windows Server 2019, and later
166166
href: onboard-windows-server.md
167-
- name: Onboard Windows Server 2012 R2, 2016, Semi-Annual Channel, 2019 and later
168-
href: configure-server-endpoints.md
167+
- name: Onboard Windows Server 2012 R2 and Windows Server 2016
168+
href: onboard-windows-server-2012r2-2016.md
169+
- name: Defender for Endpoint on Windows Server with SAP
170+
href: mde-sap-windows-server.md
169171
- name: Onboard Windows devices using Configuration Manager
170172
href: configure-endpoints-sccm.md
171173
- name: Onboard Windows devices using Group Policy
@@ -174,10 +176,8 @@
174176
href: configure-endpoints-script.md
175177
- name: Onboard non-persistent virtual desktop infrastructure (VDI) devices
176178
href: configure-endpoints-vdi.md
177-
- name: Defender for Endpoint on Windows Server with SAP
178-
href: mde-sap-windows-server.md
179-
- name: Onboard non-Windows devices
180-
href: configure-endpoints-non-windows.md
179+
- name: Direct onboarding with Defender for Cloud
180+
href: /azure/defender-for-cloud/onboard-machines-with-defender-for-endpoint?toc=/defender-endpoint/toc.json&bc=/defender-endpoint/breadcrumb/toc.json
181181
- name: Defender for Endpoint on macOS
182182
items:
183183
- name: Deploy Defender for Endpoint on macOS

defender-endpoint/advanced-features.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ This feature enables you to block potentially malicious files in your network. B
7474

7575
To turn **Allow or block** files on:
7676

77-
1. In the Microsoft Defender portal, in navigation pane, select **Settings** \> **Endpoints** \> **General** \> **Advanced features** \> **Allow or block file**.
77+
1. In the Microsoft Defender portal, in the navigation pane, select **Settings** \> **Endpoints** \> **General** \> **Advanced features** \> **Allow or block file**.
7878

7979
2. Toggle the setting between **On** and **Off**.
8080

@@ -129,8 +129,7 @@ Enabling the Skype for Business integration gives you the ability to communicate
129129

130130
Enabling this setting forwards Defender for Endpoint signals to Microsoft Defender for Cloud Apps to provide deeper visibility into cloud application usage. Forwarded data is stored and processed in the same location as your Defender for Cloud Apps data.
131131

132-
> [!NOTE]
133-
> This feature will be available with an E5 license for [Enterprise Mobility + Security](https://www.microsoft.com/cloud-platform/enterprise-mobility-security) on devices running Windows 10, version 1709 (OS Build 16299.1085 with [KB4493441](https://support.microsoft.com/help/4493441)), Windows 10, version 1803 (OS Build 17134.704 with [KB4493464](https://support.microsoft.com/help/4493464)), Windows 10, version 1809 (OS Build 17763.379 with [KB4489899](https://support.microsoft.com/help/4489899)), later Windows 10 versions, or Windows 11.
132+
For more information, see [Microsoft Defender for Cloud Apps overview](/defender-cloud-apps/what-is-defender-for-cloud-apps).
134133

135134
## Web content filtering
136135

defender-endpoint/api/device-health-api-methods-properties.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Retrieves a list of Microsoft Defender Antivirus device health details. This API
5050
Data that is collected using either `JSON response` or by using files is a snapshot of the current state. This data doesn't contain historical data. To collect historical data, you must save the data in your own data storage.
5151

5252
> [!IMPORTANT]
53-
> For Windows Server 2012 R2 and Windows Server 2016 to appear in device health reports, these devices must be onboarded using the modern unified solution package. For more information, see [New functionality in the modern unified solution for Windows Server 2012 R2 and 2016](../configure-server-endpoints.md#functionality-in-the-modern-unified-solution).
53+
> For Windows Server 2012 R2 and Windows Server 2016 to appear in device health reports, these devices must be onboarded using the modern unified solution package. For more information, see [New functionality in the modern unified solution for Windows Server 2012 R2 and 2016](../onboard-windows-server-2012r2-2016.md#functionality-in-the-modern-unified-solution).
5454
>
5555
> For information about using the **Device health and antivirus compliance** reporting tool in the Microsoft Defender portal, see: [Device health and antivirus report in Microsoft Defender for Endpoint](../device-health-reports.md).
5656

defender-endpoint/api/device-health-export-antivirus-health-report-api.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Data that is collected using either '_JSON response_ or _via files_' is the curr
4848

4949
> [!IMPORTANT]
5050
>
51-
> For Windows Server 2012 R2 and Windows Server 2016 to appear in device health reports, these devices must be onboarded using the modern unified solution package. For more information, see [New functionality in the modern unified solution for Windows Server 2012 R2 and 2016](../configure-server-endpoints.md#functionality-in-the-modern-unified-solution).
51+
> For Windows Server 2012 R2 and Windows Server 2016 to appear in device health reports, these devices must be onboarded using the modern unified solution package. For more information, see [New functionality in the modern unified solution for Windows Server 2012 R2 and 2016](../onboard-windows-server-2012r2-2016.md#functionality-in-the-modern-unified-solution).
5252
5353
> [!NOTE]
5454
>

defender-endpoint/application-deployment-via-mecm.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ Copy the unified solution package, onboarding script, and migration script to th
126126
- [Microsoft Monitoring Agent Setup](/services-hub/health/mma-setup)
127127
- [Deploy applications - Configuration Manager](/mem/configmgr/apps/deploy-use/deploy-applications)
128128
- [Microsoft Defender for Endpoint - Configuration Manager](/mem/configmgr/protect/deploy-use/defender-advanced-threat-protection)
129-
- [Onboard Windows servers to the Microsoft Defender for Endpoint service](configure-server-endpoints.md)
129+
- [Onboard servers through Microsoft Defender for Endpoint's onboarding experience](onboard-server.md)
130130
- [Microsoft Defender for Endpoint: Defending Windows Server 2012 R2 and 2016](https://techcommunity.microsoft.com/t5/microsoft-defender-for-endpoint/defending-windows-server-2012-r2-and-2016/ba-p/2783292)
131131
132132
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]

0 commit comments

Comments
 (0)