GRC connector for Azure: Entra ID, Storage, Key Vault, Monitor, and Defender for Cloud to v1 finding contract

version
0.1.0
GitHub stars
436

Install

/plugin install azure-inspector@grc-engineering-suite

Run it inside Claude Code after adding the marketplace with /plugin marketplace add GRCEngClub/claude-grc-engineering.

Contents

Discovered from source

Skills 1

azure-inspector expert

Use this skill when interpreting azure-inspector findings or explaining Azure control gaps.

Checks This Connector Runs

Entra ID

SCFCheckTypical outcome
IAC-01.1MFA posture needs Graph/authentication-method verificationinconclusive when Azure CLI cannot prove coverage
IAC-04Enabled Conditional Access policies existhigh fail if none found

Storage accounts

SCFCheckSeverity
CRY-05Blob/file encryption enabledhigh if disabled
DCH-01.2Blob public access disabledcritical if allowed
CRY-06Minimum TLS version is TLS 1.2 or latermedium

Key Vault

SCFCheckSeverity
BCD-11Soft delete and purge protectionhigh/medium
IAC-07.2Azure RBAC authorization preferred over access policiesmedium

Monitor + Defender for Cloud

SCFCheckSeverity
MON-02Subscription Activity Log diagnostic export configuredhigh
MON-01.2Defender for Cloud Standard plan enabledhigh

Interpretation Rules

  • Prefer SCF control IDs already emitted by the connector. Do not remap to Azure-native benchmark IDs unless the user asks for a CIS Azure Benchmark view.
  • Treat inconclusive as an evidence gap, not a pass. Entra MFA coverage often needs Microsoft Graph permissions beyond basic Azure Reader.
  • Treat a subscription-level not_applicable document as a scope signal, not a security defect. Example: no Key Vaults found.
  • For Key Vault, soft delete and purge protection are recovery controls. They do not prove key rotation.
  • For Storage, allowBlobPublicAccess=true is a high-risk configuration even when no container is currently public because it permits future public ACLs.

Common Failure Modes

  • az login is valid but the principal lacks subscription Reader.
  • Conditional Access queries require Microsoft Graph permissions such as Policy.Read.All.
  • Defender pricing reads require Security Reader or equivalent permissions in some tenants.
  • Diagnostic settings can exist at resource scope even if subscription Activity Log export is missing. The connector checks subscription-level export for v0.1.0.

Remediation Guidance

  • Entra ID: baseline Conditional Access for admins, all users MFA, risky sign-ins, and legacy authentication blocking.
  • Storage: set allowBlobPublicAccess=false, enforce TLS 1.2+, and keep service encryption enabled.
  • Key Vault: enable soft delete, enable purge protection for production vaults, and migrate broad access policies to Azure RBAC.
  • Monitor: export Activity Logs to Log Analytics, Event Hub, or Storage with retention aligned to the compliance program.
  • Defender: enable Standard plans for regulated resource types and verify alert routing into the incident workflow.

Roadmap Boundaries

v0.1.0 does not inspect network security groups, Azure Policy assignments, VM disk encryption, AKS, SQL, Sentinel analytics, or Defender recommendations. Mark those as future connector coverage unless separate evidence is supplied.

Commands 3

/azure-inspector:collect

Scans an Azure subscription for compliance-relevant resources and configurations.

How to run

node plugins/connectors/azure-inspector/scripts/collect.js [options]

Arguments

  • --subscription=<id> - override the configured subscription
  • --tenant=<id> - override the configured tenant
  • --services=<csv> - subset of entra,storage,keyvault,monitor,defender (default: all)
  • --output=<fmt> - silent | summary (default) | json
  • --quiet - no stderr progress

What it evaluates

Entra ID:

SCFCheckSeverity
IAC-01.1MFA posture requires Graph/authentication-method verificationinconclusive if CLI cannot determine
IAC-04Conditional Access policies enabledhigh if absent

Storage accounts:

SCFCheckSeverity
CRY-05Blob/file service encryption enabledhigh if disabled
DCH-01.2Blob public access disabledcritical if allowed
CRY-06Minimum TLS version is TLS 1.2 or latermedium

Key Vault:

