Skip to content

Commit 0dc87b1

Browse files
lcawllcawl
committed
[DOCS] Re-use Kibana configuration info
1 parent fd326a6 commit 0dc87b1

2 files changed

Lines changed: 61 additions & 60 deletions

File tree

‎docs/en/stack/security/get-started-kibana-users.asciidoc‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
When {security} is enabled, users must log in to {kib} with a valid user ID and
2+
password.
3+
4+
{kib} also performs some tasks under the covers that require use of the
5+
built-in `kibana` user.
6+
7+
. Configure {kib} to use the built-in `kibana` user and the password that you
8+
created:
9+
10+
** If you don't mind having passwords visible in your configuration file,
11+
uncomment and update the following settings in the `kibana.yml` file in your
12+
{kib} directory:
13+
+
14+
--
15+
TIP: If you installed {kib} using archive distributions (`zip` or
16+
`tar.gz`), the `kibana.yml` configuration file is in `KIBANA_HOME/config`. If
17+
you used package distributions (Debian or RPM), it's in `/etc/kibana`. For more
18+
information, see {kibana-ref}/settings.html[Configuring {kib}].
19+
20+
For example, add the following settings:
21+
22+
[source,yaml]
23+
----
24+
elasticsearch.username: "kibana"
25+
elasticsearch.password: "your_password"
26+
----
27+
28+
Specify the password that you set with the `elasticsearch-setup-passwords`
29+
command then save your changes to the file.
30+
--
31+
32+
** If you prefer not to put your user ID and password in the `kibana.yml` file,
33+
store them in a keystore instead. Run the following commands to create the {kib}
34+
keystore and add the secure settings:
35+
+
36+
--
37+
["source","sh",subs="attributes,callouts"]
38+
----------------------------------------------------------------------
39+
./bin/kibana-keystore create
40+
./bin/kibana-keystore add elasticsearch.username
41+
./bin/kibana-keystore add elasticsearch.password
42+
----------------------------------------------------------------------
43+
44+
When prompted, specify the `kibana` built-in user and its password for these
45+
setting values. The settings are automatically applied when you start {kib}.
46+
To learn more, see {kibana-ref}/secure-settings.html[Secure settings].
47+
--
48+
49+
. Restart {kib}. For example, if you installed
50+
{kib} with a `.tar.gz` package, run the following command from the {kib}
51+
directory:
52+
+
53+
--
54+
["source","sh",subs="attributes,callouts"]
55+
----------------------------------------------------------------------
56+
./bin/kibana
57+
----------------------------------------------------------------------
58+
59+
See {kibana-ref}/start-stop.html[Starting and stopping {kib}].
60+
--

‎docs/en/stack/security/get-started-security.asciidoc‎

Lines changed: 1 addition & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -59,66 +59,7 @@ and {metricbeat-ref}/monitoring.html[Monitoring {metricbeat}].
5959
[[gs-kibana-security]]
6060
=== Add the built-in user to {kib}
6161

62-
When {security} is enabled, users must log in to {kib} with a valid user ID and
63-
password.
64-
65-
{kib} also performs some tasks under the covers that require use of the
66-
built-in `kibana` user.
67-
68-
. Configure {kib} to use the built-in `kibana` user and the password that you
69-
created:
70-
71-
** If you don't mind having passwords visible in your configuration file,
72-
uncomment and update the following settings in the `kibana.yml` file in your
73-
{kib} directory:
74-
+
75-
--
76-
TIP: If you installed {kib} using archive distributions (`zip` or
77-
`tar.gz`), the `kibana.yml` configuration file is in `KIBANA_HOME/config`. If
78-
you used package distributions (Debian or RPM), it's in `/etc/kibana`. For more
79-
information, see {kibana-ref}/settings.html[Configuring {kib}].
80-
81-
For example, add the following settings:
82-
83-
[source,yaml]
84-
----
85-
elasticsearch.username: "kibana"
86-
elasticsearch.password: "your_password"
87-
----
88-
89-
Specify the password that you set with the `elasticsearch-setup-passwords`
90-
command then save your changes to the file.
91-
--
92-
93-
** If you prefer not to put your user ID and password in the `kibana.yml` file,
94-
store them in a keystore instead. Run the following commands to create the {kib}
95-
keystore and add the secure settings:
96-
+
97-
--
98-
["source","sh",subs="attributes,callouts"]
99-
----------------------------------------------------------------------
100-
./bin/kibana-keystore create
101-
./bin/kibana-keystore add elasticsearch.username
102-
./bin/kibana-keystore add elasticsearch.password
103-
----------------------------------------------------------------------
104-
105-
When prompted, specify the `kibana` built-in user and its password for these
106-
setting values. The settings are automatically applied when you start {kib}.
107-
To learn more, see {kibana-ref}/secure-settings.html[Secure settings].
108-
--
109-
110-
. Restart {kib}. For example, if you installed
111-
{kib} with a `.tar.gz` package, run the following command from the {kib}
112-
directory:
113-
+
114-
--
115-
["source","sh",subs="attributes,callouts"]
116-
----------------------------------------------------------------------
117-
./bin/kibana
118-
----------------------------------------------------------------------
119-
120-
See {kibana-ref}/start-stop.html[Starting and stopping {kib}].
121-
--
62+
include::get-started-kibana-users.asciidoc[]
12263

12364
[float]
12465
[[gs-realms]]

0 commit comments

Comments
 (0)