Elastic Cloud on Kubernetes managed credentials

ECK

When deploying an Elastic Stack application, the operator generates a set of credentials essential for the operation of that application. For example, these generated credentials include the default elastic user for Elasticsearch and the security token for APM Server.

To list all auto-generated credentials in a namespace, run the following command:

kubectl get secret -l eck.k8s.elastic.co/credentials=true

Default elastic user

When the Elasticsearch resource is created, a default user named elastic is created automatically, and is assigned the superuser role.

Its password can be retrieved in a Kubernetes secret, whose name is based on the Elasticsearch resource name: <elasticsearch-name>-es-elastic-user.

For example, the password of the elastic user for an Elasticsearch cluster named quickstart can be retrieved with:

kubectl get secret quickstart-es-elastic-user -o go-template='{{.data.elastic | base64decode}}'

Disabling the default elastic user

If you prefer to manage all users via SSO, for example using SAML Authentication or OpenID Connect, you can disable the default elastic superuser by setting the auth.disableElasticUser field in the Elasticsearch resource to true:

apiVersion: elasticsearch.k8s.elastic.co/v1
kind: Elasticsearch
metadata:
  name: elasticsearch-sample
spec:
  version: 9.4.3
  auth:
    disableElasticUser: true
  nodeSets:
  - name: default
    count: 1

ECK auto-generated credentials

Elastic Cloud on Kubernetes auto-generates credentials for the elastic user and other file-based users. These credentials are stored in Kubernetes Secrets and are labeled with eck.k8s.elastic.co/credentials=true.

Rotate auto-generated credentials

You can force the auto-generated credentials to be regenerated with new values by deleting the appropriate Secret. For example, to change the password for the elastic user from the quickstart example, use the following command:

kubectl delete secret quickstart-es-elastic-user

Control the length of auto-generated passwords

ECK3.2+

Note: The ability to control the length of passwords generated by Elastic Cloud on Kubernetes requires an Enterprise license.

You can control the length of auto-generated passwords in Elastic Cloud on Kubernetes installations by setting either config.policies.passwords.length in your Helm chart values or password-length in the elastic-operator ConfigMap when installing with YAML manifests. Refer to the operator configuration documentation for details on managing these settings.

Creating custom users

Elastic Cloud on Kubernetes provides functionality to facilitate custom user creation through various authentication realms. You can create users using the native realm, file realm, or external authentication methods.

File realm

ECK supports creating users through Kubernetes secrets referenced in the Elasticsearch resource. These secrets can contain either file realm content or standard authentication credentials with a username and password.

For more information, refer to File-based user authentication > Add users, and check the ECK examples.

Native realm

You can create custom users in the Elasticsearch native realm using Elasticsearch user management APIs or Kibana.

Refer to Native user authentication for more details.

External authentication realms

You can also configure external authentication realms such as LDAP, OpenID Connect, or SAML in your ECK deployments by providing the appropriate Elasticsearch or Kibana configuration settings and any required certificates or configuration files.

For more information, refer to External authentication.

Creating custom roles

ECK facilitates file-based role management through Kubernetes secrets containing the roles specification. Alternatively, you can use the Role management API or the Role management UI in Kibana.

Refer to Managing custom roles for details and ECK based examples.