← cd ~/roles
// roles/entra · privileged
Entra SOC Identity ResponderMicrosoft Entra built-in role
Perform identity containment actions for SOC incident response, including disabling users, revoking active sign-in sessions, and resetting passwords.
| Role ID | 58f930cc-fcf4-4152-852c-1d7dbf502139 |
|---|---|
| Privileged | Yes. Microsoft marks this role as privileged. |
| Permissions | 4 |
Before you assign it
Microsoft labels this a privileged role, so make it eligible through PIM rather than permanent, require phishing-resistant MFA to activate it, and review who has it regularly.
What it can do
| Permission | What it allows |
|---|---|
microsoft.directory/users/disable | Disable users |
microsoft.directory/users/enable | Enable users |
microsoft.directory/users/invalidateAllRefreshTokens | Force sign-out by invalidating user refresh tokens |
microsoft.directory/users/password/update | Reset passwords for all users |
Assign it
The role ID is the same in every tenant, so these work as they are. Make it eligible through PIM:
Connect-MgGraph -Scopes "RoleEligibilitySchedule.ReadWrite.Directory"
$user = Get-MgUser -UserId "jane.doe@contoso.com"
New-MgRoleManagementDirectoryRoleEligibilityScheduleRequest -BodyParameter @{
Action = "AdminAssign"
Justification = "Needs Entra SOC Identity Responder for <reason>"
RoleDefinitionId = "58f930cc-fcf4-4152-852c-1d7dbf502139"
DirectoryScopeId = "/"
PrincipalId = $user.Id
ScheduleInfo = @{
StartDateTime = (Get-Date).ToUniversalTime().ToString("o")
Expiration = @{ Type = "afterDuration"; Duration = "P180D" }
}
}Who already has it?
Connect-MgGraph -Scopes "RoleManagement.Read.Directory"
Get-MgRoleManagementDirectoryRoleAssignment -Filter "roleDefinitionId eq '58f930cc-fcf4-4152-852c-1d7dbf502139'" -ExpandProperty Principal |
ForEach-Object { $_.Principal.AdditionalProperties.displayName }Related roles
- Application Developer · 3 permissions · privileged
- Domain Name Administrator · 3 permissions · privileged
- Lifecycle Workflows Administrator · 3 permissions · privileged
- Attribute Provisioning Administrator · 2 permissions · privileged
- External Identity Provider Administrator · 2 permissions · privileged
- Password Administrator · 2 permissions · privileged
- Attribute Provisioning Reader · 1 permission · privileged
- Authentication Extensibility Administrator · 1 permission · privileged