Skip to main content
Source

This page is generated from devops-agent/eks-security/SKILL.md. Edit the source, not this page.

EKS Security & Compliance

Execution model — fully autonomous. This skill runs autonomously with no interactive prompts. If the request provides sufficient context (compliance regime, workload sensitivity, cluster topology), proceed through the full 7-layer analysis. If critical context is missing, infer from cluster state or apply documented defaults, noting all assumptions in the report output.

End-to-end, opinionated security and compliance guidance for Amazon EKS, structured as a 7-layer stack plus a compliance-regime cross-cutting view. This skill is discovery-driven — the right hardening stack is a function of (compliance regime x OS-standardization mandate x team skill x audit timeline x workload sensitivity x air-gap requirement x scale x operational-overhead tolerance). Skipping the discovery context makes the recommendation wrong about half the time.

Two AWS-published guides are the canonical foundation and every recommendation must align with one or both: the EKS Best Practices: Compliance guide and the EKS Best Practices: Runtime Security guide.

The accuracy bar (non-negotiable for this skill). Compliance is the one domain where customers validate every claim against an auditor. Compliance status changes over time — always defer to the live AWS Services in Scope page before quoting program coverage in any customer-facing document. Never state a cryptographic-module status, FedRAMP boundary, or certification you cannot cite to an AWS-published source. When you can't ground a claim, say so — do not synthesize.

Prerequisites — Agent Space IAM Permissions​

A ready-to-use IAM policy document is available at references/iam-policy.json — attach it directly to your Agent Space execution role.

The following read-only permissions are included:

ServiceRequired ActionsPurpose
EKSeks:DescribeCluster, eks:ListClusters, eks:ListAddons, eks:DescribeAddon, eks:ListAccessEntries, eks:ListPodIdentityAssociationsCluster configuration, add-on inventory, access model
EC2ec2:DescribeInstances, ec2:DescribeLaunchTemplates, ec2:DescribeSecurityGroups, ec2:DescribeImagesNode groups, AMI identification, security group posture
IAMiam:ListRoles, iam:GetRole, iam:ListPolicies, iam:GetPolicyVersion, iam:ListOpenIDConnectProvidersIRSA/Pod Identity roles, OIDC providers
GuardDutyguardduty:ListDetectors, guardduty:GetDetector, guardduty:ListFindingsRuntime monitoring status, active findings
Security Hubsecurityhub:GetEnabledStandards, securityhub:GetFindingsCompliance standards enabled, security findings
Configconfig:DescribeConfigRules, config:GetComplianceDetailsByConfigRuleConfiguration compliance posture
CloudTrailcloudtrail:DescribeTrails, cloudtrail:GetTrailStatusAudit logging verification
Kubernetes APIRead access to namespaces, pods, networkpolicies, podsecuritypolicies, clusterroles, clusterrolebindingsWorkload security posture assessment

Note: This skill operates primarily as advisory guidance. When API access is available, it enriches recommendations with live cluster state. When API access is unavailable, it provides full guidance based on the context provided in the request.

When to Use This Skill​

Activate when the goal involves:

  • Harden an EKS cluster or prepare for a first-time compliance audit (HIPAA, PCI-DSS, FedRAMP, SOC 2, ISO 27001, GDPR, HITRUST, NIST 800-53/171)
  • Choose an OS / AMI strategy for security (Bottlerocket vs AL2023-with-CIS vs Ubuntu Pro vs RHEL vs Auto Mode)
  • Decide identity & access (EKS Pod Identity vs IRSA; Access Entries vs aws-auth)
  • Apply workload security (Pod Security Admission, Kyverno/OPA, NetworkPolicy, Security Groups for Pods)
  • Secure the image supply chain (ECR Enhanced Scanning, Cosign/Notation signing, admission verification)
  • Add runtime security (GuardDuty for EKS, Falco) and audit logging (control-plane logs, CloudTrail, SIEM)
  • Wire compliance accelerators (Config conformance packs, Security Hub, Artifact; Audit Manager for existing setups only — maintenance mode)

