MCPInstall

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. Use when defining custom roles, ABAC conditions, deny assignments, PIM-eligible roles, or ARM/Bicep-based role assignments, and other Azure Role-based access control related development tasks. Not for Azure Policy (use azure-policy), Azure Resource Manager (use azure-resource-manager), Azure Security (use azure-security), Azure Lighthouse (use azure-lighthouse).

Installs
294
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-rbac
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads azure-rbac automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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-L130Azure RBAC role definitions, permissions, and conditions for security-related resources, including privileged roles, deny assignments, ABAC, PIM, policy, and secure subscription/tenant administration.
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

Best Practices

Decision Making

Limits & Quotas

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 manage 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

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

FAQ

What does the azure-rbac skill do?

Expert knowledge for Azure Role-based access control development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when defining custom roles, ABAC conditions, deny assignments, PIM-eligible roles, or ARM/Bicep-based role assignments, and other Azure Role-based access control related development tasks. Not for Azure Policy (use azure-policy), Azure Resource Manager (use azure-resource-manager), Azure Security (use azure-security), Azure Lighthouse (use azure-lighthouse).

How do I install azure-rbac?

Run npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-rbac in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/azure-rbac/ (personal) or .claude/skills/azure-rbac/ (project).

Which AI agents can use azure-rbac?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is azure-rbac safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains azure-rbac?

It is published by microsoftdocs in microsoftdocs/agent-skills. It has 294 recorded installs.

More from microsoftdocs/agent-skills

View all →

azure-container-apps

microsoftdocs/agent-skills

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-functions), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Spring Apps (use azure-spring-apps).

DevOps & Cloud1.3K installs

azure-sql-database

microsoftdocs/agent-skills

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 Machines (use azure-sql-virtual-machines), Azure Cosmos DB (use azure-cosmos-db), Azure Data Factory (use azure-data-factory).

Data & Databases1.3K installs

azure-well-architected

microsoftdocs/agent-skills

Expert guidance for designing, assessing, and optimizing Azure workloads using Azure Well Architected. Covers design review checklists, recommendations, design principles, tradeoffs, service guides, workload patterns, and assessment questions. Use when designing AI/HPC/SaaS workloads, AVD/AVS deployments, WAF assessments, or App Service/AKS/SQL architectures, and other Azure Well Architected related development tasks.

DevOps & Cloud646 installs

azure-pipelines

microsoftdocs/agent-skills

Expert knowledge for Azure Pipelines development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring YAML pipelines, agents, service connections, Key Vault secrets, or Kubernetes/web app deployments, and other Azure Pipelines related development tasks. Not for Azure DevOps (use azure-devops), Azure Boards (use azure-boards), Azure Repos (use azure-repos), Azure Test Plans (use azure-test-plans).

DevOps & Cloud439 installs

azure-architecture

microsoftdocs/agent-skills

Expert guidance for designing Azure solutions using Azure Architecture. Covers reference architectures, solution ideas, design patterns, technology choices, architecture styles, best practices, anti-patterns, example workloads, and migration guides. Use when designing AKS or App Service apps, SAP/ERP or IoT workloads, hybrid/Arc setups, or AI/ML solutions on Azure, and other Azure Architecture related development tasks.

azure-devops

microsoftdocs/agent-skills

Expert knowledge for Azure DevOps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when managing org/projects, repos, pipelines, work items, dashboards/analytics, or Azure DevOps Server deployments, and other Azure DevOps related development tasks. Not for Azure Boards (use azure-boards), Azure Pipelines (use azure-pipelines), Azure Repos (use azure-repos), Azure Test Plans (use azure-test-plans).

DevOps & Cloud407 installs

Popular devops & cloud skills

View category →

microsoft-foundry

microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent create, managed harness agent create, GitHub Copilot harness agent, create agent, update agent, add tool to agent, invoke agent, agent insights, evaluate agent, batch eval, continuous eval, continuous monitoring, agent CI/CD, optimize prompt, improve prompt, optimize agent instructions, Agent Optimizer scaffold, dataset curation from traces, deploy model, model fine-tuning (SFT/DPO/RFT), Foundry project, RBAC, role assignment, permissions, quota, capacity, region, deployment failure, AI Services, create Foundry resource, knowledge index, customize deployment, onboard, availability, training-data, grader, distillation, large file upload. DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy), general Azure prep (use azure

OfficialDevOps & Cloud579.1K installs

azure-diagnostics

microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, lock renewal during long-running processing, service bus dead letter.

OfficialDevOps & Cloud569.8K installs

azure-prepare

microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

OfficialDevOps & Cloud569K installs

azure-ai

microsoft/azure-skills

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.

OfficialDevOps & Cloud568.8K installs

azure-deploy

microsoft/azure-skills

Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: "run azd up", "run azd deploy", "execute deployment", "push to production", "push to cloud", "go live", "ship it", "bicep deploy", "terraform apply", "publish to Azure", "launch on Azure". DO NOT USE WHEN: "create and deploy", "build and deploy", "create a new app", "set up infrastructure", "create and deploy to Azure using Terraform" — use azure-prepare for these.

OfficialDevOps & Cloud568.6K installs

azure-validate

microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure (Bicep or Terraform), RBAC role assignments, managed identity permissions, and prerequisites before deploying. WHEN: validate my app, check deployment readiness, run preflight checks, verify configuration, check if ready to deploy, validate azure.yaml, validate Bicep, test before deploying, troubleshoot deployment errors, validate Azure Functions, validate function app, validate serverless deployment, verify RBAC roles, check role assignments, review managed identity permissions, what-if analysis, validate Container Apps deployment.

OfficialDevOps & Cloud568K installs