azure-arg-external-evaluation-policy-author

Designs and tests Azure Policy External Evaluation policies using ARG queries.

1.7k|1.2k|Updated Jul 27, 2017
One-click install
npx skills add https://github.com/Azure/azure-policy --skill azure-arg-external-evaluation-policy-author
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-arg-external-evaluation-policy-author
Source: https://github.com/Azure/azure-policy/tree/main/ExternalEvaluationPolicies/agent-skills/azure-arg-external-evaluation-policy-author
Command: npx skills add https://github.com/Azure/azure-policy --skill azure-arg-external-evaluation-policy-author

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users to author and test Azure Policy External Evaluation policies that query Azure Resource Graph at request-time, enabling enforcement decisions based on live ARG data. It outputs a complete artifact bundle including a policyDefinition.json, a test-flow.http, and an EXPLANATION.md to document decisions and co-design iterations. It is read-only for the policy authoring process and does not modify customer resources.

Core Features & Use Cases

  • Iterative KQL co-design: interactively craft and validate ARG queries that project a single claim used by the policy.
  • Artifact generation: produce the canonical policyDefinition.json, inlined test-flow.http, and EXPLANATION.md that document the workflow.
  • Guided knowledge references: leverage canonical knowledge files to ensure correct policy shape and endpoint usage.

Quick Start

Provide your policy intent and let this skill guide you through crafting an External Evaluation ARG policy and its artifacts.

Frequently Asked Questions about azure-arg-external-evaluation-policy-author

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I author an Azure Policy that queries Azure Resource Graph for runtime enforcement?

To author an Azure Policy with Azure Resource Graph queries, you design an External Evaluation policy that queries ARG at request-time to decide enforcement. This generates a complete artifact bundle including a policyDefinition.json, test-flow.http, and EXPLANATION.md for review.

What is Azure Policy External Evaluation and when do I need it?

Azure Policy External Evaluation is a mechanism that enables enforcement decisions based on live Azure Resource Graph data at request-time. You need it for subscription-scoped resource operations requiring ARG-backed decisions that standard policy definitions cannot evaluate.

How do I create and validate KQL queries for an Azure Resource Graph policy?

You iteratively co-design and validate KQL queries that project a single claim used by the Azure Resource Graph policy. This interactive KQL co-design process ensures the query produces the correct claim before generating the final policy artifacts.

Can I use Azure Policy External Evaluation for subscription-scoped resource operations?

Yes, Azure Policy External Evaluation applies specifically to subscription-scoped resource operations requiring ARG-backed decisions. It evaluates live Azure Resource Graph data at runtime to determine enforcement outcomes for those operations.

What artifacts are generated when creating an Azure ARG External Evaluation policy?

Creating an Azure ARG External Evaluation policy outputs a complete artifact bundle containing a policyDefinition.json for the policy shape, a test-flow.http for REST endpoint testing, and an EXPLANATION.md documenting decisions and co-design iterations.

Does authoring Azure Policy External Evaluation policies modify my customer resources?

No, authoring Azure Policy External Evaluation policies is a read-only process for policy creation and does not modify customer resources. It solely generates policy artifacts and validates KQL queries against Azure Resource Graph.