Azure Containers built-in role

Azure Red Hat OpenShift Network Operator

Azure Red Hat OpenShift Network Operator is a service-agent role for the user-assigned managed identity associated with the Network operator. It allows that operator to install and upgrade OpenShift networking components and manage the Azure network interfaces, virtual-network associations, and load-balancer links they require. 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: be7a6435-15ae-4171-8f30-4a343eff9e8f

Control-plane actions (7)

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 Network operator identity only at the ARO virtual network. 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 Network Operator on the managed resource group. For customer-owned infrastructure, assign it only to the dedicated Network operator identity at the ARO virtual network, 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 Network Operator Azure role?

Assign Azure Red Hat OpenShift Network Operator when you need to: Allow the ARO Network 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 Network operator identity only at the ARO virtual network. Do not infer additional external assignment scopes from the role's Actions.

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

The role definition grants 7 combined control-plane and data-plane actions. Representative operations include: Microsoft.Network/networkInterfaces/read; Microsoft.Network/networkInterfaces/write; Microsoft.Network/virtualNetworks/read; Microsoft.Network/virtualNetworks/subnets/join/action; Microsoft.Network/loadBalancers/backendAddressPools/join/action; and Microsoft.Network/loadBalancers/backendAddressPools/read. Review the permission sections above for the complete definition and exclusions.

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

Key considerations when assigning Azure Red Hat OpenShift Network Operator: Network-operator changes can alter cluster connectivity, load-balancer membership, and workload reachability throughout the virtual network.; 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 (7)

Official Microsoft Learn documentation →