Get started

Run an authorization decision locally.

Install

git clone https://github.com/sunilgentyala/hwaam-authorization-mesh.git
cd hwaam-authorization-mesh
python -m pip install -e .

Evaluate

hwaam evaluate \
  --policy examples/policy.json \
  --request examples/request_allowed.json \
  --secret demo-secret \
  --issuer-secret demo-issuer-secret \
  --trusted-issuers identity-provider,user:suresh

--secret signs the engine's own receipt. --issuer-secret verifies the signed security context, approvals, and delegation hops attached to the request — the engine never trusts those fields unsigned. Prefer --secret-file/--secret-env/--secret-stdin (and the matching --issuer-secret-* forms) over the bare flag outside of local testing.

Run tests

python scripts/run_tests.py

Run benchmark

python scripts/benchmark.py --iterations 20000
python scripts/generate_results.py

Try denial cases

hwaam evaluate \
  --policy examples/policy.json \
  --request examples/request_cross_tenant.json \
  --secret demo-secret \
  --issuer-secret demo-issuer-secret \
  --trusted-issuers identity-provider,user:suresh

Exit codes reflect the decision: 0 allow, 4 conditional allow (obligations still outstanding), 2 deny, 1 execution error — so a caller can't mistake a conditional allow for a clean pass, and CI pipelines can distinguish enforcement failures from execution errors.