Use break-glass credentials
Take a one-hour cluster-admin client certificate for when {{product}} sign-in or the cluster's RBAC is broken.
Last updated 18 November 2026View as Markdown
Replace my-cluster with your cluster's name or id.
Important
The certificate is cluster-admin, valid for one hour, and cannot be revoked. Every issuance is
recorded in the cluster's Activity with your name, and in the audit log.
Prerequisites
- Permission for
eks:GetClusterAdminCredentialson the cluster. No access entry is needed. - In the console, also
eks:DescribeClusterto open the cluster. - The cluster is
active(orupdating); the console offers the button only then. Until the first provisioning step has made the cluster's key material, the request answers409"The cluster is still being created".
Take the credentials
- Open Kubernetes, then open the cluster.
- On Overview, under Break glass, choose Get break-glass credentials….
- Choose Issue and download (recorded).
The console downloads my-cluster-break-glass.kubeconfig.yaml and shows until when the certificate
works. It is not shown again.
dcloud eks clusters admin-credentials my-cluster --jsonPOST /eks/api/clusters/my-cluster/admin-credentialsResult
The answer holds server, certificateAuthorityData, clientCertificateData, clientKeyData
(base64 PEM) and expiresAt. server is always the endpoint's public address, so the
credentials reach the cluster only while public endpoint access is on and your address is in the
allowed networks.
Related
Did this page help you?