Skip to content

Commit c1827fb

Browse files
committed
[DOCS] Adds tip for elastic built-in user (#51891)
1 parent e73b77f commit c1827fb

File tree

1 file changed

+11
-7
lines changed

1 file changed

+11
-7
lines changed

x-pack/docs/en/security/authentication/built-in-users.asciidoc

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,19 @@ up and running. These users have a fixed set of privileges and cannot be
77
authenticated until their passwords have been set. The `elastic` user can be
88
used to <<set-built-in-user-passwords,set all of the built-in user passwords>>.
99

10-
`elastic`:: A built-in _superuser_. See <<built-in-roles>>.
11-
`kibana`:: The user Kibana uses to connect and communicate with Elasticsearch.
12-
`logstash_system`:: The user Logstash uses when storing monitoring information in Elasticsearch.
13-
`beats_system`:: The user the Beats use when storing monitoring information in Elasticsearch.
10+
`elastic`:: A built-in <<built-in-roles,superuser>>.
11+
`kibana`:: The user Kibana uses to connect and communicate with {es}.
12+
`logstash_system`:: The user Logstash uses when storing monitoring information in {es}.
13+
`beats_system`:: The user the Beats use when storing monitoring information in {es}.
1414
`apm_system`:: The user the APM server uses when storing monitoring information in {es}.
1515
`remote_monitoring_user`:: The user {metricbeat} uses when collecting and
1616
storing monitoring information in {es}. It has the `remote_monitoring_agent` and
1717
`remote_monitoring_collector` built-in roles.
1818

19+
TIP: The built-in users serve specific purposes and are not intended for general
20+
use. In particular, do not use the `elastic` superuser unless full access to
21+
the cluster is required. Instead, create users that have the minimum necessary
22+
roles or privileges for their activities.
1923

2024
[float]
2125
[[built-in-user-explanation]]
@@ -130,9 +134,9 @@ the `logstash.yml` configuration file:
130134
xpack.monitoring.elasticsearch.password: logstashpassword
131135
----------------------------------------------------------
132136

133-
If you have upgraded from an older version of Elasticsearch,
134-
the `logstash_system` user may have defaulted to _disabled_ for security reasons.
135-
Once the password has been changed, you can enable the user via the following API call:
137+
If you have upgraded from an older version of {es}, the `logstash_system` user
138+
may have defaulted to _disabled_ for security reasons. Once the password has
139+
been changed, you can enable the user via the following API call:
136140

137141
[source,console]
138142
---------------------------------------------------------------------

0 commit comments

Comments
 (0)