elasticsearch-keystore

Команда elasticsearch-keystore управляет безопасными настройками в хранилище ключей Elasticsearch.

bin/elasticsearch-keystore
( [add <settings>] [-f] [--stdin]
| [add-file (<setting> <path>)+]
| [create] [-p]
| [has-passwd]
| [list]
| [passwd]
| [remove <setting>]
| [show [-o <output-file>] <setting>]
| [upgrade]
) [-h, --help] ([-s, --silent] | [-v, --verbose])

В настоящее время все безопасные настройки являются узловыми настройками, которые должны иметь одинаковое значение на каждом узле. Поэтому необходимо выполнить эту команду на каждом узле.

Когда хранилище ключей защищено паролем, каждый раз при запуске Elasticsearch требуется ввод пароля.

Изменения в хранилище ключей не применяются автоматически к работающему узлу Elasticsearch. Любые изменения в хранилище ключей вступят в силу после перезапуска Elasticsearch. Некоторые безопасные настройки могут быть явно перезагружены без перезапуска.

Только некоторые настройки предназначены для чтения из хранилища ключей. Однако нет проверки, чтобы заблокировать использование неподдерживаемых настроек из хранилища ключей, и они могут привести к невозможности запуска Elasticsearch. Чтобы узнать, поддерживается ли настройка в хранилище ключей, обратитесь к справке по настройкам.

Для создания хранилища ключей используйте команду create:

bin/elasticsearch-keystore create -p

Вам будет предложено ввести пароль хранилища ключей. Файл elasticsearch.keystore, защищённый паролем, создаётся вместе с файлом elasticsearch.yml.

Для изменения пароля хранилища ключей используйте команду passwd:

bin/elasticsearch-keystore passwd

Если хранилище ключей Elasticsearch защищено паролем, вам будет предложено ввести текущий пароль, а затем новый. Если оно не защищено паролем, вам будет предложено установить пароль.

Для просмотра настроек в хранилище ключей используйте команду list.

bin/elasticsearch-keystore list

Если хранилище ключей Elasticsearch защищено паролем, вам будет предложено ввести пароль.

Конфиденциальные строковые настройки, такие как учетные данные для подключаемых модулей облачных сервисов, могут быть добавлены с помощью команды add:

bin/elasticsearch-keystore add the.setting.name.to.set

Вам будет предложено ввести значение настройки. Если хранилище ключей Elasticsearch защищено паролем, вам также будет предложено ввести пароль.

Вы также можете добавить несколько настроек с помощью команды add:

bin/elasticsearch-keystore add \
  the.setting.name.to.set \
  the.other.setting.name.to.set

Вам будет предложено ввести значения настроек. Если хранилище ключей Elasticsearch защищено паролем, вам также будет предложено ввести пароль.

Чтобы передать значения настроек через стандартный ввод (stdin), используйте флаг --stdin:

cat /file/containing/setting/value | bin/elasticsearch-keystore add --stdin the.setting.name.to.set

Значения для нескольких настроек должны быть разделены символами возврата каретки или новой строки.

Вы можете добавить конфиденциальные файлы, такие как файлы ключей аутентификации для подключаемых модулей облачных сервисов, с помощью команды add-file. Настройки и пути к файлам задаются парами, состоящими из setting path.

bin/elasticsearch-keystore add-file the.setting.name.to.set /path/example-file.json

Вы можете добавить несколько файлов с помощью команды add-file:

bin/elasticsearch-keystore add-file \
  the.setting.name.to.set /path/example-file.json \
  the.other.setting.name.to.set /path/other-example-file.json

Если хранилище ключей Elasticsearch защищено паролем, вам будет предложено ввести пароль.

Для отображения значения настройки в хранилище ключей используйте команду show:

bin/elasticsearch-keystore show the.name.of.the.setting.to.show

Если настройка содержит двоичные данные, вы должны записать её в файл с помощью параметра -o (или --output):

bin/elasticsearch-keystore show -o my_file binary.setting.name

Если хранилище ключей Elasticsearch защищено паролем, вам будет предложено ввести пароль.

Для удаления настройки из хранилища ключей используйте команду remove:

bin/elasticsearch-keystore remove the.setting.name.to.remove

Вы также можете удалить несколько настроек с помощью команды remove:

bin/elasticsearch-keystore remove \
  the.setting.name.to.remove \
  the.other.setting.name.to.remove

Если хранилище ключей Elasticsearch защищено паролем, вам будет предложено ввести пароль.

Иногда внутренний формат хранилища ключей изменяется. При установке Elasticsearch из диспетчера пакетов обновление хранилища ключей на диске до нового формата выполняется во время обновления пакета. В других случаях Elasticsearch выполняет обновление во время запуска узла. Это требует, чтобы Elasticsearch имел права записи в каталог, содержащий хранилище ключей. В качестве альтернативы, вы можете вручную выполнить такое обновление, используя команду upgrade:

bin/elasticsearch-keystore upgrade