// roles/azure · security

Key Vault Secrets OfficerAzure built-in role

Perform any action on the secrets of a key vault, except manage permissions. Only works for key vaults that use the 'Azure role-based access control' permission model.

Role ID	`b86a8fe4-44ce-4948-aee5-eccb2c155cd7`
Category	Security
Actions	10
Data actions	1

Before you assign it

It reaches the data, not just the resource. It has 1 data action, such as reading blobs, secrets or messages.

What it can do

Permission	What it allows
`Microsoft.Authorization/*/read`	Any read operation on anything under Microsoft.Authorization
`Microsoft.Insights/alertRules/*`	Every operation under Microsoft.Insights/alertRules
`Microsoft.Resources/deployments/*`	Every operation under Microsoft.Resources/deployments
`Microsoft.Resources/subscriptions/resourceGroups/read`	Gets or lists resource groups.
`Microsoft.Support/*`	Every operation under Microsoft.Support
`Microsoft.KeyVault/checkNameAvailability/read`	Checks that a key vault name is valid and is not in use
`Microsoft.KeyVault/deletedVaults/read`	View the properties of soft deleted key vaults
`Microsoft.KeyVault/locations/*/read`	Any read operation on anything under Microsoft.KeyVault/locations
`Microsoft.KeyVault/vaults/*/read`	Any read operation on anything under Microsoft.KeyVault/vaults
`Microsoft.KeyVault/operations/read`	Lists operations available on Microsoft.KeyVault resource provider

Data actions

Permission	What it allows
`Microsoft.KeyVault/vaults/secrets/*`	Every operation under Microsoft.KeyVault/vaults/secrets

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 "Key Vault Secrets Officer" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"

powershell3 lines

1
2
3New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "Key Vault Secrets Officer" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"

bicep7 lines

1
2
3
4
5
6
7resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, 'b86a8fe4-44ce-4948-aee5-eccb2c155cd7')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', 'b86a8fe4-44ce-4948-aee5-eccb2c155cd7')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph

authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "b86a8fe4-44ce-4948-aee5-eccb2c155cd7"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other security roles

App Compliance Automation Reader · 1 permission
Key Vault Crypto Service Release User · 1 permission
Security Assessment Contributor · 1 permission
Attestation Reader · 2 permissions
Key Vault Secrets User · 2 permissions
Attestation Contributor · 3 permissions
Locks Contributor · 3 permissions
Key Vault Certificate User · 4 permissions

Find the smallest role for a task →

Sources

Microsoft Learn: Azure built-in roles