microsoftdocs/agent-skills

azure-rbac

Expert knowledge for Azure Role-based access control development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-rbac

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Azure Role-based access control Skill

This skill provides expert guidance for Azure Role-based access control. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file
IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL35-L43Diagnosing and fixing Azure RBAC problems: auditing role changes, resolving role/custom role limits, and troubleshooting role assignment condition and common access issues.
Best PracticesL44-L50Security-focused guidance on designing Azure RBAC: choosing scopes, delegating access with ABAC conditions, and applying least privilege and separation-of-duties best practices.
Decision MakingL51-L55Guidance on choosing and migrating role models: moving from classic admins to RBAC, scaling with ABAC, selecting Azure vs Entra vs classic roles, and transferring subscriptions between directories.
Limits & QuotasL56-L61Designing and managing Azure RBAC custom roles, including understanding role structure, permissions, and step-by-step creation using the Azure portal
SecurityL62-L130Managing Azure RBAC security: built-in and custom roles, permissions, ABAC conditions, deny assignments, PIM, policy integration, and secure role assignment/administration practices.
ConfigurationL131-L141Configuring Azure RBAC/ABAC: prerequisites, condition syntax, role assignments, built‑in vs custom roles, and creating/inspecting custom role definitions via CLI and PowerShell
Integrations & Coding PatternsL142-L156How to assign, list, and query Azure RBAC role assignments using CLI, PowerShell, portal, REST, ARM/Bicep templates, including managed identities and group-based access.

Troubleshooting

TopicURL
Audit Azure RBAC changes using Activity Loghttps://learn.microsoft.com/en-us/azure/role-based-access-control/change-history-report
Resolve common issues with Azure RBAC conditionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-faq
Diagnose and fix Azure role assignment condition issueshttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-troubleshoot
Resolve Azure RBAC role and custom role limit issueshttps://learn.microsoft.com/en-us/azure/role-based-access-control/troubleshoot-limits
Diagnose and resolve common Azure RBAC issueshttps://learn.microsoft.com/en-us/azure/role-based-access-control/troubleshooting

Best Practices

TopicURL
Apply security-focused best practices for Azure RBAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/best-practices
Example patterns for delegating RBAC with ABAC conditionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/delegate-role-assignments-examples
Choose appropriate Azure RBAC scopes for accesshttps://learn.microsoft.com/en-us/azure/role-based-access-control/scope-overview

Decision Making

TopicURL
Scale Azure RBAC assignments using ABAC and attributeshttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-custom-security-attributes-example

Limits & Quotas

TopicURL
Understand and configure Azure RBAC custom roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles
Create Azure custom roles in the portalhttps://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles-portal

Security

TopicURL
Use Azure built-in RBAC roles and permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles
Use AI and machine learning Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/ai-machine-learning
Use analytics Azure RBAC built-in roles and permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/analytics
Apply compute-related Azure RBAC built-in roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/compute
Use container-related Azure RBAC built-in roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/containers
Use database Azure RBAC built-in roles and scopeshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/databases
Use DevOps Azure RBAC built-in roles and permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/devops
Use general-purpose Azure RBAC built-in roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/general
Use hybrid and multicloud RBAC roles in Azurehttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/hybrid-multicloud
Use identity Azure RBAC built-in roles and scopeshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/identity
Use integration Azure RBAC built-in roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/integration
Use IoT Azure RBAC built-in roles and permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/internet-of-things
Apply management and governance RBAC roles in Azurehttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/management-and-governance
Use Azure RBAC built-in roles for migration scenarioshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/migration
Assign Azure Monitor built-in RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/monitor
Apply networking Azure RBAC built-in roles and scopeshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/networking
Use privileged Azure RBAC built-in roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/privileged
Use security-category Azure RBAC built-in roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/security
Use storage Azure RBAC built-in roles and permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/storage
Use web and mobile Azure RBAC built-in roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles/web-and-mobile
Use authorization actions and attributes in Azure ABAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-authorization-actions-attributes
Restrict blob read access using tags and ABAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-custom-security-attributes
Manage Azure RBAC conditions using Azure CLIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-role-assignments-cli
Configure Azure RBAC role assignment conditions in portalhttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-role-assignments-portal
Manage Azure RBAC conditions using PowerShellhttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-role-assignments-powershell
Manage Azure RBAC conditions via REST APIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-role-assignments-rest
Define Azure RBAC conditions in ARM templateshttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-role-assignments-template
Define Azure custom roles using Bicephttps://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles-bicep
Manage Azure custom roles using Azure CLIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles-cli
Manage Azure custom roles using PowerShellhttps://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles-powershell
Manage Azure custom roles via REST APIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles-rest
Define Azure custom roles with ARM templateshttps://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles-template
Delegate Azure role assignments with ABAC conditionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/delegate-role-assignments-portal
List and understand Azure RBAC deny assignmentshttps://learn.microsoft.com/en-us/azure/role-based-access-control/deny-assignments
Elevate Global Administrator access to all subscriptionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/elevate-access-global-admin
Configure AI and ML permissions for Azure RBAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/ai-machine-learning
Configure analytics permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/analytics
Configure compute permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/compute
Configure container permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/containers
Configure database permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/databases
Configure DevOps permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/devops
Use general-category Azure RBAC permission stringshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/general
Configure hybrid and multicloud RBAC permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/hybrid-multicloud
Configure identity permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/identity
Configure integration permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/integration
Configure IoT permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/internet-of-things
Configure management and governance RBAC permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/management-and-governance
Configure migration permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/migration
Configure monitor permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/monitor
Configure networking permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/networking
Configure security-category permissions for Azure RBAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/security
Configure storage permissions for Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/storage
Configure web and mobile permissions for Azure RBAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/permissions/web-and-mobile
Use PIM for eligible and time-bound Azure RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/pim-integration
Apply built-in Azure Policy definitions for RBAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/policy-reference
Choose between Azure RBAC, Entra, and classic admin roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/rbac-and-directory-admin-roles
Reference Azure resource provider RBAC permissionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/resource-provider-operations
Alert on privileged Azure RBAC role assignmentshttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-alert
Activate eligible Azure RBAC roles in the portalhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-eligible-activate
Assign Azure RBAC roles to external B2B usershttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-external-users
List Azure RBAC role assignments in portalhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-list-portal
Assign Azure RBAC roles in Azure portalhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal
Assign subscription Owner with constrained RBAC conditionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal-subscription-admin
Apply Azure Policy compliance controls to Azure RBAChttps://learn.microsoft.com/en-us/azure/role-based-access-control/security-controls-policy
Transfer Azure subscriptions between Entra directories securelyhttps://learn.microsoft.com/en-us/azure/role-based-access-control/transfer-subscription

