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

RFC: centralized policy framework with PolicyDecisionEvent

Đang mở
#482 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
governance RFC-proposal security
Ngôn ngữ chính
TypeScript
Star
143
Fork
46
Merge trung bình
3 ngày 10 giờ
Pull request đã merge (30 ngày)
24

Mô tả

**Context:** ROADMAP.md → Centralized policy framework
**Related:** #230 (event-driven governance), Cedar HITL (shipped)

---

## Primary area

Cross-cutting / multiple

## Related issue or feature request

#230 (Event-Driven Governance and Actions), shipped Cedar HITL gates

## Summary

Unified **Cedar-based policy framework** with `PolicyDecisionEvent` audit schema. Three enforcement modes with **observe-before-enforce** rollout across tool calls, lifecycle events, and future event-driven governance.

## Use case and motivation

Policy decisions today are fragmented (PreToolUse Cedar, guardrails, bash allowlists). Compliance needs a single auditable decision stream and consistent observe/enforce rollout.

## Proposal

1. Define `PolicyDecisionEvent` schema: `decision`, `policy_id`, `matching_rule_ids`, `context`, `task_id`, timestamp.
2. Emit on every Cedar evaluation + lifecycle policy hook (#230).
3. Modes: `observe`, `enforce`, `disabled` per policy pack.
4. Export to immutable audit (#237) when available.
5. Operator dashboard: deny rates by repo/policy.

## Out of scope

- Replacing Bedrock Guardrails (input/output screening stays separate).
- Full implementation of all #230 semantic gates in v1.

## Potential challenges

- cedarpy/cedar-wasm parity (see AGENTS.md cedar pin rules).
- Volume of decision events at high task throughput.
- Migration from current HITL-only audit shape.

## Dependencies and integrations

- `TaskEventsTable`, FanOutConsumer, #230 RFC.
- `docs/design/CEDAR_HITL_GATES.md`.

## Alternative solutions

- Extend current HITL audit only—less unified for non-tool policies.
- OPA/Cedar split—rejected for dual engine maintenance.

---

**Note:** Non-triaged RFCs may not get timely review.

- RFC PR:
- Approved by:
- Reviewed by:

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Hướng nghiên cứu

Trước tiên, hãy đọc ROADMAP.md tại mục «Centralized policy framework» và docs/design/CEDAR_HITL_GATES.md, sau đó xem lại các tham chiếu đến TaskEventsTable và FanOutConsumer. Đề xuất này bao gồm việc đánh giá Cedar, các lifecycle hook, các chế độ rollout, tính năng xuất audit và một dashboard; để được coi là hoàn tất, phạm vi phải được review và phê duyệt, đồng thời các trường RFC không còn được để trống.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
aws, typescript
Lĩnh vực
backend-api-design, observability, security
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
35/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.