configuring-native-realm.asciidoc 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. The native realm is available and enabled by default. You can disable it explicitly with the following snippet.
  2. [source,yaml]
  3. ----------------------------------------
  4. xpack.security.authc.realms.native.native1:
  5. enabled: false
  6. ----------------------------------------
  7. You can configure a `native` realm in the `xpack.security.authc.realms.native`
  8. namespace in `elasticsearch.yml`.
  9. Explicitly configuring a native realm enables you to set the order in which it
  10. appears in the realm chain, temporarily disable the realm, and control its
  11. cache options.
  12. . Add a realm configuration to `elasticsearch.yml` under the
  13. `xpack.security.authc.realms.native` namespace. It is recommended that you
  14. explicitly set the `order` attribute for the realm.
  15. +
  16. --
  17. NOTE: You can configure only one native realm on {es} nodes.
  18. See <<ref-native-settings>> for all of the options you can set for the `native` realm.
  19. For example, the following snippet shows a `native` realm configuration that
  20. sets the `order` to zero so the realm is checked first:
  21. [source, yaml]
  22. ------------------------------------------------------------
  23. xpack.security.authc.realms.native.native1:
  24. order: 0
  25. ------------------------------------------------------------
  26. NOTE: To limit exposure to credential theft and mitigate credential compromise,
  27. the native realm stores passwords and caches user credentials according to
  28. security best practices. By default, a hashed version of user credentials
  29. is stored in memory, using a salted `sha-256` hash algorithm and a hashed
  30. version of passwords is stored on disk salted and hashed with the `bcrypt`
  31. hash algorithm. To use different hash algorithms, see <<hashing-settings>>.
  32. --
  33. . Restart {es}.