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