Microsoft Entra ID
General

Manage App Consent Policies

In brief

The app consent policies documentation now uses a corrected Markdown link to the Permission grant condition sets reference.

What Entra admins need to know

Administrators can access the related reference more reliably; no configuration changes are required.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

App consent policy segments

An app consent policy consists of one or more "include" condition sets and zero or more "exclude" condition sets. For an event to be considered in an app consent policy, it must match at least one "include" condition set, and must not match any "exclude" condition set. The exclusion and inclusions are used to determine whether the actor affected by the given policy can grant consent or not.

There are three main parts of app consent policies:

  • Metadata: Properties of an app consent policy hold information such as the ID, the description, and the display name of the consent policy.

  • Included condition sets: A collection of condition sets that a given app consent request must match at least one of for the policy to pass. This collection must have at least one condition set. Each condition set contains rules that describe characteristics of an app consent request, such as verified publisher status, permissions requested, and more.

  • Excluded condition sets: A collection of condition sets that a given app consent request shouldn't match any of to pass. This collection can be empty (it can contain zero excluded condition sets). Each condition set contains rules that describe characteristics of an app consent request, such as verified publisher status, permissions requested, and more.

    • Privileged Role Administrator directory role
    • A custom directory role with the necessary permissions to manage app consent policies
    • The Microsoft Graph app role (application permission) Policy.ReadWrite.PermissionGrant when connecting as an app or a service
  • Familiarize yourself with (Permission grant condition sets)[/graph/api/resources/permissiongrantconditionset?view=graph-rest-1.0]Permission grant condition sets :::zone pivot="ms-powershell"

To manage app consent policies for applications with Microsoft Graph PowerShell, connect to Microsoft Graph PowerShell. DisplayName = "My first custom consent policy" Description = "This is a sample custom app consent policy." }

New-MgPolicyPermissionGrantPolicy @params


```http
POST https://graph.microsoft.com/v1.0/policies/permissionGrantPolicies/{ my-custom-policy }/includes
Content-Type: application/json

{
  "permissionType": "delegated",
  "PermissionClassification": "low",
```http
POST https://graph.microsoft.com/v1.0/policies/permissionGrantPolicies/my-custom-policy /excludes
Content-Type: application/json

{
  "permissionType": "delegated",
  "resourceApplication": "00001111-aaaa-2222-bbbb-3333cccc4444 "
Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…