Configuration

TopicURL
Author Azure RBAC condition expressions and syntaxhttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-format
Meet prerequisites to use Azure RBAC conditionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/conditions-prerequisites
Configure and interpret Azure RBAC role assignmentshttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments
Understand and configure Azure RBAC role definitionshttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-definitions
List and inspect Azure built-in and custom RBAC roleshttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-definitions-list
Create Azure custom RBAC roles using Azure CLIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/tutorial-custom-role-cli
Define Azure custom RBAC roles with PowerShellhttps://learn.microsoft.com/en-us/azure/role-based-access-control/tutorial-custom-role-powershell

Integrations & Coding Patterns

TopicURL
Assign Azure RBAC roles using Bicep templateshttps://learn.microsoft.com/en-us/azure/role-based-access-control/quickstart-role-assignments-bicep
Assign Azure RBAC roles with ARM templateshttps://learn.microsoft.com/en-us/azure/role-based-access-control/quickstart-role-assignments-template
Assign Azure RBAC roles using Azure CLIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-cli
List Azure RBAC role assignments via Azure CLIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-list-cli
List Azure RBAC role assignments with PowerShellhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-list-powershell
Query Azure RBAC role assignments using REST APIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-list-rest
Assign Azure RBAC roles starting from a managed identityhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal-managed-identity
Assign Azure RBAC roles via PowerShell for all principalshttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-powershell
Assign Azure RBAC roles through the REST APIhttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-rest
Assign Azure RBAC roles using ARM templateshttps://learn.microsoft.com/en-us/azure/role-based-access-control/role-assignments-template
Grant group-based Azure RBAC access via PowerShellhttps://learn.microsoft.com/en-us/azure/role-based-access-control/tutorial-role-assignments-group-powershell
Grant Azure RBAC access using PowerShell commandshttps://learn.microsoft.com/en-us/azure/role-based-access-control/tutorial-role-assignments-user-powershell

Related by task

from this repository

More skills

All skills
microsoftdocs
Community

azure-sql-database

Expert knowledge for Azure SQL Database development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when choosing DTU/vCore tiers, configuring serverless or Hyperscale, geo-replication/DR, CI/CD, or Terraform, and other Azure SQL Database related development tasks. Not for Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual

1h installs
3
GitHub stars
801
Updated
Oct 26
microsoftdocs
Community

azure-container-apps

Expert knowledge for Azure Container Apps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring ACA auth/networking, workload profiles/GPUs, CI/CD deployments, KEDA/Dapr scaling, or Java microservices, and other Azure Container Apps related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-f

1h installs
2
GitHub stars
793
Updated
Oct 26
microsoftdocs
Community

azure-repos

Expert knowledge for Azure Repos development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Git/TFVC repos, branch policies/PR checks, TFVC→Git migrations, large files, or security scanning, and other Azure Repos related development tasks. Not for Azure DevOps (use azure-devops), Azure Pipelines (use azure-pipelines), Azure Boards (use azure-boards), Azure

1h installs
1
GitHub stars
790
Updated
Oct 19
microsoftdocs
Community

azure-monitor

Expert knowledge for Azure Monitor development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring AMA/DCRs, Log Analytics workspaces, Application Insights, alerts, or Kusto (KQL) queries, and other Azure Monitor related development tasks. Not for Azure Network Watcher (use azure-network-watcher), Azure Resource Graph (use azure-resource-graph), A

1h installs
1
GitHub stars
779
Updated
Oct 11