Don't use this skill for:

  • Non-EKS container platforms — ECS/Fargate-without-EKS (defer to ECS security guidance) or ROSA (Red Hat manages the stack differently)
  • AWS account-level / org-wide security with no EKS-specific angle (IAM org policy, SCPs, SSO, multi-service GuardDuty)
  • GenAI/GPU workload security specifically (model-artifact provenance, training-data confidentiality, GPU-node compliance) — use EKS GenAI guidance
  • Generic EKS architecture/cost/upgrade decisions with no security driver
  • Generating Terraform/Helm or auditing a live cluster's operational posture

Discovery First — Context Gates​

Do NOT recommend a hardening stack without the following context. The single most common mistake is reflexively saying "use Bottlerocket" or "use AL2023 with CIS hardening" without confirming the customer's context. The first four items alone determine ~80% of the recommendation.

Autonomous Context Resolution​

If the request does not specify the following three items, infer from cluster context (tags, labels, namespace naming, existing policies) or apply the stated defaults. Note all assumptions in the report output.

  1. Compliance regime(s) — If not determinable from cluster context (e.g., tags like compliance:hipaa, namespace names, existing admission policies), assume SOC 2 as the baseline and note the assumption. Available regimes: None / SOC 2 / HIPAA / PCI-DSS / FedRAMP Moderate / FedRAMP High / GDPR / ISO 27001 / HITRUST / NIST 800-53/171 / CJIS / DISA IL5
  2. Workload sensitivity — If not determinable from cluster context (e.g., namespace labels, network policies, encryption settings), assume internal and note the assumption. Levels: Public / internal / PII / PHI (HIPAA) / cardholder data (PCI) / federal
  3. OS / AMI preference — If not determinable from node AMI IDs or launch templates, assume Open to AWS defaults and note the assumption. Options: Open to AWS defaults / Bottlerocket-first / AL2023+CIS / Ubuntu mandate / RHEL mandate / EKS Auto Mode

Context Already Provided When​

The request already provides sufficient context — for example:

  • "Harden my HIPAA cluster running Bottlerocket on EKS 1.31 in us-east-1"
  • "What's the FedRAMP Moderate security stack for EKS with AL2023?"
  • "We need SOC 2 compliance for our PII workloads on EKS Auto Mode"

Additional Context (gather when depth allows, use defaults if unavailable)​

  1. Audit timeline? None / <3 mo (urgent) / 3-6 mo / 6-12 mo / continuous.
  2. Cluster topology? Single vs multi-cluster, single vs multi-account, multi-region, EKS Anywhere, Hybrid Nodes, GovCloud.
  3. Team K8s/security skill? Low / moderate / high / mixed.
  4. Operational-overhead tolerance? Zero (managed-only) / low / moderate / high.
  5. Current security tooling baseline? None / AWS-native / third-party CNAPP / OSS / hybrid.

Full required + recommended question set, the 5 adoption-challenge archetypes, and the 8-step response framework: references/engagement-and-response.md.

The 7-Layer Security & Compliance Stack​

Walk the layers bottom-up on a first engagement; each layer's controls compound on the previous.

LayerFocusAWS-canonical defaultReference
1 — Compute / OS / AMINode hardeningBottlerocket (immutable, SELinux-enforcing, minimal); else CIS-hardened AL2023 via Image Builder; respect vendor-OS mandates (Ubuntu Pro / RHEL)os-ami-hardening.md
2 — Identity & AccessWho can do whatEKS Pod Identity (workloads) + EKS Access Entries (cluster access)identity-and-access.md
3 — Workload SecurityPod + network posturePSA restricted + Kyverno (or OPA) + VPC CNI NetworkPolicy (default-deny) + Security Groups for Podsworkload-security.md
4 — Image Supply ChainTrust what you runECR Enhanced Scanning (Inspector) + Cosign/Notation signing + Kyverno verifyImages admissionimage-supply-chain.md
5 — Runtime SecurityDetect at runtimeGuardDuty for EKS (EKS Protection + Runtime Monitoring); Falco for OSS/custom rules; findings → Security Hubruntime-security.md
6 — Audit Logging & ForensicsProve what happenedEKS control-plane logs (audit + authenticator minimum) + CloudTrail + VPC Flow Logs + SIEM forwardingaudit-logging.md
7 — Compliance AcceleratorsContinuous control evidence (CIs)Config conformance packs + Security Hub + Artifact (download attestations); Audit Manager existing setups only (maintenance mode)compliance-accelerators.md

