You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CloudAppSecurityDocs/access-policy-aad.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,7 @@ title: Create access policies | Microsoft Defender for Cloud Apps
3
3
description: Learn how to configure Microsoft Defender for Cloud Apps access policies with Conditional Access app control to control access to cloud apps.
4
4
ms.date: 05/15/2024
5
5
ms.topic: how-to
6
+
ms.reviewer: AmitMishaeli
6
7
---
7
8
# Create Microsoft Defender for Cloud Apps access policies
Copy file name to clipboardExpand all lines: CloudAppSecurityDocs/activity-filters.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,7 @@ title: Investigate activities
3
3
description: This article provides a list of activities, filters, and match parameters that can be applied to activity policies.
4
4
ms.date: 06/24/2025
5
5
ms.topic: how-to
6
+
ms.reviewer: gayasalomon
6
7
---
7
8
8
9
# Investigate activities
@@ -15,7 +16,7 @@ Microsoft Defender for Cloud Apps gives you visibility into all the activities f
15
16
>
16
17
> 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
18
-
The action types for events and activities are determined by the source service, whether it is a first-party or third-party service. Microsoft Defender for Cloud Apps (MDA) supports a wide range of action types and is not restricted to specific ones.
19
+
The action types for events and activities are determined by the source service, whether it's a first-party or third-party service. Microsoft Defender for Cloud Apps (MDA) supports a wide range of action types and isn't restricted to specific ones.
19
20
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).
20
21
21
22
@@ -93,7 +94,7 @@ Selecting it opens the Activity drawer **User** tab provides the following insig
93
94
- **ISPs**: The number of ISPs the user connected from in the past 30 days.
94
95
- **IP addresses**: The number of IP addresses the user connected from in the past 30 days.
95
96
96
-
:::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":::
97
+
:::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":::
97
98
98
99
99
100
#### IP address insights
@@ -122,7 +123,7 @@ To view IP address insights:
122
123
- Set as a VPN IP address and add to allowlist
123
124
- Set as a Risky IP and add to blocklist
124
125
125
-
:::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":::
126
+
:::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":::
Copy file name to clipboardExpand all lines: CloudAppSecurityDocs/anomaly-detection-policy.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,7 @@ title: Create anomaly detection policies | Microsoft Defender for Cloud Apps
3
3
description: This article provides a description of Anomaly detection policies and provides reference information about the building blocks of an anomaly detection policy.
4
4
ms.date: 03/01/2023
5
5
ms.topic: how-to
6
+
ms.reviewer: Ronen-Refaeli
6
7
---
7
8
8
9
# Create Defender for Cloud Apps anomaly detection policies
Copy file name to clipboardExpand all lines: CloudAppSecurityDocs/api-activities-investigate-script.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,7 @@ title: Investigate activities using the API
3
3
description: This article provides information on how to use the API to investigate user activity in Defender for Cloud Apps.
4
4
ms.date: 01/29/2023
5
5
ms.topic: how-to
6
+
ms.reviewer: Naama-Goldbart
6
7
---
7
8
# Investigate activities using the API
8
9
@@ -18,7 +19,7 @@ The activities API mode is optimized for scanning and retrieval of large quantit
18
19
## To use the activity scan script
19
20
20
21
1. Run the query on your data.
21
-
1. If there are more records than could be listed in a single scan, you will get a return command with `nextQueryFilters` that you should run. You will get this command each time you scan until the query has returned all the results.
22
+
1. If there are more records than could be listed in a single scan, you'll get a return command with `nextQueryFilters` that you should run. You'll get this command each time you scan until the query has returned all the results.
22
23
23
24
## Request body parameters
24
25
@@ -32,9 +33,9 @@ The activities API mode is optimized for scanning and retrieval of large quantit
32
33
33
34
## Response parameters
34
35
35
-
- "data": the returned data. Will contain up to "limit" number of records each iteration. If there are more records to be pulled (hasNext=true), the last few records will be dropped to ensure that all data is listed only once.
36
+
- "data": the returned data. Will contain up to "limit" number of records each iteration. If there are more records to be pulled (hasNext=true), the last few records are dropped to ensure that all data is listed only once.
36
37
- "hasNext": Boolean. Denotes whether another iteration on the data is needed.
37
-
- "nextQueryFilters": If another iteration is needed, it contains the consecutive JSON query to be run. Use this as the "filters" parameter in the next request. Note that if the "hasNext" parameter is set to False, this parameter will be missing since you've iterated over all of the data.
38
+
- "nextQueryFilters": If another iteration is needed, it contains the consecutive JSON query to be run. Use this as the "filters" parameter in the next request. If the "hasNext" parameter is set to False, this parameter will be missing since you've iterated over all of the data.
38
39
39
40
The following Python example gets all the activities from the past day from Exchange Online.
Copy file name to clipboardExpand all lines: CloudAppSecurityDocs/app-activity-threat-hunting.md
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,9 @@
1
1
---
2
2
title: Hunt for threats in app activities | Microsoft Defender for Cloud Apps
3
-
ms.date: 05/23/2025
3
+
ms.date: 08/18/2025
4
4
ms.topic: how-to
5
5
description: Learn how app governance in Microsoft Defender for Cloud Apps helps you hunt for resources accessed and activities carried out by apps in your environment.
Copy file name to clipboardExpand all lines: CloudAppSecurityDocs/app-governance-app-policies-create.md
+15-13Lines changed: 15 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,8 @@
1
1
---
2
2
title: Create app governance policies | Microsoft Defender for Cloud Apps
3
-
ms.date: 05/28/2023
3
+
ms.date: 08/12/2025
4
4
ms.topic: how-to
5
+
ms.reviewer: shragar
5
6
description: Learn how to create app policies on app governance.
6
7
---
7
8
@@ -25,7 +26,7 @@ Use app governance to create OAuth policies for apps connected to Microsoft 365,
25
26
26
27
For apps connected to Microsoft Entra ID, create app policies from provided templates that can be customized, or create your own custom app policy.
27
28
28
-
1. To create a new app policy for Microsoft 365 apps, go to **Microsoft Defender XDR**\>**App governance**\>**Policies**\>**Microsoft 365**.
29
+
1. To create a new app policy for Microsoft 365 apps, go to **Microsoft Defender XDR**\>**App governance**\>**Policies**\>**Microsoft 365**.
29
30
30
31
For example:
31
32
@@ -38,7 +39,7 @@ For apps connected to Microsoft Entra ID, create app policies from provided temp
38
39
39
40
For example:
40
41
41
-
:::image type="content" source="media/app-governance/app-governance-create-policy.png" alt-text="Screenshot of a Choose a policy template page.":::
42
+
:::image type="content" source="media/app-governance/app-governance-create-policy.png" alt-text="Screenshot showing the 'Choose a policy template' interface." lightbox="media/app-governance/app-governance-create-policy.png":::
42
43
43
44
## App policy templates
44
45
@@ -87,17 +88,18 @@ Use a custom app policy when you need to do something not already done by one of
87
88
- Medium
88
89
- Low
89
90
90
-
2. On the **Choose Policy settings and conditions** page, for **Choose which apps this policy is applicable for**, select:
91
+
1. On the **Choose Policy settings and conditions** page, for **Choose which apps this policy is applicable for**, select:
91
92
- All Apps
92
93
- Choose specific apps
93
94
- All apps except
94
95
95
-
3. If you choose specific apps, or all apps except for this policy, select **Add apps** and select the desired apps from the list. In the **Choose apps** pane, you can select multiple apps to which this policy applies, and then select **Add**. Select **Next** when you're satisfied with the list.
96
+
1. If you choose specific apps, or all apps except for this policy, select **Add apps** and select the desired apps from the list. In the **Choose apps** pane, you can select multiple apps to which this policy applies, and then select **Add**. Select **Next** when you're satisfied with the list.
96
97
97
-
4. Select **Edit conditions**. Select **Add condition** and choose a condition from the list. Set the desired threshold for your selected condition. Repeat to add more conditions. Select **Save** to save the rule, and when you're finished adding rules, select **Next**.
98
+
1. Select **Edit conditions** > **Add condition** and choose a condition from the list. Set the desired threshold for your selected condition. Repeat to add more conditions.
99
+
1. Select **Save** to save the rule, and when you're finished adding rules, select **Next**.
98
100
99
101
> [!NOTE]
100
-
> Some policy conditions are only applicable to apps that access Graph API permissions. When evaluating apps that access only non-Graph APIs, app governance skips these policy conditions and proceed to check only other policy conditions.
102
+
> Some policy conditions are only applicable to apps that access Graph API permissions. When evaluating apps that access only non-Graph APIs, app governance skips these policy conditions and proceeds to check only other policy conditions.
101
103
102
104
1. Here are the available conditions for a custom app policy:
103
105
@@ -127,16 +129,16 @@ Use a custom app policy when you need to do something not already done by one of
127
129
128
130
All of the specified conditions must be met for this app policy to generate an alert.
129
131
130
-
6. When you're done specifying the conditions, select **Save**, and then select **Next**.
132
+
1. When you're done specifying the conditions, select **Save**, and then select **Next**.
131
133
132
-
7. On the **Define Policy Actions** page, select **Disable app** if you want app governance to disable the app when an alert based on this policy is generated, and then select **Next**. Use caution when applying actions because a policy may affect users and legitimate app use.
134
+
1. On the **Define Policy Actions** page, select **Disable app** if you want app governance to disable the app when an alert based on this policy is generated, and then select **Next**. Use caution when applying actions because a policy may affect users and legitimate app use.
133
135
134
-
8. On the **Define Policy Status** page, select one of these options:
136
+
1. On the **Define Policy Status** page, select one of these options:
135
137
-**Audit mode**: Policies are evaluated but configured actions won't occur. Audit mode policies appear with the status of **Audit** in the list of policies. You should use Audit mode for testing a new policy.
136
138
-**Active**: Policies are evaluated and configured actions will occur.
137
139
-**Inactive**: Policies aren't evaluated and configured actions won't occur.
138
140
139
-
9. Carefully review all parameters of your custom policy. Select **Submit** when you're satisfied. You can also go back and change settings by selecting **Edit** beneath any of the settings.
141
+
1. Carefully review all parameters of your custom policy. Select **Submit** when you're satisfied. You can also go back and change settings by selecting **Edit** beneath any of the settings.
140
142
141
143
## Test and monitor your new app policy
142
144
@@ -153,9 +155,9 @@ Here's an example of a process for creating a new policy, testing it, and then m
153
155
3. If the behavior isn't expected, edit the policy apps, conditions, and action settings as needed and go back to step 2.
154
156
4. If the behavior is expected, edit the policy and change its status to **Active**.
155
157
156
-
For example, the following flow chart shows the steps involved:
158
+
For example, the following flow chart shows the steps involved:
157
159
158
-
:::image type="content" source="media/app-governance/mapg-create-new-policy-process.png" alt-text="Diagram of the create app policy workflow." lightbox="media/app-governance/mapg-create-new-policy-process.png" border="false":::
160
+
:::image type="content" source="media/app-governance/mapg-create-new-policy-process.png" alt-text="Screenshot illustrating the steps involved in the create app policy workflow." lightbox="media/app-governance/mapg-create-new-policy-process.png" border="false":::
159
161
160
162
## Create a new policy for OAuth apps connected to Salesforce and Google Workspace
0 commit comments