Scoped Agent Authorization

How AgenticOrg Agents Access Data with Scoped Controls

Configured tool requests can be checked against declared scopes. Audit coverage depends on the enabled integration and retention settings.

The Risk

The Problem: Agents Without Guardrails

Without proper enforcement, AI agents can do things you never intended.

--->
Unrestricted
No Permission Checks

Agents can exceed their mandate

Without a correctly configured enforcement boundary, a READ-scoped agent could still reach a destructive tool.

Revoked access doesn't stop a running agent

A runtime that does not re-check expiry or revocation can continue with stale authorization.

Permission checks guessed from tool names

"process_refund" sounds harmless, so it's treated as a READ. But it actually moves money.

The Solution

How Grantex Supports Scoped Enforcement

Five control stages in this illustrative authorization flow.

1You Grant a Scoped Token

When you create an agent, Grantex creates a grant token — like a keycard that only opens specific doors.

"This agent can READ Salesforce contacts but NOTHING else."

// Grant token scopes
tool:salesforce:read:*
tool:salesforce:delete:*
tool:salesforce:write:*
2Agent Asks to Use a Tool

The AI agent reasons about its task and decides it needs to call a tool — perhaps delete_contact.

Agent reasoning:
"I should clean up the CRM. Let me call delete_contact to remove this old record."
3Grantex Checks the Manifest

Before the tool runs, Grantex looks up delete_contact in its manifest and sees it requires DELETE permission. The agent only has READ.

DENIED.

Manifest Lookup
Tool:delete_contact
Requires:DELETE
Agent has:READ
Result:DENIED
4Permission Hierarchy

In this simplified hierarchy, a WRITE grant includes READ, while a READ-only grant does not authorize WRITE, DELETE, or ADMIN operations.

ADMIN
DELETE
WRITE
READ
Higher levels include all permissions below
5Authorization Decisions Can Be Logged

When audit integration is enabled, allow and deny events can record timestamp, agent, tool, connector, and reason. Completeness, retention, immutability, and audit suitability must be verified for the deployment.

Audit Log
14:23:01sales-agentget_contactALLOW
14:23:03sales-agentlist_dealsALLOW
14:23:05sales-agentdelete_contactDENY
14:23:05sales-agentupdate_dealDENY

Before vs After

A clear comparison of what changes with Grantex.

Before Grantex

Permission guessed from tool name keywords

"process_refund" classified as a harmless READ

No enforcement layer in LangGraph pipeline

Agents call tools directly with no middleware

Keyword matching is brittle and incomplete

"generate_invoice" might mean READ or WRITE

No audit trail of permission decisions

Missing authorization evidence makes later review incomplete

After Grantex

Manifest-based: each tool declares its required permission

No guessing. delete_contact = DELETE. Period.

Offline JWT verification at the LangGraph boundary

No network call needed. Tokens are self-contained.

Local token checks can avoid a provider round trip

Measure latency and failure behavior in your deployment.

Manifests describe supported native connector tools

Verify manifest coverage against the current runtime registry.

Illustrative Example

See It In Action

A fictional authorization example, not a live tenant trace or production-readiness result.

User creates Sales Agent

Token scopes: tool:salesforce:read:*

Agent thinks: "I need to get contacts"

Calls get_contact

Grantex checks: get_contact needs READ

ALLOWED

Agent has READ --> ALLOWED

Agent thinks: "Let me delete this old contact"

Calls delete_contact

Grantex checks: delete_contact needs DELETE

DENIED

Agent has READ --> DENIED

Agent responds to user

"I don't have permission to delete contacts."

How are business onboarding cases authorized?

In repository source, the governed-case runtime checks an active tenant role, its registered provider tools, the exact case purpose on a local allowlist, and a delegated grant before every provider call. A missing or denied check stops the call. The case feature is off until an operator enables and configures it for a tenant; availability in a hosted deployment depends on its deployed revision.

What does a human still control?

An agent can prepare evidence and a recommendation. A signed-in person must review or decide the case; an API key, agent token, or MCP tool cannot act as that person. The currently published Grantex Python SDK checks token and tool authority, but does not yet enforce a token-level case purpose or a per-case cap. The local purpose check is not a substitute for those future controls.

Read the case setup and enforcement boundary

Control Model

Declared
Connector Manifests
Verify current tool coverage
Local
Token Verification
Measure latency and revocation behavior
4-Level
Permission Hierarchy
READ / WRITE / DELETE / ADMIN
Tested
Enforcement Quality
Exercise allowed, denied, expired, and revoked cases

Ready to evaluate AI agents with scoped authorization controls?

Test manifest coverage, token handling, denied cases, audit records, latency, and rollback in your own deployment before relying on these controls.