IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Setting JVM options Logging configuration »
Elastic Docs ›Elasticsearch Guide [6.3] ›Set up Elasticsearch ›Configuring Elasticsearch

Secure settings

edit

Secure settings

edit

Some settings are sensitive, and relying on filesystem permissions to protect their values is not sufficient. For this use case, Elasticsearch provides a keystore and the elasticsearch-keystore tool to manage the settings in the keystore.

All commands here should be run as the user which will run Elasticsearch.

Only some settings are designed to be read from the keystore. See documentation for each setting to see if it is supported as part of the keystore.

All the modifications to the keystore take affect only after restarting Elasticsearch.

The elasticsearch keystore currently only provides obfuscation. In the future, password protection will be added.

These settings, just like the regular ones in the elasticsearch.yml config file, need to be specified on each node in the cluster. Currently, all secure settings are node-specific settings that must have the same value on every node.

Creating the keystore

edit

To create the elasticsearch.keystore, use the create command:

bin/elasticsearch-keystore create

The file elasticsearch.keystore will be created alongside elasticsearch.yml.

Listing settings in the keystore

edit

A list of the settings in the keystore is available with the list command:

bin/elasticsearch-keystore list

Adding string settings

edit

Sensitive string settings, like authentication credentials for cloud plugins, can be added using the add command:

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

The tool will prompt for the value of the setting. To pass the value through stdin, use the --stdin flag:

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

Adding file settings

edit

You can add sensitive files, like authentication key files for cloud plugins, using the add-file command. Be sure to include your file path as an argument after the setting name.

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

Removing settings

edit

To remove a setting from the keystore, use the remove command:

bin/elasticsearch-keystore remove the.setting.name.to.remove
« Setting JVM options Logging configuration »