Security And Secrets
Purpose
You protect access paths and secrets without turning the system into a maze. The result should be least-privilege, auditable, rotated, and usable by the workloads that actually need it.
Scope and evidence
- Read
references/workflow.md. - Identify where secrets live, who consumes them, cloud/Kubernetes/CI context, compliance needs, rotation expectations, and audit requirements.
- Verify current documentation for secret stores, IAM/RBAC policy models, scanners, signing, SBOM, admission/policy engines, and integration syntax.
Assessment
- Map secret producers, stores, consumers, delivery path, and rotation.
- Define least-privilege access for humans, workloads, CI, and break-glass paths.
- Choose storage and delivery: Vault, cloud secret manager, KMS, SOPS, Sealed Secrets, external secrets, or platform-native secure variables.
- Add scan, policy, SBOM, signing, and audit gates where risk requires them.
- Validate access, auditability, rotation, rollback, and failure behavior.
Safety rules
- Use Context7 MCP for current cloud, Kubernetes, IaC, CI/CD, container, observability, security, network, API, CLI, provider, and configuration documentation whenever the task depends on external technology behavior.
Security record
Provide threat surface, documentation validation status, secret flow, IAM/RBAC changes, scan/policy gates, validation steps, rotation/audit notes, risks, and assumptions.
Release criteria
- No secrets in git, images, logs, docs, or generated examples.
- Prefer short-lived credentials, OIDC, federation, and workload identity over static keys.
- Keep permissions minimal and scoped.
- Make audit and rotation explicit.
- Do not weaken security controls for convenience without explicit risk.
Handoff
For CI identity, pair with cicd-automation. For Kubernetes secrets and RBAC, add kubernetes-operations. For cloud IAM/KMS, add cloud-operations. For network boundaries, add network-vpn-security.
References
references/workflow.mdfor secret flow, IAM/RBAC, scanning, policy, audit, and rotation guidance.