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

RFC: Runtime security telemetry below the agent process

Aperta
#428 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
infra-cdk observability RFC-proposal security
Lingua principale
TypeScript
Stelle
143
Fork
46
Merge medio
3g 10h
PR unite (30g)
24

Descrizione

## Primary area

** CDK / infrastructure

## Related issue or feature request

_Complements roadmap **Behavioral circuit breaker**, **Workload-anchored credential binding**, and **Immutable audit export**._

## Summary

Explore integrating **host-level runtime telemetry** (syscall/file/network events from outside the agent process) into ABCA's audit trail, so operators can corroborate or contradict agent-reported actions during incidents. Cedar and application hooks remain; this adds a physics-layer signal.

## Use case and motivation

Application-level guardrails can be reasoned around when instructions and tools coexist in the same trust domain. Editable JSON allowlists are trivially tampered with; **kernel-visible truth** (syscall/file/network) corroborates agent-reported progress and supports adaptive containment (e.g. credential exfiltration patterns). Security teams want tamper-evident records of what the sandbox actually did—especially for unattended background tasks—without relying solely on LLM narrated progress events.

## Proposal

### Architecture sketch

1. **Collector** in MicroVM guest or sidecar streams normalized events (file open, exec, connect) to CloudWatch Logs / S3 with `task_id` dimension.
2. **Correlator** Lambda joins runtime events with `TaskEvents` on `task_id` + time window for operator UI / `bgagent trace`.
3. **Policy feedback (optional later):** high-risk syscall patterns trip **Behavioral circuit breaker** even if Cedar allowed the tool call.

### Deployment stance

- Phase 0: design doc + spike on AgentCore Runtime observability hooks available today.
- Phase 1: opt-in Blueprint `runtime_telemetry: true` for pilots.
- No default-on until performance and PII review complete.

## Out of scope

- Shipping a specific third-party agent product integration in core repo.
- Replacing Cedar decisions with kernel rules in v1.
- Windows/macOS dev environments (compute target is Linux MicroVM only).

## Potential challenges

- AgentCore abstraction may limit BPF/eBPF access; may require alternative compute strategy for full fidelity.
- Volume and cost of raw syscall logs.
- PII redaction in paths and env vars.

## Dependencies and integrations

- `COMPUTE.md`, `SECURITY.md`, `OBSERVABILITY.md`
- Operator dashboard / `bgagent trace download`

## Alternative solutions

- **Stronger Cedar only** — necessary but insufficient when bash and subprocess paths can bypass declared tool calls.
- **Post-task filesystem diff only** — lighter weight; misses network exfiltration.

---

**Note:** Non-triaged RFCs may not get timely review. PRs on non-triaged issues might not be accepted.

* RFC PR:
* Approved by:
* Reviewed by:

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia leggendo COMPUTE.md, SECURITY.md e OBSERVABILITY.md, quindi esamina gli hook di osservabilità di AgentCore Runtime citati nella proposta. Determina se un documento di progettazione e un feasibility spike possono coprire la telemetria a livello di host, la correlazione, il deployment, i costi e i vincoli relativi alle PII. Il lavoro si considera completato con un design di Phase 0 e uno spike revisionati, non con un’integrazione in produzione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
aws
Ambito
cloud, infrastructure, observability, security
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Tranquilla
Chiarezza
Da chiarire
Idoneità per principianti
25/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.