People.Read.AllMicrosoft Graph permission · Medium risk
Allows the app to read any user's scored list of relevant people, without a signed-in user. The list can include local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype).
Application permission
Medium riskRead all users' relevant people lists. Allows the app to read any user's scored list of relevant people, without a signed-in user. The list can include local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype).
| ID | b528084d-ad10-4598-8b93-929746b4d7d6 |
|---|---|
| Consent | Always needs admin consent |
| Risk | Reads data across the tenant without a signed-in user. |
Delegated permission
Low riskRead all users' relevant people lists. Allows the app to read a scored list of relevant people of the signed-in user or other users in the signed-in user's organization. The list can include local contacts, contacts from social networking, your organization's directory, and people from recent communications (such as email and Skype).
| ID | b89f9189-71a5-4e70-b041-9887f0bc7e4a |
|---|---|
| Consent | Needs admin consent |
| Risk | Read access, limited to what the signed-in user can see. |
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 "b528084d-ad10-4598-8b93-929746b4d7d6"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 "People.Read.All"Which apps already have it?
# Apps that hold People.Read.All 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 "b528084d-ad10-4598-8b93-929746b4d7d6" |
Select-Object PrincipalDisplayName, PrincipalId, CreatedDateTime# Apps with delegated consent for People.Read.All
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 "People.Read.All" } |
Select-Object ClientId, ConsentType, PrincipalId