| name | compliance-governance-audit |
| description | Audit Azure environment for compliance and governance posture. Checks Azure Policy, RBAC, tagging, resource locks, naming conventions, and regulatory alignment. Use when asked about compliance, governance, audit readiness, or policy violations. |
| tools | ["RunAzCliReadCommands","execute_kusto_query"] |
Compliance & Governance Audit
Purpose
Assess the governance posture of Azure subscriptions by auditing policies, RBAC assignments, tagging standards, resource locks, and regulatory alignment. Produce a compliance scorecard with remediation steps.
CRITICAL formatting rule
Use Unicode emoji characters directly (🟢 🟡 🔴) in ALL output — headers, tables, findings, bullet points, everywhere. NEVER use emoji shortcodes like :red_circle:, :yellow_circle:, :green_circle:, or any :name: syntax. This applies to every section of the report without exception.
When to use this skill
- User asks "are we compliant?"
- User asks about governance, policy violations, or audit readiness
- Pre-audit preparation (SOC2, ISO 27001, HIPAA, etc.)
- Monthly governance review
Pre-check
Confirm with the user:
- Scope: which subscriptions/management groups
- Compliance framework (if any): SOC2, ISO 27001, HIPAA, PCI-DSS, CIS Benchmarks, or general best practices
- Any known exceptions or waivers
Audit procedure
Step 1: Azure Policy compliance
Check overall policy compliance state.
az policy state summarize --query "value[].{policy:policyDefinitionName, nonCompliant:nonCompliantResources}" -o table
- List all non-compliant resources grouped by policy
- Identify policies in "audit" mode that should be "deny"
- Check for orphaned policy assignments (assigned but no effect)
- Verify initiative assignments for regulatory frameworks (CIS, NIST, etc.)
Report:
- Total policies assigned
- % compliant
- Top 5 violated policies with resource count
Step 2: RBAC review
Audit role assignments for least-privilege violations.
az role assignment list --all --query "[].{principal:principalName, role:roleDefinitionName, scope:scope}" -o table
- Owner count: Flag if > 3 Owners at subscription level
- Contributor sprawl: List all Contributor assignments — flag service principals with Contributor when a custom role would suffice
- Classic admins: Check for legacy co-administrators
az role assignment list --include-classic-administrators -o table
- Guest users with privileged roles: Flag external identities with Owner/Contributor
- Stale assignments: Cross-reference with sign-in logs — flag principals that haven't signed in for 90+ days
- Custom roles: Review custom role definitions for overly broad permissions (e.g.,
* actions)
Step 3: Tagging compliance
Check mandatory tags across all resources.
Define expected mandatory tags (confirm with user or use defaults):
environment (prod/staging/dev/test)
owner (team or individual)
cost-center (billing code)
application (workload name)
az resource list --query "[?tags.environment==null || tags.owner==null].{name:name, type:type, rg:resourceGroup, tags:tags}" -o table
Report:
- % of resources with all mandatory tags
- Top offending resource groups
- Resources with no tags at all
Step 4: Resource locks
Check critical resources for delete/read-only locks.
az lock list --query "[].{name:name, level:level, resource:resourceId}" -o table
- Verify production databases have delete locks
- Verify production storage accounts have delete locks
- Verify networking resources (VNets, ExpressRoute) have locks
- Flag production resources without any lock
Step 5: Naming conventions
Analyze resource naming patterns.
- Extract all resource names and types
- Check against Azure naming conventions (e.g.,
rg-, vnet-, vm-, st, kv-)
- Flag resources that don't follow a consistent pattern
- Report % compliance with naming standards
Step 6: Network governance
- Check for resources with public endpoints that should be private
- Verify NSG flow logs are enabled
- Check for Network Watcher in all active regions
- Verify DDoS protection on VNets with public-facing resources
Step 7: Diagnostic settings
- Check that all critical resources have diagnostic settings enabled
- Verify logs flow to a central Log Analytics workspace
- Check Activity Log export at subscription level
az monitor diagnostic-settings subscription list --subscription <id> -o table
Scoring model
| Rating | Meaning |
|---|
| 🟢 Compliant | Meets standard, no action needed |
| 🟡 Partial | Partially implemented, needs improvement |
| 🔴 Non-compliant | Missing or misconfigured, action required |
Reminder: use the actual Unicode characters 🟢 🟡 🔴 above, never shortcodes.
Expected output
Report header (mandatory — use this exact format)
Compliance & Governance Audit Report
| Field | Value |
|---|
| Subscription | (name + ID) |
| Assessment Date | YYYY-MM-DD |
| Overall Score | XX% |
Governance scorecard
| Area | Status | Compliant | Partial | Non-compliant | Score |
|---|
| Azure Policy | 🟡 | X | Y | Z | % |
| RBAC | 🔴 | ... | ... | ... | % |
| Tagging | 🟡 | ... | ... | ... | % |
| Resource Locks | 🔴 | ... | ... | ... | % |
| Naming | 🟢 | ... | ... | ... | % |
| Network Gov. | 🟡 | ... | ... | ... | % |
| Diagnostics | 🟡 | ... | ... | ... | % |
| Overall | | | | | % |
Critical findings (act now)
Items that represent immediate risk or audit failure.
Remediation plan
For each finding:
- What's wrong
- Why it matters
- How to fix it (with az cli command or portal steps)
- Use
GetAzCliHelp to validate the command syntax before suggesting
- Include the official Microsoft Learn documentation link
- Estimated effort
- Priority (Critical/High/Medium/Low)
References
Regulatory mapping (if framework specified)
Map findings to specific controls (e.g., SOC2 CC6.1, ISO 27001 A.9.2.3).