From 49c5aeb1dd7a75041dd045bad087cecc92cb32e3 Mon Sep 17 00:00:00 2001
From: Jonathan Budzenski <jon@budzenski.me>
Date: Fri, 18 Dec 2020 14:02:21 -0600
Subject: [PATCH] [docs] Add kibana-encryption-keys (#84577)

Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
---
 .../security/encryption-keys/index.asciidoc   | 44 +++++++++++++++++++
 docs/user/security/index.asciidoc             |  1 +
 2 files changed, 45 insertions(+)
 create mode 100644 docs/user/security/encryption-keys/index.asciidoc

diff --git a/docs/user/security/encryption-keys/index.asciidoc b/docs/user/security/encryption-keys/index.asciidoc
new file mode 100644
index 000000000000..58c0c0bb775c
--- /dev/null
+++ b/docs/user/security/encryption-keys/index.asciidoc
@@ -0,0 +1,44 @@
+[[kibana-encryption-keys]]
+=== Set up encryptions keys to protect sensitive information
+
+The `kibana-encryption-keys` command helps you set up encryption keys that {kib} uses
+to protect sensitive information.
+
+[discrete]
+=== Synopsis
+
+[source,shell]
+--------------------------------------------------
+bin/kibana-encryption-keys generate
+[-i, --interactive] [-q, --quiet]
+[-f, --force] [-h, --help]
+--------------------------------------------------
+
+[discrete]
+=== Description
+
+{kib} uses encryption keys in several areas, ranging from encrypting data
+in {kib} associated indices to storing session information.  By defining these
+encryption keys in your configuration, you'll ensure consistent operations
+across restarts.
+
+[discrete]
+[[encryption-key-parameters]]
+=== Parameters
+
+`generate`::  Randomly generates passwords to the console.
+
+`-i, --interactive`:: Prompts you for which encryption keys to set and optionally
+where to save a sample configuration file.
+
+`-q, --quiet`:: Outputs the encryption keys without helper information.
+
+`-f, --force`:: Shows help information.
+
+[discrete]
+=== Examples
+
+[source,shell]
+--------------------------------------------------
+bin/kibana-encryption-keys generate
+--------------------------------------------------
diff --git a/docs/user/security/index.asciidoc b/docs/user/security/index.asciidoc
index f84e9de87c73..6a5c4a83aa3a 100644
--- a/docs/user/security/index.asciidoc
+++ b/docs/user/security/index.asciidoc
@@ -45,5 +45,6 @@ cause Kibana's authorization to behave unexpectedly.
 include::authorization/index.asciidoc[]
 include::authorization/kibana-privileges.asciidoc[]
 include::api-keys/index.asciidoc[]
+include::encryption-keys/index.asciidoc[]
 include::role-mappings/index.asciidoc[]
 include::rbac_tutorial.asciidoc[]