aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

(orchestration): Runtime capability elevation via Cedar HITL

Offen
#422 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
enhancement orchestration security
Vorherrschende Sprache
TypeScript
Sterne
143
Forks
46
Ø Merge
3 T. 10 Std.
Gemergte PRs (30 T.)
24

Beschreibung

## Component

API or orchestration

## Describe the feature

When a headless agent hits a **policy denial** for a resource outside its current scope (file path, egress domain, tool), surface a structured **capability elevation request** to the operator channel; on approval, Cedar issues a narrowed grant and the agent resumes without restarting the task.

## Use case

Static allowlists stall unattended agents on edge cases. Mature deployments separate **enforce** (hard sandbox) from **decide** (dynamic approval for exceptional access). ABCA Cedar HITL covers tool soft-deny but not general **runtime permission expansion**.

## Proposed solution

1. Extend Cedar actions with `capability_elevation_request` payload: `{ resource, action, rationale }`.
2. On soft-deny, transition to `AWAITING_APPROVAL` with elevation-specific event type.
3. Slack/GitHub approve wires to temporary policy overlay (time-boxed, task-scoped).
4. Deny returns agent to alternate path or `NEEDS_HUMAN`.

## Other information

- Complements **rfc-runtime-security-telemetry-layer** and roadmap **Layered credential derivation**.
- Different from **bgagent nudge** (steering content, not permissions).

## Acknowledgements

- [ ] I may be able to implement this feature
- [ ] This might be a breaking change

## Acceptance criteria

- [ ] Elevation request/approve/deny flow documented in `CEDAR_HITL_GATES.md`.
- [ ] Approved elevation expires automatically; audit in `TaskEvents`.
- [ ] Tests with fixture policies for file-read and egress cases.

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne mit CEDAR_HITL_GATES.md und verfolge die TaskEvents-Integration für den bestehenden soft-deny-Ablauf. Suche dann die fixture-policy-Tests für file-read- und egress-Fälle. Als abgeschlossen gilt die dokumentierte request/approve/deny-Entscheidungslogik, task-scoped Erhöhungen, die automatisch ablaufen, sowie Audit-Ereignisse für jede Entscheidung.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
aws, typescript
Bereich
authorization, backend, security
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.