elasticsearch-keystore¶
Verwaltet den Keystore von Elasticsearch: eine geschützte Datei für geheime Einstellungen wie Passwörter und S3-Schlüssel, die nicht in
elasticsearch.ymlgehören.

Syntax¶
sudo /usr/share/elasticsearch/bin/elasticsearch-keystore list | add [-x] EINSTELLUNG | show EINSTELLUNG | remove EINSTELLUNG
Optionen¶
| Befehl | Beschreibung |
|---|---|
list |
Namen aller gespeicherten Einstellungen |
add EINSTELLUNG |
Eine Einstellung hinzufügen; der Wert wird abgefragt |
add -x EINSTELLUNG |
Den Wert von stdin lesen (für Skripte) |
add-file EINSTELLUNG DATEI |
Den Inhalt einer Datei ablegen, z. B. eine Zugangsdatei |
show EINSTELLUNG |
Einen gespeicherten Wert anzeigen |
remove EINSTELLUNG |
Eine Einstellung löschen |
passwd |
Den Keystore selbst mit einem Passwort schützen |
Die Datei ist /etc/elasticsearch/elasticsearch.keystore. Änderungen wirken nach einem Neustart; manche Einstellungen wie S3-Zugangsdaten lassen sich mit POST /_nodes/reload_secure_settings neu laden. OpenSearch hat dasselbe Werkzeug als opensearch-keystore.
Beispiele¶
Was gespeichert ist:
sudo /usr/share/elasticsearch/bin/elasticsearch-keystore list
keystore.seed
xpack.security.http.ssl.keystore.secure_password
xpack.security.transport.ssl.keystore.secure_password
xpack.security.transport.ssl.truststore.secure_password
S3-Zugangsdaten für Snapshots hinzufügen:
sudo /usr/share/elasticsearch/bin/elasticsearch-keystore add s3.client.default.access_key
sudo /usr/share/elasticsearch/bin/elasticsearch-keystore add s3.client.default.secret_key
Enter value for s3.client.default.access_key:
Enter value for s3.client.default.secret_key:
Aus einem Skript, ohne Abfrage:
printf '%s' "$S3_KEY" | sudo /usr/share/elasticsearch/bin/elasticsearch-keystore add -x s3.client.default.access_key
sudo /usr/share/elasticsearch/bin/elasticsearch-keystore list | grep s3
s3.client.default.access_key
s3.client.default.secret_key
Die neuen Werte ohne Neustart laden:
curl --cacert /etc/elasticsearch/certs/http_ca.crt -u elastic https://localhost:9200/_nodes/reload_secure_settings -X POST -s | jq '._nodes'
Enter host password for user 'elastic':
{
"total": 1,
"successful": 1,
"failed": 0
}
Das Passwort des HTTP-Zertifikats:
sudo /usr/share/elasticsearch/bin/elasticsearch-keystore show xpack.security.http.ssl.keystore.secure_password
pV3sKq9TzR2mWx7YbN4c
Wann brauche ich das?¶
- Um Elasticsearch Zugangsdaten für ein S3-Snapshot-Repository zu geben
- Um die Passwörter der TLS-Keystores nachzuschauen, die die Installation angelegt hat
- Bevor ein Cluster wächst: Jeder Knoten braucht dieselben geheimen Einstellungen
Derselbe Keystore auf jedem Knoten
Geheime Einstellungen werden nicht zwischen Knoten kopiert. Leg sie auf jedem Knoten mit
denselben Werten an und ruf danach einmal reload_secure_settings auf.
Kein Tresor
Ohne passwd ist der Keystore nur verschleiert, und show gibt jeden Wert aus. Schütz die
Datei mit den Rechten 660 und dem Besitzer root:elasticsearch, wie das Paket sie setzt.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Installation | APT-Paketquelle von Elastic | APT-Paketquelle von Elastic | YUM-Paketquelle von Elastic | AUR oder Container |
| Pfad | /usr/share/elasticsearch/bin/ |
/usr/share/elasticsearch/bin/ |
/usr/share/elasticsearch/bin/ |
je nach Paket |
Verwandte Befehle¶
elasticsearch-reset-password · elasticsearch-plugin · restic · chmod