aws-samples / aws-samples/sample-autonomous-cloud-coding-agents
feat(security): principal-to-repo authorization
- Lenguaje dominante
- TypeScript
- Estrellas
- 146
- Forks
- 46
- Merge medio
- 3 d 10 h
- PR fusionados (30 d)
- 24
Descripción
**Context:** ROADMAP.md → Credentials and authorization → Principal-to-repo authorization
**Related:** #249, #389 (mentions principal-to-repo when available)
---
## Component
API or orchestration
## Describe the feature
Map Cognito identities (and future auth principals) to allowed repository sets so users can only submit tasks, webhooks, and channel triggers against repos they are authorized to access. Enforce at task creation and admission time (fail-closed).
## Use case
Multi-user deployments cannot rely on shared PATs or implicit trust. Operators need tenant isolation: Alice may trigger work on `org/frontend` but not `org/payments-core`. Without this, any authenticated user with API access can target any onboarded repo.
## Proposed solution
1. Add a `PrincipalRepoAccess` (or equivalent) store: principal identity → allowed `repo` patterns or explicit repo IDs.
2. Validate in `createTaskCore` / webhook processors / channel adapters before hydration.
3. Admin/operator APIs or CDK Blueprint hooks to manage mappings per team.
4. Return `403 REPO_NOT_AUTHORIZED` with clear CLI messaging.
5. Document operator setup in user/developer guides.
## Other information
- Complements per-session IAM scoping (#209) and identity propagation (#249).
- Scheduled triggers (#389) should inherit the same authorization model.
- Design context: `docs/design/SECURITY.md`, `docs/design/API_CONTRACT.md`.
- [ ] This might be a breaking change
Guía de contribución
Línea de trabajo
Empieza leyendo docs/design/SECURITY.md y docs/design/API_CONTRACT.md, y luego sigue el recorrido de createTaskCore, los procesadores de webhook y los adaptadores de canal. Define cómo se gestionan y aplican las asignaciones de principal a repositorio antes de la hidratación, incluidos los triggers programados. Se considera terminado cuando el acceso no autorizado falla de forma segura con 403 REPO_NOT_AUTHORIZED, los mensajes de la CLI son claros y la configuración para operadores está documentada.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- aws, typescript
- Área
- api, authentication, authorization, backend, security
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Estado de actividad
- Tranquilo
- Claridad
- Bastante claro
- Aptitud para principiantes
- 35/100