Skip to content

Commit 204702a

Browse files
Merge pull request #4340 from MicrosoftDocs/main
[AutoPublish] main to live - 06/26 01:35 PDT | 06/26 14:05 IST
2 parents 5c66f2a + cd2cf8a commit 204702a

10 files changed

+29
-18
lines changed

CloudAppSecurityDocs/activity-filters.md

Lines changed: 26 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,45 @@
11
---
22
title: Investigate activities
33
description: This article provides a list of activities, filters, and match parameters that can be applied to activity policies.
4-
ms.date: 01/29/2023
4+
ms.date: 06/24/2025
55
ms.topic: how-to
66
---
77

88
# Investigate activities
99

1010

11-
1211
Microsoft Defender for Cloud Apps gives you visibility into all the activities from your connected apps. After you connect Defender for Cloud Apps to an app using the App connector, Defender for Cloud Apps scans all the activities that happened - the retroactive scan period differs per app - and then it's updated constantly with new activities.
1312

1413
> [!NOTE]
15-
> For a full list of Microsoft 365 activities monitored by Defender for Cloud Apps, see [Search the audit log in the compliance center](/microsoft-365/compliance/search-the-audit-log-in-security-and-compliance#audited-activities).
14+
> The activity types (such as `FileCreated`, `FileCreatedOnNetworkShare`, `ArchiveCreated`, or `FileDeleted`) and their associated data are sourced directly from the connected app’s third-party API (for example, Salesforce or ServiceNow).
15+
>
16+
> Microsoft Defender for Cloud Apps displays these activity names and types exactly as received and doesn't define or modify them. To understand the meaning of an activity, refer to the relevant third‑party API documentation.
17+
18+
For a full list of Microsoft 365 activities monitored by Defender for Cloud Apps, see [Search the audit log in the Microsoft Purview portal](/microsoft-365/compliance/search-the-audit-log-in-security-and-compliance#audited-activities).
19+
1620

1721
The **Activity log** can be filtered to enable you to find specific activities. You create policies based on the activities and then define what you want to be alerted about and act on. You can search for activities performed on certain files. The type of activities and the information we get for each activity depends on the app and what kind of data the app can provide.
1822

1923
For example, you can use the **Activity log** to find users in your organization who are using operating systems or browsers that are out of date, as follows:
2024
After you connect an app to Defender for Cloud Apps in the **Activity log** page, use the advanced filter and select **User agent tag**. Then select **Outdated browser** or **Outdated operating system**.
2125

22-
![Activity outdated browser example.](media/activity-example-outdated.png)
26+
:::image type="content" source="media/activity-filters/activity-example-outdated.png" alt-text="Screenshot that shows the Activity log with an outdated browser example." lightbox="media/activity-filters/activity-example-outdated.png":::
27+
2328

2429
The basic filter provides great tools to start filtering your activities.
2530

26-
![basic activity log filter.](media/activity-log-filter-basic.png)
31+
:::image type="content" source="media/activity-filters/activity-log-filter-basic.png" alt-text="Screenshot that shows the basic activity log filter." lightbox="media/activity-filters/activity-log-filter-basic.png":::
32+
2733

2834
You can expand the basic filter by selecting **Advanced filters** to drill down into more specific activities.
2935

30-
![advanced activity log filter.](media/activity-log-filter-advanced.png)
36+
:::image type="content" source="media/activity-log-filter-advanced.png" alt-text="Screenshot that shows the advanced activity log filter.":::
37+
3138

3239
> [!NOTE]
3340
>
34-
> - The Legacy tag is added to any activity policy that uses the older "user" filter. This filter will continue to work as usual. If you want to remove the Legacy tag, you can remove the filter and add the filter again using the new **User name** filter.
35-
>
36-
> - In some rare cases, the count of the events presented in the activity log may show a slightly higher number than the real number of events that apply for the filter and being presented.
41+
> - The Legacy tag is added to any activity policy that uses the older "user" filter. This filter continues to work as usual. If you want to remove the Legacy tag, you can remove the filter and add the filter again using the new **User name** filter.
42+
> - In some rare cases, the count of the events presented in the activity log might show a slightly higher number than the real number of events that apply for the filter and being presented.
3743
3844
## The Activity drawer
3945

@@ -53,7 +59,7 @@ You can view more information about each activity, by selecting the Activity its
5359

5460
- IP address category and tags: Select the IP tag to view the list of IP tags found in this activity. You can then filter by all activities matching this tag.
5561

56-
The fields in the Activity drawer provide contextual links to additional activities and drill-downs you may want to perform from the drawer directly. For example, if you move your cursor next to the IP address category, you can use the **add to filter** icon ![add to filter.](media/add-to-filter-icon.png) to immediately add the IP address to the current page's filter. You can also use the settings cog icon ![settings icon](media/contextual-settings-icon.png) that pops up to arrive directly at the settings page necessary to modify the configuration of one of the fields, such as **User groups**.
62+
The fields in the Activity drawer provide contextual links to additional activities and drill-downs you might want to perform from the drawer directly. For example, if you move your cursor next to the IP address category, you can use the **add to filter** icon ![add to filter.](media/activity-filters/add-to-filter-icon.png) to immediately add the IP address to the current page's filter. You can also use the settings cog icon ![settings icon](media/activity-filters/contextual-settings-icon.png) that pops up to arrive directly at the settings page necessary to modify the configuration of one of the fields, such as **User groups**.
5763

5864
You can also use the icons at the top of the tab to:
5965

@@ -63,7 +69,9 @@ You can also use the icons at the top of the tab to:
6369
- View activities from the exact geographic location
6470
- View activities from the same period (48 hours)
6571

66-
![activity drawer.](media/activity-drawer.png "activity drawer")
72+
73+
:::image type="content" source="media/activity-filters/activity-drawer.png" alt-text="Screenshot that shows the activity drawer." lightbox="media/activity-filters/activity-drawer.png":::
74+
6775

6876
For a list of governance actions available, see [Activity governance actions](governance-actions.md#activity-governance-actions).
6977

@@ -84,7 +92,8 @@ Selecting it opens the Activity drawer **User** tab provides the following insig
8492
- **ISPs**: The number of ISPs the user connected from in the past 30 days.
8593
- **IP addresses**: The number of IP addresses the user connected from in the past 30 days.
8694

87-
![user insights in Defender for Cloud Apps.](media/user-insights.png)
95+
:::image type="content" source="media/user-insights.png" alt-text="Screenshot that shows user insights, user activities and frequent alert locations for Defender for Cloud apps." lightbox="media/user-insights.png":::
96+
8897

8998
#### IP address insights
9099

@@ -112,10 +121,11 @@ To view IP address insights:
112121
- Set as a VPN IP address and add to allowlist
113122
- Set as a Risky IP and add to blocklist
114123

115-
![IP address insights in Defender for Cloud Apps.](media/ip-address-insights.png)
124+
:::image type="content" source="media/activity-filters/ip-address-insights.png" alt-text="Screenshot that shows Ip address activities over the last 30 days." lightbox="media/activity-filters/ip-address-insights.png":::
125+
116126

117127
> [!NOTE]
118-
>- Internal IPv4 or IPv6 IP addresses audited by the cloud applications connected with API, may indicate internal services communications within the network of the cloud application, and shouldn't be confused with internal IPs from the source network the device connected from, as the cloud application is not exposed to the internal IPs of the devices.
128+
>- Internal IPv4 or IPv6 IP addresses audited by the cloud applications connected with API, might indicate internal services communications within the network of the cloud application, and shouldn't be confused with internal IPs from the source network the device connected from, as the cloud application isn't exposed to the internal IPs of the devices.
119129
>- To avoid raising [impossible travel](anomaly-detection-policy.md#impossible-travel) alerts when employees connect from their home locations via the corporate VPN, it's recommended to tag the IP address as **VPN**.
120130
121131
## Export activities
@@ -124,7 +134,8 @@ You can export all user activities to a CSV file.
124134

125135
In the **Activity log**, select the **Export** button in the top-left corner.
126136

127-
![export button.](media/export-button.png)
137+
:::image type="content" source="media/activity-filters/export-button.png" alt-text="Screenshot that shows the export button in the Activity log.":::
138+
128139

129140
[!INCLUDE [Handle personal data](../includes/gdpr-intro-sentence.md)]
130141

CloudAppSecurityDocs/data-protection-policies.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -268,7 +268,7 @@ You can view more information about each file, by selecting the file itself in t
268268
- **Matched policies** - See a list of policies the file matched.
269269
- **Sensitivity labels** - View the list of sensitivity labels from Microsoft Purview Information Protection found in this file. You can then filter by all files matching this label.
270270

271-
The fields in the File drawer provide contextual links to files and drill downs you might want to perform from the drawer directly. For example, if you move your cursor next to the **Owner** field, you can use the "add to filter" icon ![add to filter.](media/add-to-filter-icon.png) to add the owner immediately to the filter of the current page. You can also use the settings cog icon ![settings icon.](media/contextual-settings-icon.png) that pops up to arrive directly at the settings page necessary to modify the configuration of one of the fields, such as **Sensitivity labels**.
271+
The fields in the File drawer provide contextual links to files and drill downs you might want to perform from the drawer directly. For example, if you move your cursor next to the **Owner** field, you can use the "add to filter" icon ![add to filter.](media/activity-filters/add-to-filter-icon.png) to add the owner immediately to the filter of the current page. You can also use the settings cog icon ![settings icon.](media/activity-filters/contextual-settings-icon.png) that pops up to arrive directly at the settings page necessary to modify the configuration of one of the fields, such as **Sensitivity labels**.
272272

273273
:::image type="content" source="media/file-policies/file-drawer.png" alt-text="Screenshot showing the file drawer" lightbox="media/file-policies/file-drawer.png":::
274274

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

CloudAppSecurityDocs/session-policy-aad.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -173,8 +173,8 @@ To export Cloud discovery logs from the cloud discovery dashboard:
173173

174174
1. Above the table, select the export button. For example:
175175

176-
![Screenshot of the export button.](media/export-button.png)
177-
176+
:::image type="content" source="media/activity-filters/export-button.png" alt-text="Screenshot that shows the export button.":::
177+
178178

179179
1. Select the range of the report and select **Export**. This process may take some time.
180180

0 commit comments

Comments
 (0)