The AWS-canonical reference stack for a new commercial cluster: Bottlerocket (L1) + Pod Identity + Access Entries (L2) + PSA restricted + Kyverno + VPC CNI NetworkPolicy + Security Groups for Pods (L3) + ECR Enhanced Scanning + Cosign signing (L4) + GuardDuty for EKS (L5) + control-plane audit+authenticator logging + CloudTrail (L6) + Config conformance packs + Security Hub (L7; Audit Manager for existing setups only — maintenance mode). The vendor-OS path applies the same stack with a Layer-1 substitution only.

Cross-cutting concerns (span every layer, aligned to the AWS Best Practices security areas): data encryption & secrets management (default envelope encryption on K8s 1.28+, CMK, Secrets Manager/CSI/ESO) → encryption-and-secrets.md; multi-tenancy & multi-account isolation (soft vs hard, namespaces→cluster-/account-per-tenant) → multi-tenancy.md; incident response & forensics (the runbook when a detection fires) → incident-response-and-forensics.md; and the shared-responsibility model — AWS secures the control plane (control-plane nodes + etcd) and assumes more as you move self-managed → MNG → Fargate; you secure the data plane, node OS, workloads, and the controls in this skill. Each reference includes its per-layer shared-responsibility split.

Compliance-Regime Scope (cross-cutting)​

EKS is natively in scope for PCI-DSS L1, HIPAA-eligible (BAA required), SOC 1/2/3, ISO 27001/27017/27018/9001, FedRAMP Moderate (commercial) and High (GovCloud only), HITRUST CSF, IRAP, C5, K-ISMS, ENS High, OSPAR, DISA IL4/IL5 (GovCloud only — commercial reaches IL2). AWS provides alignment / framework support (not independent attestation) for GDPR, NIST SP 800-53/800-171, and CJIS — the customer owns workload-level controls. Per-regime nuance, the scope table, and the worked HIPAA/PCI/FedRAMP/GDPR/Auto-Mode scenarios: references/compliance-regimes.md. Dedicated per-regime quick-starts for the three most common regimes: HIPAA, PCI DSS, SOC 2.

Always include the disclaimer in customer-facing output: "Compliance status changes over time — verify on the live AWS Services in Scope page before quoting program coverage." And precision matters: EKS is HIPAA-eligible (with a signed BAA), not "HIPAA-compliant"; FedRAMP High = GovCloud only, Moderate = commercial regions.

Securing an EKS Auto Mode Cluster​

When the assessed cluster runs Auto Mode (detectable via eks:DescribeCluster — computeConfig.enabled), adjust the report: Auto Mode shifts Layer 1 (and the NetworkPolicy enforcement engine) to AWS — it is not "security handled." Facts verified 2026-07-17 against Auto Mode security considerations:

  • AWS handles: node lifecycle + patching (21-day max node lifetime, weekly AMI security releases), immutable Bottlerocket-variant node OS (SELinux enforcing, read-only root, no SSH/SSM), IMDSv2 hop-limit-1, and the managed CNI / NetworkPolicy engine / EBS CSI / LB controller / pre-installed Pod Identity agent. Do not flag these as customer findings.
  • The customer still owns: PSA restricted + Kyverno/OPA, NetworkPolicy content (default-deny), GuardDuty enablement, control-plane logging + CloudTrail + Security Hub, secrets management and the envelope-encryption CMK decision, Access Entries/IAM, image scanning/signing, workload security, and StorageClass-level EBS encryption for persistent volumes. Assess and report each of these.
  • Avoid Auto Mode for security when (as of 2026-07-17): a custom-AMI / baked-in-hardening mandate exists; Cilium or another alternate CNI is required; per-Pod security groups via the classic SGPP CRD are mandated (NodeClass-level Pod SGs do work on Auto Mode); host-level agents or forensic node access are mandated; or Windows nodes are needed. FIPS is not a blocker — Auto Mode offers FIPS-compatible AMIs (NodeClass advancedSecurity.fips, US regions).

