用于安全设置的密钥库
Elastic Stack
APM Server 密钥库仅适用于 APM Server 二进制文件安装方法。
配置 APM Server 时,您可能需要指定敏感设置,例如密码。 您可以使用 APM Server 密钥库安全地存储密钥值,而不是依赖文件系统权限来保护这些值,以便在配置设置中使用。
在将密钥及其密钥值添加到密钥库后,您可以在配置敏感设置时使用该密钥代替密钥值。
引用密钥的语法与环境变量的语法相同
${KEY}
其中 KEY 是密钥的名称。
例如,假设密钥库包含一个名为 ES_PWD
的密钥,其值为 yourelasticsearchpassword
- 在配置文件中,使用
output.elasticsearch.password: "${ES_PWD}"
- 在命令行上,使用:
-E "output.elasticsearch.password=\${ES_PWD}"
当 APM Server 解压配置时,它会在解析环境变量和其他变量之前解析密钥。
请注意,APM Server 密钥库不同于 Elasticsearch 密钥库。 Elasticsearch 密钥库允许您按名称存储 elasticsearch.yml
值,而 APM Server 密钥库允许您指定任意名称,您可以在 APM Server 配置中引用这些名称。
要创建和管理密钥,请使用 keystore
命令。 有关完整的命令语法(包括可选标志),请参阅命令参考。
keystore
命令必须由将运行 APM Server 的同一用户运行。
要创建密钥库,请使用
apm-server keystore create
APM Server 在由 path.data
配置设置定义的目录中创建密钥库。
要存储敏感值,例如 Elasticsearch 的身份验证凭据,请使用 keystore add
命令
apm-server keystore add ES_PWD
出现提示时,输入密钥的值。
要覆盖现有密钥的值,请使用 --force
标志
apm-server keystore add ES_PWD --force
要通过 stdin 传递值,请使用 --stdin
标志。 您也可以使用 --force
cat /file/containing/setting/value | apm-server keystore add ES_PWD --stdin --force
要列出密钥库中定义的密钥,请使用
apm-server keystore list
要从密钥库中删除密钥,请使用
apm-server keystore remove ES_PWD