microsoft / microsoft/agent-framework

Precision Decisioning & Agentic Trust: Cryptographic proof of authorization for agent workflows

Open
#4,203 12 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
13.6k
Forks
2.3k
Avg merge
2d 45m
Merged PRs (30d)
358

Description

Problem: Agent workflows need deterministic authorization, not probabilistic guardrails

When agents orchestrate multi-step workflows — tool calls, sub-agent delegation, external API access — the authorization model today is probabilistic: system prompts, content filters, retry-and-hope. There is no verifiable proof that a specific action was authorized by a specific policy for a specific intent.

This matters for Agent Framework because:

  • Graph-based workflows route decisions through multiple nodes. Each edge crossing is an authorization boundary with no verifiable proof of transit.
  • Multi-agent orchestration delegates between agents. The receiving agent has no way to verify the delegating agent's authority.
  • Tool execution is gated by capability declarations, but there's no signed proof that a tool invocation was authorized against a specific policy at a specific time.

Three Primitives for Verifiable Agent Authorization

We've built and deployed a governance layer that addresses this with three primitives:

1. Precision Decisioning (ALLOW / CLAMP / DENY)

Every agent action request gets a deterministic, signed decision — not a score, not a probability:

  • ALLOW: Action authorized within policy bounds
  • CLAMP: Action partially authorized, constrained to safe envelope
  • DENY: Action rejected, with signed proof of denial
2. Signed Evidence Trail

Every decision is logged to an append-only, signed evidence ledger. Each record links to the previous for tamper detection. Evidence is signed with post-quantum cryptography (ML-DSA-87 / FIPS 204).

3. Verifiable Identity (Intent-to-Action Binding)

Each request binds the agent's stated intent to the authorized action. The verification proof can be validated independently — no callback needed.

Live Example

The gateway is live at governance.taskhawktech.com and implements the A2A protocol.

# Free signup — 100 calls/month, no credit card
curl -s -X POST https://governance.taskhawktech.com/signup \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "agent-framework-test"}'

# Verify an action
curl -s -X POST https://governance.taskhawktech.com/governance/verify \
  -H "X-API-Key: YOUR_KEY_FROM_SIGNUP" \
  -H "Content-Type: application/json" \
  -d '{
    "action_type": "tool_call",
    "action_payload": {"tool": "execute_sql", "query": "SELECT * FROM users"},
    "agent_id": "agent-framework-test"
  }'

Each response includes a signed verification proof, sequential evidence linkage, and a deterministic decision. Downstream services can validate the proof independently.

x402: Payment as Identity (No API Key Path)

For agents operating without pre-provisioned credentials, the gateway supports the x402 payment protocol — USDC on Base. The agent's wallet address becomes its identity. No signup, no API key, no OAuth.

Integration Surface with Agent Framework

This could integrate as:

  1. Workflow middleware: Gate edge transitions with signed decisions
  2. Tool authorization wrapper: Tool fires only if governance returns ALLOW or CLAMP
  3. Agent delegation verification: Delegation carries a signed proof that the receiving agent verifies independently
  4. Evidence integration with checkpointing: Sequential evidence records map to Agent Framework's checkpoint model — you can verify authorization state at any point in a workflow's history

Resources

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names no repository files, tests, or entry points. Start by locating the framework's workflow middleware, tool authorization, agent delegation, and checkpointing extension points, then determine whether the proposed gateway fits the project. Done would require a maintainer-defined integration scope, API contract, verification behavior, and tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
cryptography, python
Domain
authorization, backend-api-design, distributed-systems, security
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.