Full responsibility split, verification sources, and the stale-claim traps: references/auto-mode-security.md.

Security Baseline (non-negotiable — every recommendation includes this)​

Regardless of regime, every hardening recommendation MUST include:

  • EKS Pod Identity (recommended for new workloads; IRSA is a fully supported alternative — see note) — never static AWS keys
  • EKS Access Entries for cluster access — never the aws-auth ConfigMap on new clusters
  • EKS control-plane logging — audit + authenticator at minimum
  • GuardDuty for EKS — EKS Protection (audit-log) + Runtime Monitoring (agent)
  • ECR Enhanced Scanning on all production repositories
  • Pod Security Admission restricted on production namespaces
  • NetworkPolicy default-deny on production namespaces (VPC CNI native, or Calico/Cilium on self-managed)
  • Encryption at rest — EKS provides default envelope encryption of all Kubernetes API data (KMS provider v2, AWS-owned key) on K8s 1.28+ with no action required; bring a customer-managed KMS key (CMK) for control over rotation/audit, and use CMKs for EBS/S3/EFS under compliance regimes (etcd EBS volumes are also EBS-encrypted independently)
  • Encryption in transit — TLS in-cluster; mTLS via service mesh for high-sensitivity workloads
  • Secrets via Secrets Manager + Secrets Store CSI Driver + ASCP (or External Secrets Operator) — never plain Kubernetes Secrets in production; never baked into images
  • CloudTrail for EKS API audit; private API endpoint (or restricted public CIDR allowlist) for production
  • Preventive governance (multi-account): enforce the above with EKS IAM condition keys in SCPs/IAM (private endpoint, CMK encryption, approved K8s version, deletion protection) so non-compliant clusters can't be created — see identity-and-access.md

Hardening Roadmap (30 / 60 / 90)​

  • Days 1-30 (baseline, non-disruptive): enable control-plane audit+authenticator logging; enable GuardDuty for EKS; enable Security Hub (CIS AWS Foundations + AWS FSBP); enable ECR Enhanced Scanning; run kube-bench for the current CIS posture. Change nothing yet — establish the baseline.
  • Days 31-60 (identity + workload): migrate aws-auth → Access Entries (planned change window, kubectl access pre-validated); migrate/justify IRSA → Pod Identity; enable PSA restricted (start audit mode → enforce); deploy Kyverno/OPA; enforce NetworkPolicy default-deny.
  • Days 61-90 (OS + image + accelerators): migrate to Bottlerocket (or build CIS-hardened AL2023 via Image Builder); enable ECR image signing; enable the applicable AWS Config conformance pack (HIPAA/PCI/NIST/FedRAMP) + validate Security Hub against the compliance standard (Audit Manager existing setups only — maintenance mode; see references/compliance-accelerators.md); download attestations from AWS Artifact.
  • Greenfield: deploy the full 7-layer stack at cluster creation, not retrofitted — and get the Day 0 settings below right first.

Day 0 checklist (greenfield — settings that are one-way or costly to retrofit)​

Facts verified 2026-07-17 against the linked AWS docs. Only cluster name and VPC are truly immutable; the rest are changeable later but leave gaps or one-way ratchets — misstating which is which is an audit-refutable claim.

