azureblog.co.uk
← cd ~/roles
// roles/azure · devops

Deployment Environments UserAzure built-in role

Provides access to manage environment resources.

Role ID18e40d4e-8d2e-438d-97e1-9528336e149c
CategoryDevops
Actions4 (minus 2 NotActions)
Data actions5

Before you assign it

  • It reaches the data, not just the resource. It has 5 data actions, such as reading blobs, secrets or messages.

What it can do

PermissionWhat it allows
Microsoft.DevCenter/projects/readLists all projects in the subscription.
Microsoft.DevCenter/projects/*/readAny read operation on anything under Microsoft.DevCenter/projects
Microsoft.Resources/subscriptions/resourceGroups/readGets or lists resource groups.
Microsoft.Authorization/*/readAny read operation on anything under Microsoft.Authorization

Can't do

These are taken away from the actions above.

PermissionWhat it allows
Microsoft.DevCenter/projects/pools/readLists pools for a project
Microsoft.DevCenter/projects/pools/schedules/readLists schedules for a pool

Data actions

PermissionWhat it allows
Microsoft.DevCenter/projects/users/environments/userRead/actionAllows a user to read the environments they have access to in a project.
Microsoft.DevCenter/projects/users/environments/userWrite/actionAllows a user to write the environments they have access to in a project.
Microsoft.DevCenter/projects/users/environments/userDelete/actionAllows a user to delete the environments they have access to in a project.
Microsoft.DevCenter/projects/users/environments/userActionManage/actionAllows a user to skip, delay etc. environment actions.
Microsoft.DevCenter/projects/users/environments/userOutputsRead/actionAllows a user to read Output values from environment deployment.

Assign it

Scope it as tightly as you can: a resource or resource group rather than the whole subscription.

azure cli
az role assignment create \
  --assignee "jane.doe@contoso.com" \
  --role "Deployment Environments User" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
powershell3 lines
New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "Deployment Environments User" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
bicep7 lines
resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, '18e40d4e-8d2e-438d-97e1-9528336e149c')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '18e40d4e-8d2e-438d-97e1-9528336e149c')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "18e40d4e-8d2e-438d-97e1-9528336e149c"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other devops roles

Find the smallest role for a task →

Sources