How abukalam2909/eks_eso_poc works
This repository is an infrastructure-as-code POC for delivering AWS Secrets Manager values to pods in a private EKS cluster. The main workflow is rotation in Secrets Manager, ESO retrieval through AWS identity and private endpoints, synchronization into an encrypted Kubernetes Secret, and read-only mounting by the app. Separate branches harden network access, operator access, pod policy, and secret access monitoring. Edges reflect the README’s architecture and controls; most implementation files were not sampled, so their internal wiring is not asserted.
Main entry points: values.yaml ESO controller · externalsecret.yaml Kubernetes Secret · endpoints.tf VPC endpoints · admin_host.tf SSM admin host
Components 23
AWS secrets and identity
- Secrets Manager
- App IAM role
terraform/iam_app.tf - KMS encryption
terraform/kms.tf
Private network and cluster
- Private EKS
terraform/eks.tf - VPC endpoints
terraform/endpoints.tf - SSM admin host
terraform/admin_host.tf - Network policies
kubernetes/app/networkpolicy.yaml - ESO network policy
kubernetes/eso/networkpolicy.yaml
Kubernetes secret delivery
- ESO controller
kubernetes/eso/values.yaml - Secret-reader SA
kubernetes/app/serviceaccounts.yaml - ExternalSecret
kubernetes/app/externalsecret.yaml - SecretStore
kubernetes/app/secretstore.yaml - Kubernetes Secret
kubernetes/app/externalsecret.yaml - App pod
kubernetes/app/deployment.yaml
Access and admission controls
- ESO RBAC
kubernetes/eso/rbac.yaml - Gatekeeper policies
kubernetes/gatekeeper/templates/custom - Policy constraints
kubernetes/gatekeeper/constraints - App namespace
kubernetes/namespaces.yaml
Rotation and detection
- Rotation Lambda
terraform/rotation_lambda/app.py - Rotation schedule
terraform/rotation.tf - CloudTrail
terraform/cloudtrail.tf - Secret-read alert
terraform/detection.tf
Other components
- Operator
Connections 20
- Operator → SSM admin host: tunnels through
README.md - SSM admin host → Private EKS: accesses privately
README.md - Rotation schedule → Rotation Lambda: schedules
README.md - Rotation Lambda → Secrets Manager: rotates value
README.md - ESO controller → Secret-reader SA: mints token for
README.md - Secret-reader SA → App IAM role: assumes role
README.md - ESO controller → VPC endpoints: reads through
README.md - VPC endpoints → Secrets Manager: connects privately
README.md - ESO controller → Kubernetes Secret: syncs value
README.md - SecretStore → Secrets Manager: targets
README.md - ExternalSecret → SecretStore: references
README.md - Kubernetes Secret → App pod: mounts read-only
README.md - KMS encryption → Kubernetes Secret: encrypts at rest
README.md - Network policies → App pod: restricts traffic
README.md - ESO network policy → ESO controller: restricts traffic
README.md - ESO RBAC → ESO controller: limits permissions
README.md - Gatekeeper policies → Policy constraints: enforces constraints
README.md - Policy constraints → App namespace: guards workload
README.md - CloudTrail → Secret-read alert: feeds alerting
README.md - Secret-read alert → Secrets Manager: alerts on unexpected reads
README.md