AWS Deprecates EKS aws-auth ConfigMap for Native Access Entries
Amazon is shifting cluster access management to the AWS control plane to eliminate error-prone manual configurations.
Amazon Web Services has deprecated the 'aws-auth' ConfigMap for managing cluster access in Amazon Elastic Kubernetes Service (EKS), replacing it with a native API-based system known as EKS Access Entries. This transition modernizes how IAM identities map to Kubernetes RBAC groups, moving critical security configurations out of the cluster and into the AWS control plane.
For years, EKS administrators relied on the 'aws-auth' ConfigMap—a legacy method located in the kube-system namespace—to grant IAM users and roles access to their clusters. This process required manual edits to a Kubernetes object, a workflow that was frequently error-prone. Many clusters continue to rely on this legacy method, though the exact prevalence across the industry remains unverified.
The Shift to Control Plane Management
The legacy ConfigMap approach lacked native AWS API visibility, meaning changes were often invisible to standard AWS auditing tools. More critically, the manual nature of the process created a high risk of 'lock-out' scenarios; if the ConfigMap was corrupted during an edit, administrators could lose all access to the cluster, necessitating complex recovery procedures.
EKS Access Entries resolve these issues by integrating access management directly into the AWS control plane. This allows administrators to manage permissions using the AWS Console, CLI, and Infrastructure-as-Code tools like Terraform. By removing the dependency on a cluster-internal object, AWS provides a more resilient architecture that ensures identity mapping is handled by the cloud provider rather than the Kubernetes API server.
Operational and Security Implications
This migration is a matter of security hygiene. Relying on deprecated authentication methods increases the risk of configuration drift, where the actual state of cluster access diverges from the intended security policy. The persistence of the legacy method across many organizations suggests a widespread gap in fleet-wide security management, leaving enterprises exposed to operational risks.
By adopting Access Entries, organizations gain better auditing capabilities and a reduced attack surface. The native API approach ensures that access changes are logged and manageable through standard AWS IAM governance frameworks, providing a level of transparency that the ConfigMap method could not offer.
The Path Forward
Organizations currently using the 'aws-auth' ConfigMap should migrate to EKS Access Entries to align with AWS best practices. While the legacy method remains functional for now, the shift toward API-driven identity management is a clear signal of AWS's direction for EKS security. Administrators should prioritize auditing their current authentication methods and implementing a phased migration to the native API to avoid future compatibility issues or operational failures.