原英文版地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/native-realm.html, 原文档版权归 www.elastic.co 所有
本地英文版地址: ../en/native-realm.html
重要: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 当前版本文档。
Elasticsearch Guide [7.7] » Secure a cluster » User authentication » Native user authentication
« LDAP user authentication OpenID Connect authentication »

Native user authenticationedit

The easiest way to manage and authenticate users is with the internal native realm. You can use the REST APIs or Kibana to add and remove users, assign user roles, and manage user passwords.

Configuring a native realmedit

The native realm is available by default when no other realms are configured. If other realm settings have been configured in elasticsearch.yml, you must add the native realm to the realm chain.

You can configure a native realm in the xpack.security.authc.realms.native namespace in elasticsearch.yml. Explicitly configuring a native realm enables you to set the order in which it appears in the realm chain, temporarily disable the realm, and control its cache options.

  1. Add a realm configuration to elasticsearch.yml under the xpack.security.authc.realms.native namespace. It is recommended that you explicitly set the order attribute for the realm.

    You can configure only one native realm on Elasticsearch nodes.

    See Native realm settings for all of the options you can set for the native realm. For example, the following snippet shows a native realm configuration that sets the order to zero so the realm is checked first:

    xpack:
  security:
    authc:
      realms:
        native:
          native1:
            order: 0

    To limit exposure to credential theft and mitigate credential compromise, the native realm stores passwords and caches user credentials according to security best practices. By default, a hashed version of user credentials is stored in memory, using a salted sha-256 hash algorithm and a hashed version of passwords is stored on disk salted and hashed with the bcrypt hash algorithm. To use different hash algorithms, see User cache and password hash algorithms.

  2. Restart Elasticsearch.

Managing native usersedit

The Elastic Stack security features enable you to easily manage users in Kibana on the Management / Security / Users page.

Alternatively, you can manage users through the user API. For more information and examples, see user management APIs.

To migrate file-based users to the native realm, use the migrate tool.

« LDAP user authentication OpenID Connect authentication »