Skip to content

Commit d2c7ff7

Browse files
authored
Merge pull request #4879 from DeCohen/WI484153-manage-app-policies-remove-audit-mode
app policy audit mode is no longer available
2 parents 809f7ff + 0e5c8d2 commit d2c7ff7

File tree

2 files changed

+14
-33
lines changed

2 files changed

+14
-33
lines changed

CloudAppSecurityDocs/app-governance-app-policies-manage.md

Lines changed: 14 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
---
22
title: Manage app policies
3-
ms.date: 05/21/2023
3+
ms.date: 09/08/2025
44
ms.topic: how-to
55
description: Manage your app governance policies.
6+
ms.reviewer: shragar456
67
---
78

89
# Manage app policies
@@ -12,55 +13,35 @@ Use app governance to manage OAuth policies for Microsoft 365, Google Workspace,
1213
You might need to manage your app policies as follows to keep up-to-date with your organization's apps, respond to new app-based attacks, and for ongoing changes to your app compliance needs:
1314

1415
- Create new policies targeted at new apps
15-
- Change the status of an existing policy (active, inactive, audit mode)
16+
- Change the status of an existing policy (active or disable)
1617
- Change the conditions of an existing policy
1718
- Change the actions of an existing policy for auto-remediation of alerts
1819

19-
<a name='manage-oauth-app-policies-for-azure-ad'></a>
2020

21-
## Manage OAuth app policies for Microsoft Entra ID
22-
23-
Here's an example of a process for managing an existing policy for Microsoft Entra apps:
24-
25-
1. Edit the policy:
26-
27-
- Change the settings of the policy.
28-
- If needed, change the status to **Audit mode** for testing.
29-
30-
1. Check for expected behavior, such as alerts generated.
31-
1. If the behavior isn't expected, go back to step 1.
32-
1. If the behavior is expected, edit the policy and change its status to active (if needed).
33-
34-
For example:
35-
36-
:::image type="content" source="media/app-governance/mapg-manage-policy-process.png" alt-text="Diagram of the manage app policy workflow." lightbox="media/app-governance/mapg-manage-policy-process.png" border="false":::
21+
## Editing an app policy configuration
3722

38-
> [!NOTE]
39-
> Following the change in the **Activity type** filter, policies with the previous filter will have a "LEGACY" label attached to the filter and if the policies are edited or deleted the filter can't be restored.
23+
To change the configuration of a user defined app policy:
4024

41-
## Editing an app policy configuration
25+
1. Select the policy in the policy list, and then select **Edit** on the app policy pane.
4226

43-
To change the configuration of an existing app policy:
27+
1. In the **Edit policy** page, you can make the following changes:
4428

45-
- Select the policy in the policy list, and then select **Edit** on the app policy pane.
46-
- Select the vertical ellipses for the policy in the list, and then select **Edit**.
29+
- **Description**: Change the description to make it easier to understand the policy's purpose.
30+
- **Severity** : Change the severity for your app policy to low, medium, or high.
31+
- **Policy settings**: Change the set of apps to which the policy applies. You can also choose to use the existing conditions or modify the conditions
32+
- **Actions**: Change the autoremediation action for alerts generated by the policy.
33+
- **Status**: Change the policy status.
4734

48-
For the **Edit policy** page, step through the pages and make the appropriate changes:
35+
:::image type="content" source="media/app-governance-app-policies-manage/edit-user-defined-policy.png" alt-text="Screenshot that shows how to edit a user defined policy in the Defender portal. " lightbox="media/app-governance-app-policies-manage/edit-user-defined-policy.png":::
4936

50-
- **Description**: Change the description to make it easier to understand the policy's purpose.
51-
- **Severity**
52-
- **Policy settings**: Change the set of apps to which the policy applies. You can also choose to use the existing conditions or modify the conditions
53-
- **Actions**: Change the autoremediation action for alerts generated by the policy.
54-
- **Status**: Change the policy status.
5537

5638
## Deleting an app policy
5739

5840
To delete an app policy, you can:
5941

6042
- Select the policy in the policy list, and then select **Delete** on the app policy pane.
61-
- Select the vertical ellipses for the policy in the list, and then select **Delete**.
6243

63-
An alternative to deleting an app policy is to change its status to inactive. Once inactive, the policy doesn't generate alerts. For example, rather than deleting an app policy for an app with a specific set of conditions that are useful for a future policy, rename the app policy to indicate its usefulness and set its status to inactive. You can later return to the policy and modify it for a similar app and set its status to audit mode or inactive.
44+
An alternative to deleting an app policy is to change its status to disabled. Once disabled, the policy doesn't generate alerts. For example, rather than deleting an app policy for an app with a specific set of conditions that are useful for a future policy, rename the app policy to indicate its usefulness and set its status to disabled.
6445

6546
## Next steps
6647

167 KB
Loading

0 commit comments

Comments
 (0)