AgentIdUser.ReadWrite.IdentityParentedByMicrosoft Graph permission · Medium risk
Allows the app to create agent users, read and update agent ID user profiles, delete and restore agent users under an agent blueprint, and read basic company properties without a signed-in user.
Application permission
Medium riskRead and write full profiles of agent ID users under an agent blueprint. Allows the app to create agent users, read and update agent ID user profiles, delete and restore agent users under an agent blueprint, and read basic company properties without a signed-in user.
| ID | 4aa6e624-eee0-40ab-bdd8-f9639038a614 |
|---|---|
| Consent | Always needs admin consent |
| Risk | Can make changes. Check the scope is as narrow as possible. |
Delegated permission
Medium riskRead and write full profiles of agent ID users under an agent blueprint. Allows the app to create agent users, read and write the full set of profile properties, reports, and managers of agent ID users in your organization, delete and restore agent users under an agent blueprint, and read basic company properties, on behalf of the signed-in user.
| ID | 52a417d9-0b3c-4466-9a3b-66960de73d74 |
|---|---|
| Consent | Needs admin consent |
| Risk | Can make changes. Check the scope is as narrow as possible. |
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 "4aa6e624-eee0-40ab-bdd8-f9639038a614"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 "AgentIdUser.ReadWrite.IdentityParentedBy"Which apps already have it?
# Apps that hold AgentIdUser.ReadWrite.IdentityParentedBy 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 "4aa6e624-eee0-40ab-bdd8-f9639038a614" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for AgentIdUser.ReadWrite.IdentityParentedBy
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 "AgentIdUser.ReadWrite.IdentityParentedBy" } |
Select-Object ClientId, ConsentType, PrincipalId