SettingSet at creation toChangeable later?
Authentication modeAPI (Access Entries only)One-way ratchet — you can move toward the API modes but can't remove the EKS API/access entries once enabled; starting at API avoids the aws-auth migration entirely
Envelope-encryption CMKCustomer-managed KMS key (default AWS-owned key applies on 1.28+ if unset)Can be associated later, but irreversible once set — and a disabled/deleted CMK degrades or bricks the cluster
Cluster name / VPCFinal valuesNo — immutable; a change means a new cluster
Kubernetes versionA current (ideally latest-1) versionUpgrade-only below creation version — no downgrade past the version the cluster was created at; post-upgrade rollback to the previous minor version exists (7-day window, one minor version); an old start burns support runway or forces extended support
Endpoint accessPrivate (or public with tight CIDR allowlist)Yes — but every day public-by-default is exposure
Control-plane loggingaudit + authenticator minimumYes — but events before enablement are unrecoverable; auditors ask for history

Enforce all of the above org-wide with EKS IAM condition keys in SCPs — see identity-and-access.md.

Quick-Reference Decision Trees​

Routing aids for the three most common either/or questions (details in the linked references). Pod Identity support matrix verified 2026-07-17 against pod-identities.html.

Pod Identity vs IRSA (identity-and-access.md):

  • Fargate, Windows nodes, EKS Anywhere, or non-EKS Kubernetes → IRSA (Pod Identity runs only on Linux EC2 nodes in EKS, as of 2026-07-17)
  • Cross-account → either: Pod Identity does it via target-role chaining; IRSA via direct OIDC federation (single hop, longer sessions)
  • Greenfield on Linux EC2 (incl. Auto Mode) → Pod Identity
  • Existing working IRSA → keep it; migrate at the next major refactor if desired

Bottlerocket vs AL2023 (os-ami-hardening.md):

  • Compliance mandate → check which CIS benchmark applies (CIS Bottlerocket vs CIS AL2023 are distinct documents) before choosing
  • Custom AMI / general-purpose OS / vendor kernel modules needed → AL2023 (CIS-hardened via Image Builder)
  • Immutability preference, container-first, no custom-AMI need → Bottlerocket

Access Entries vs aws-auth ConfigMap (identity-and-access.md):

  • New cluster → Access Entries, always (create in API mode; never configure aws-auth)
  • Existing cluster on aws-auth → migrate at the next change window (API_AND_CONFIG_MAP transition, break-glass principal pre-validated)

Top Guardrails (the high-cost mistakes)​

  • Don't recommend a stack before the discovery context is confirmed — the #1 mistake.
  • Don't call IRSA "legacy" — AWS docs say Pod Identity is recommended for new workloads while IRSA remains a fully supported alternative (and is the right choice on Fargate, Windows nodes, unsupported SDKs, or cross-account OIDC federation). "Legacy" applies to the aws-auth ConfigMap, not IRSA.
  • Don't use aws-auth ConfigMap on new clusters — it's deprecated; use Access Entries (auditable in CloudTrail).
  • Don't recommend PodSecurityPolicy (PSP) — removed in Kubernetes 1.25+; use PSA + Kyverno/OPA.
  • Don't recommend AWS App Mesh for new work — AWS set its end-of-support date as September 30, 2026 (new sign-ups already closed; verify current status on the App Mesh page); use Istio/Linkerd/Cilium mesh or VPC Lattice.
  • Don't recommend EKS Auto Mode when a hard CIS-hardened-custom-AMI requirement exists — Auto Mode doesn't support custom AMIs (as of 2026-07-17); use Bottlerocket on self-managed Karpenter NodePools. Cilium CNI is also not supported on Auto Mode. See auto-mode-security.md.
  • Don't promise "HIPAA-compliant" — EKS is HIPAA-eligible; a signed BAA is required and the customer owns workload-level controls.
  • Don't conflate FedRAMP Moderate (commercial) with High (GovCloud); FIPS 140-3 (Bottlerocket FIPS AMIs) with 140-2; or CIS AL2 with CIS AL2023 benchmarks (distinct documents).
  • Don't treat a CMK as free of operational risk — once a CMK is the envelope-encryption key, disabling it degrades the cluster (the API server can't boot on restart; ~30-day window to re-enable before forced auto-upgrade) and deleting it makes the cluster unrecoverable. Guard the CMK with least-privilege IAM + a CloudWatch alarm.
  • Don't synthesize compliance claims — cite an AWS-published source or recommend escalation.

