Skip to content

Add attenu-guard authorization sample for Strands on AgentCore Runtime - #2014

Open
rafaelasor wants to merge 1 commit into
awslabs:mainfrom
rafaelasor:attenu-guard-integration
Open

Add attenu-guard authorization sample for Strands on AgentCore Runtime#2014
rafaelasor wants to merge 1 commit into
awslabs:mainfrom
rafaelasor:attenu-guard-integration

Conversation

@rafaelasor

Copy link
Copy Markdown

Adds 03-integrations/agentic-frameworks/strands-agents/authorization/, a
Strands + AgentCore Runtime sample showing:

  • an orchestrator delegating to a sub-agent (agents-as-tools) whose permissions
    are computed as the meet of its request and the parent's authority, so a
    hand-off can only ever narrow
  • an out-of-authority tool call cancelled before the tool body runs, via
    Strands' BeforeToolCallEvent hook (no monkeypatching)
  • the run's decisions recorded in a hash-chained, offline-verifiable audit log

Enforcement comes from attenu-guard (Apache-2.0, not part of the AWS SDKs).

How to run: uv venv && uv pip install -r requirements-dev.txt, then
python local_run.py (offline, scripted model, no AWS account) and
python -m pytest. The AgentCore deploy commands (agentcore configure /
launch / invoke) are documented in the README but not executed as part
of this PR.

What the reader sees: the sub-agent reads logs (permitted), then tries to
export findings to an external destination (not permitted) — the call is
denied before the tool body runs, and the offline run prints the denial plus
a verified evidence bundle.

Refs #2013 (opened first per CONTRIBUTING).

Disclosure: I maintain attenu-guard.

Shows a Strands orchestrator delegating to a sub-agent through the
agents-as-tools pattern, with per-agent authority enforced in-process
by attenu-guard (Apache-2.0). The sub-agent's permissions are computed
as the meet of its request and its parent's authority, so a hand-off
can only ever narrow; an out-of-authority tool call is cancelled
before the tool body runs, and the run's decisions are recorded in a
hash-chained, offline-verifiable audit log.

Runs fully offline against a scripted model (no AWS account, no model
access) with a matching pytest suite; the AgentCore deploy commands
are documented but not executed. Sample author maintains attenu-guard.
@github-actions github-actions Bot added 03-integrations 03-integrations agentic-frameworks 03-integrations/agentic-frameworks labels Aug 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

03-integrations 03-integrations agentic-frameworks 03-integrations/agentic-frameworks

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant