RoleManagement.ReadWrite.DirectoryMicrosoft Graph permission · Critical risk
Allows the app to read and manage the role-based access control (RBAC) settings for your company's directory, without a signed-in user. This includes instantiating directory roles and managing directory role membership, and reading directory role templates, directory roles and memberships.
Application permission
Critical riskRead and write all directory RBAC settings. Allows the app to read and manage the role-based access control (RBAC) settings for your company's directory, without a signed-in user. This includes instantiating directory roles and managing directory role membership, and reading directory role templates, directory roles and memberships.
| ID | 9e3f62cf-ca93-4989-b6ce-bf83c28f9fe8 |
|---|---|
| Consent | Always needs admin consent |
| Risk | Can be used to take over the tenant or grant itself more access. Grant only to tightly controlled, well-known apps. |
Delegated permission
Critical riskRead and write directory RBAC settings. Allows the app to read and manage the role-based access control (RBAC) settings for your company's directory, on behalf of the signed-in user. This includes instantiating directory roles and managing directory role membership, and reading directory role templates, directory roles and memberships.
| ID | d01b97e9-cbc0-49fe-810a-750afd5527a3 |
|---|---|
| Consent | Needs admin consent |
| Risk | Can be used to take over the tenant or grant itself more access. Grant only to tightly controlled, well-known apps. |
Least-privilege alternative
If the app only reads role assignments, use RoleManagement.Read.Directory.
Grant it to an app
In the portal: App registrations › your app › API permissions › Add a permission › Microsoft Graph › Application permissions, then grant admin consent. Or with Graph PowerShell:
Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
$app = Get-MgServicePrincipal -Filter "appId eq '<your app's client id>'"
New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $app.Id `
-PrincipalId $app.Id -ResourceId $graph.Id -AppRoleId "9e3f62cf-ca93-4989-b6ce-bf83c28f9fe8"Ask for it when signing in
Delegated permissions act as the signed-in user, so the app can never do more than that user can.
Connect-MgGraph -Scopes "RoleManagement.ReadWrite.Directory"Which apps already have it?
# Apps that hold RoleManagement.ReadWrite.Directory as an application permission
Connect-MgGraph -Scopes "Application.Read.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
Get-MgServicePrincipalAppRoleAssignedTo -ServicePrincipalId $graph.Id -All |
Where-Object AppRoleId -eq "9e3f62cf-ca93-4989-b6ce-bf83c28f9fe8" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for RoleManagement.ReadWrite.Directory
Connect-MgGraph -Scopes "Application.Read.All", "Directory.Read.All"
$graph = Get-MgServicePrincipal -Filter "appId eq '00000003-0000-0000-c000-000000000000'"
Get-MgOauth2PermissionGrant -All |
Where-Object { $_.ResourceId -eq $graph.Id -and ($_.Scope -split " ") -contains "RoleManagement.ReadWrite.Directory" } |
Select-Object ClientId, ConsentType, PrincipalId