Escalation​

Recommend engaging AWS Professional Services or an AWS Solutions Architect for:

  • First-time certification on a mission-critical regulated workload (highest stakes).
  • FedRAMP High / GovCloud → federal partner engagement.
  • Top Secret / Secret classified → AWS Top Secret/Secret region partner (out of scope here — commercial + GovCloud only).
  • EKS Anywhere (air-gapped) or Hybrid Nodes inside a FedRAMP boundary → shared-responsibility boundary mapping (AWS manages no control plane in air-gapped EKS Anywhere; Hybrid on-prem nodes are outside the FedRAMP boundary).
  • Multi-tenant SaaS with cross-tenant PHI / cardholder / federal isolation.
  • Customer vs auditor disagreement on AWS-managed-control acceptability (e.g., AWS-managed AMI patching vs documented patch cycle) → joint review with the auditor.
  • Written legal commitment beyond Artifact (custom DPA, FedRAMP ConMon SLA, sovereignty-plus).
  • AI/ML workloads with PHI/cardholder/federal data → joint AI/ML + Security review.
  • Cannot ground the response → do not synthesize; escalate. Rejected compliance guidance leads to audit findings and erodes trust.

Full criteria: references/engagement-and-response.md.

How to Use the References​

Progressive disclosure — the essentials are above; load a reference only when the task needs that depth:

ReferenceLoad when the task is about...
engagement-and-response.mdFull discovery question set, adoption-challenge archetypes, the 8-step response framework, escalation criteria
os-ami-hardening.mdLayer 1 — Bottlerocket vs AL2023 vs Ubuntu/RHEL, CIS benchmark hierarchy, Image Builder hardened-AMI pipeline, FIPS
auto-mode-security.mdSecuring an EKS Auto Mode cluster — AWS-handled vs customer-owned controls, when to avoid Auto Mode for security
identity-and-access.mdLayer 2 — Pod Identity vs IRSA, Access Entries vs aws-auth, access policies
workload-security.mdLayer 3 — PSA, Kyverno/OPA, NetworkPolicy, Security Groups for Pods, service-mesh mTLS
image-supply-chain.mdLayer 4 — ECR Enhanced Scanning, Cosign/Notation signing, admission control, third-party scanners
runtime-security.mdLayer 5 — GuardDuty for EKS, Falco, Security Hub aggregation
audit-logging.mdLayer 6 — control-plane log types, CloudTrail, VPC Flow Logs, SIEM forwarding, retention
compliance-accelerators.mdLayer 7 — Config conformance packs, Security Hub, Artifact, Audit Manager (maintenance mode), kube-bench
encryption-and-secrets.mdDefault envelope encryption (KMS v2), CMK + its operational risk, EBS/EFS/FSx encryption, Secrets Manager/CSI/ESO/Sealed Secrets, secret hygiene
multi-tenancy.mdSoft vs hard multi-tenancy, in-cluster isolation (namespaces/RBAC/NetworkPolicy/quotas/node isolation), cluster-/account-per-tenant
incident-response-and-forensics.mdIR runbook for a compromised pod/node, isolation/eradication, credential revocation, forensic capture
compliance-regimes.mdThe cross-regime scope table, language-precision rules, worked scenarios, and routing to the per-regime quick-starts (HIPAA/PCI/SOC 2)
compliance-hipaa.mdHIPAA quick-start — BAA-first, Security Rule → EKS control map, 6-year documentation retention, 30/60/90
compliance-pci.mdPCI DSS quick-start — CDE scoping/segmentation, Req 1/2/3/4/6/7/8/10/11 → EKS control map, 1-year retention + ASV scan, 30/60/90
compliance-soc2.mdSOC 2 quick-start — attestation vs certification, Trust Services Criteria (CC6/CC7/CC8) → EKS control map, Type II readiness, 30/60/90

Sources​