Azure Containers built-in role

Azure Red Hat OpenShift File Storage Operator

Azure Red Hat OpenShift File Storage Operator is a service-agent role for the user-assigned managed identity associated with the File Storage operator. It allows that operator to install and operate the Azure Files CSI integration and manage required storage-account, file-share, private-endpoint, DNS, and network resources. Azure Red Hat OpenShift creates a separate assignment of this role on the ARO managed resource group for the service-managed resources. Its published permissions are Azure control-plane Actions with no DataActions; it is not a human OpenShift administration role.

Role-definition permissions are imported from Microsoft Learn. Practical scope, use cases, prerequisites, best practices, security considerations, assignment guidance, and relationships have been reviewed against the official sources below.

Role definition ID: 0d7aedc0-15fd-4a67-a412-efad370c947e

Control-plane actions (30)

Data-plane actions (0)

None — this role grants no data-plane (data access) actions.

Excluded actions (0)

None

Assignable scopes (1)

Practical scope

The ARO service creates the assignment on the managed resource group. For customer-owned resources outside that group, Microsoft documents customer-created assignments to the corresponding File Storage operator identity only at the virtual network and the documented optional NSG, route table, and NAT gateway resources. Do not infer additional external assignment scopes from the role's Actions.

Common use cases (1)

Prerequisites (2)

Best practices (2)

Security considerations (2)

Assignment guidance

Allow the ARO service to create Azure Red Hat OpenShift File Storage Operator on the managed resource group. For customer-owned infrastructure, assign it only to the dedicated File Storage operator identity at the virtual network and the documented optional NSG, route table, and NAT gateway resources, exactly as listed in the current identity architecture and deployment examples. Do not duplicate the managed-resource-group assignment or extrapolate other external scopes from Actions, and do not grant the role to human administrators.

Related roles (1)

Common questions

When should I assign the Azure Red Hat OpenShift File Storage Operator Azure role?

Assign Azure Red Hat OpenShift File Storage Operator when you need to: Allow the ARO File Storage operator identity to operate service-managed resources in the managed resource group and only the documented customer-owned resources required by the cluster architecture.. Practical scope: The ARO service creates the assignment on the managed resource group. For customer-owned resources outside that group, Microsoft documents customer-created assignments to the corresponding File Storage operator identity only at the virtual network and the documented optional NSG, route table, and NAT gateway resources. Do not infer additional external assignment scopes from the role's Actions.

What permissions does the Azure Red Hat OpenShift File Storage Operator Azure role grant?

The role definition grants 30 combined control-plane and data-plane actions. Representative operations include: Microsoft.Storage/storageAccounts/delete; Microsoft.Storage/storageAccounts/fileServices/read; Microsoft.Storage/storageAccounts/fileServices/shares/delete; Microsoft.Storage/storageAccounts/fileServices/shares/read; Microsoft.Storage/storageAccounts/fileServices/shares/write; and Microsoft.Storage/storageAccounts/listKeys/action. Review the permission sections above for the complete definition and exclusions.

What are the security risks of the Azure Red Hat OpenShift File Storage Operator Azure role?

Key considerations when assigning Azure Red Hat OpenShift File Storage Operator: The role can list storage account keys, which Microsoft says provide full access to storage account data and can sign SAS tokens, and can create, modify, or delete storage and network resources, exposing shared-key credentials or disrupting persistent file volumes.; and A broader customer-created external assignment or a human assignment would grant infrastructure permissions outside the documented ARO component boundary and bypass the separation among core operator identities.. Follow the assignment guidance above and use the narrowest practical scope.

Editorial sources (8)

Official Microsoft Learn documentation →