azureblog.co.uk
← cd ~/roles
// roles/entra

Attack Payload AuthorMicrosoft Entra built-in role

Can create attack payloads that an administrator can initiate later.

Role ID9c6df0f2-1e7c-4dc3-b195-66dfbd24aa8f
PrivilegedNo
Permissions2

What it can do

PermissionWhat it allows
microsoft.office365.protectionCenter/attackSimulator/payload/allProperties/allTasksCreate and manage attack payloads in Attack Simulator
microsoft.office365.protectionCenter/attackSimulator/reports/allProperties/readRead reports of attack simulation, responses, and associated training

Assign it

The role ID is the same in every tenant, so these work as they are. Make it eligible through PIM:

powershell13 lines
Connect-MgGraph -Scopes "RoleEligibilitySchedule.ReadWrite.Directory"
$user = Get-MgUser -UserId "jane.doe@contoso.com"
New-MgRoleManagementDirectoryRoleEligibilityScheduleRequest -BodyParameter @{
    Action           = "AdminAssign"
    Justification    = "Needs Attack Payload Author for <reason>"
    RoleDefinitionId = "9c6df0f2-1e7c-4dc3-b195-66dfbd24aa8f"
    DirectoryScopeId = "/"
    PrincipalId      = $user.Id
    ScheduleInfo     = @{
        StartDateTime = (Get-Date).ToUniversalTime().ToString("o")
        Expiration    = @{ Type = "afterDuration"; Duration = "P180D" }
    }
}

Who already has it?

powershell3 lines
Connect-MgGraph -Scopes "RoleManagement.Read.Directory"
Get-MgRoleManagementDirectoryRoleAssignment -Filter "roleDefinitionId eq '9c6df0f2-1e7c-4dc3-b195-66dfbd24aa8f'" -ExpandProperty Principal |
    ForEach-Object { $_.Principal.AdditionalProperties.displayName }

Related roles

Find the smallest role for a task →