awslabs / awslabs/agentcore-samples

Sample: attenu-guard authorization for Strands agents on AgentCore Runtime

Open
#2,013 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
3.4k
Forks
1.3k
Avg merge
1d 22h
Merged PRs (30d)
30

Description

Proposing a sample under `03-integrations/agentic-frameworks/strands-agents/authorization/`, a sibling to the existing `observability/` sample.

What it shows: an orchestrator delegating to a sub-agent (agents-as-tools) whose permissions are computed as a subset of the parent's, so a hand-off can only narrow; an out-of-authority tool call cancelled before the tool body runs, through Strands' `BeforeToolCallEvent` hook, no monkeypatching; and the run's decisions recorded in a hash-chained audit log that verifies offline. The offline run uses a scripted model and needs no AWS account; the AgentCore deploy commands are documented, not executed.

The enforcement comes from attenu-guard (Apache-2.0, `pip install 'attenu-guard[strands]'`), which I maintain. It is not part of the AWS SDKs.

Branch is ready on my fork. Per CONTRIBUTING I am opening this issue first; the PR follows and will reference it.

Contributor guide

Open the contributing guide

Research direction

Start in 03-integrations/agentic-frameworks/strands-agents/authorization/ and compare the sibling observability/ sample, then read CONTRIBUTING for sample requirements. Run the offline scripted-model flow without an AWS account and verify that delegated permissions only narrow, unauthorized tool calls are cancelled before execution, and the audit log verifies offline; document AgentCore deployment commands without running them.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, python
Domain
ai, authorization, security
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.