服务注册与分布式协调 / 系统课时

用密码文件保护密钥库口令

用密码文件保护密钥库口令

把 KeyStore 和 TrustStore 密码写进 zoo.cfg 或 JVM 参数,会让秘密进入备份、进程列表和诊断材料。本篇改用 passwordPath 指向受限文件,并用权限与泄露扫描确认迁移结果。

学习目标

  • 使用 ssl.keyStore.passwordPath 与 ssl.trustStore.passwordPath 移除主配置中的明文口令。
  • 用目录属主和 0600 权限限制 ZooKeeper 服务账号读取密码文件。
  • 检查配置、进程参数和日志,确认旧口令没有继续暴露。

先确认版本与边界

ssl.keyStore.passwordPath 和 ssl.trustStore.passwordPath 从 ZooKeeper 3.8.0 起可用;对应的 quorum TLS 配置是 ssl.quorum.keyStore.passwordPath 与 ssl.quorum.trustStore.passwordPath。当 passwordPath 与显式 password 同时存在时,文件路径优先,但这不意味着旧密码可以安全地留在配置里。

如果运行 ZooKeeper 3.8.0~3.8.5 或 3.9.0~3.9.4,还应先处理 CVE-2026-24308:这些版本存在客户端配置值写入 INFO 日志的敏感信息泄露问题。升级到 3.8.6 或 3.9.5 及以上版本后,再把“日志中无秘密残留”作为验收条件。

创建受限密码文件

以下示例假设 ZooKeeper 服务账号为 zookeeper,并把两个密码文件放在独立的 0700 目录中。交互读取避免把真实密码直接写进命令历史。

bash
set -euo pipefail
SECRETS_DIR=/etc/zookeeper/secrets

install -d -o zookeeper -g zookeeper -m 700 "$SECRETS_DIR"
umask 077

read -rsp "KeyStore password: " KEYSTORE_PASSWORD
printf '\n'
printf '%s' "$KEYSTORE_PASSWORD" > "$SECRETS_DIR/keystore.pass"
unset KEYSTORE_PASSWORD

read -rsp "TrustStore password: " TRUSTSTORE_PASSWORD
printf '\n'
printf '%s' "$TRUSTSTORE_PASSWORD" > "$SECRETS_DIR/truststore.pass"
unset TRUSTSTORE_PASSWORD

chown zookeeper:zookeeper "$SECRETS_DIR/keystore.pass" "$SECRETS_DIR/truststore.pass"
chmod 600 "$SECRETS_DIR/keystore.pass" "$SECRETS_DIR/truststore.pass"
stat -c '%a %U %G %n' "$SECRETS_DIR/keystore.pass" "$SECRETS_DIR/truststore.pass"

预期输出

text
600 zookeeper zookeeper /etc/zookeeper/secrets/keystore.pass
600 zookeeper zookeeper /etc/zookeeper/secrets/truststore.pass

如果实际服务账号不同,替换属主和属组即可。密码文件不需要被普通运维用户批量可读,也不应放进配置仓库、镜像层或通用备份包。

改用 passwordPath

在 zoo.cfg 中保留 KeyStore、TrustStore 的位置与类型,把显式密码字段删掉,并改为密码文件路径。下面是客户端到 Server TLS 的配置片段。

properties
ssl.keyStore.location=/etc/zookeeper/tls/server.p12
ssl.keyStore.type=PKCS12
ssl.keyStore.passwordPath=/etc/zookeeper/secrets/keystore.pass
ssl.trustStore.location=/etc/zookeeper/tls/truststore.p12
ssl.trustStore.type=PKCS12
ssl.trustStore.passwordPath=/etc/zookeeper/secrets/truststore.pass

该配置没有独立控制台输出。滚动重启节点后,应确认 TLS 端口能够正常启动并完成握手;如果同时启用 quorum TLS,则把同样的做法应用到 ssl.quorum.keyStore.passwordPath 和 ssl.quorum.trustStore.passwordPath。

扫描配置、进程与日志

迁移后应直接查找“真实秘密是否还出现”,而不是只检查属性名。下面的脚本让 grep 从密码文件读取匹配模式,因此不会把密码本身放进命令行参数;LOG_DIR 只覆盖当前主机的明文日志,集中式日志和压缩归档仍需单独检查。

bash
set -uo pipefail
SECRETS_DIR=/etc/zookeeper/secrets
CFG=/etc/zookeeper/zoo.cfg
LOG_DIR=/var/log/zookeeper

test -r "$CFG" || { echo "FAIL: cannot read zoo.cfg" >&2; exit 2; }
test -d "$LOG_DIR" || { echo "FAIL: log directory not found" >&2; exit 2; }

for secret_file in "$SECRETS_DIR/keystore.pass" "$SECRETS_DIR/truststore.pass"; do
  test -r "$secret_file" || { echo "FAIL: cannot read secret file" >&2; exit 2; }

  grep -F -f "$secret_file" "$CFG" >/dev/null
  rc=$?
  if [ "$rc" -eq 0 ]; then
    echo "FAIL: secret found in zoo.cfg" >&2
    exit 1
  elif [ "$rc" -gt 1 ]; then
    echo "FAIL: cannot scan zoo.cfg" >&2
    exit 2
  fi

  ps -eo args= | grep -F -f "$secret_file" >/dev/null
  rc=$?
  if [ "$rc" -eq 0 ]; then
    echo "FAIL: secret found in process arguments" >&2
    exit 1
  elif [ "$rc" -gt 1 ]; then
    echo "FAIL: cannot scan process arguments" >&2
    exit 2
  fi

  grep -R -F -f "$secret_file" "$LOG_DIR" >/dev/null
  rc=$?
  if [ "$rc" -eq 0 ]; then
    echo "FAIL: secret found in plaintext logs" >&2
    exit 1
  elif [ "$rc" -gt 1 ]; then
    echo "FAIL: cannot scan plaintext logs" >&2
    exit 2
  fi
done

echo "OK: no keystore/truststore secret found in config, process arguments, or plaintext logs."

预期输出

text
OK: no keystore/truststore secret found in config, process arguments, or plaintext logs.

如果扫描命中,先定位来源并清理旧配置、启动参数或日志副本,再轮换已经暴露的 KeyStore/TrustStore 密码。仅删除命中文本并不能让已经泄露的旧秘密重新变得可信。

把轮换纳入生命周期

密码文件与 KeyStore、TrustStore 应作为同一个变更单元管理:先生成或更新密钥库,再原子替换密码文件,最后按节点滚动验证 TLS。不要在所有节点同时覆盖文件后才观察结果,否则一次路径、属主或口令错误就可能把整个 ensemble 同时推入不可用状态。

验收标准应同时包含三项:ZooKeeper 服务账号能读取密码文件、其他普通账号不能读取、配置和日志中找不到真实口令。做到这三点,passwordPath 才真正把“主配置里的明文秘密”收紧为受控的本机秘密文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用密码文件保护密钥库口令

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通