SCFCheckSeverity
BCD-11Soft delete and purge protectionhigh/medium if disabled
IAC-07.2Azure RBAC authorization preferred over access policiesmedium

Monitor + Defender for Cloud:

SCFCheckSeverity
MON-02Subscription Activity Log diagnostic export configuredhigh
MON-01.2Defender for Cloud Standard plan enabledhigh

Output

  • ~/.cache/claude-grc/findings/azure-inspector/<run_id>.json - array of Findings

  • ~/.cache/claude-grc/runs.log - run manifest appended

  • stdout summary unless --output=silent:

    azure-inspector: 18 resources, 64 evaluations, 7 failing (1 critical, 3 high, 3 medium).
    

Exit codes

  • 0 success
  • 2 credentials invalid or subscription inaccessible
  • 3 rate-limited (Azure quota exhausted)
  • 4 partial (some services inaccessible; report still written)
  • 5 config missing - run setup

Minimum Azure role/API access

Reader on the subscription
Security Reader for Defender for Cloud posture
Microsoft Graph Policy.Read.All for Conditional Access reads

Managed identity works when the identity has equivalent role assignments.

Examples

# Current subscription, all services
/azure-inspector:collect

# Multiple subscriptions
for s in sub-prod sub-stage; do
  /azure-inspector:collect --subscription=$s
done

# Storage only
/azure-inspector:collect --services=storage

CI/CD usage

az login --identity
node plugins/connectors/azure-inspector/scripts/collect.js --quiet
node plugins/grc-engineer/scripts/gap-assessment.js FedRAMP-Moderate --sources=azure-inspector --output=sarif --quiet > azure-gap.sarif

/azure-inspector:setup

Prepares the azure-inspector connector. Confirms az CLI is installed and authenticated, writes ~/.config/claude-grc/connectors/azure-inspector.yaml, and runs a read-only subscription health check.

How to run

bash plugins/connectors/azure-inspector/scripts/setup.sh [--subscription=<id>] [--tenant=<id>]

Exits 0 on success, 2 on missing/invalid credentials, 5 on missing az binary.

Credential precedence

Honors the standard Azure CLI credential chain:

  1. --subscription / --tenant flags
  2. AZURE_SUBSCRIPTION_ID environment variable for collection
  3. Active az account show context
  4. Managed identity after az login --identity

The setup script verifies az account show --subscription <id> before writing config.

Config written

version: 1
source: azure-inspector
source_version: "0.1.0"
subscription_id: "<subscription-id>"
subscription_name: "<name>"
tenant_id: "<tenant-id>"
caller: "<user-or-service-principal>"
defaults:
  services: ["entra", "storage", "keyvault", "monitor", "defender"]

Failure modes

  • az not installed: exit 5. Install Azure CLI.
  • No active account: exit 2. Run az login or az login --identity.
  • Subscription inaccessible: exit 2. Grant Reader on the subscription; add Security Reader and Microsoft Graph Policy.Read.All for fuller coverage.

Safe to re-run

Yes. Re-running verifies the current account and overwrites config without deleting cached findings.

/azure-inspector:status

Non-destructive health check. Shows whether the connector is configured, whether Azure credentials still work, and when it last produced findings.

How to run

bash plugins/connectors/azure-inspector/scripts/status.sh

Output

azure-inspector
  status:        ready
  az:            2.72.0
  subscription:  Prod (00000000-0000-0000-0000-000000000000)
  tenant:        11111111-1111-1111-1111-111111111111
  caller:        scanner@example.com
  config:        ~/.config/claude-grc/connectors/azure-inspector.yaml
  cache:         ready
  last run:      4h ago (20260430121212-a1b2c3d4)
  cached:        18 resources, 64 evaluations

Status values

  • ready - config exists, Azure CLI can read the subscription, and cached findings are absent or recent
  • not-configured - setup has not run
  • credentials-expired-or-subscription-inaccessible - az account show failed for the configured subscription
  • stale - last run is older than 7 days

Sponsors

Details

Marketplace
GRCEngClub/claude-grc-engineering
Source
plugins/connectors/azure-inspector
Category
Community

More from GRCEngClub/claude-grc-engineering

All 70