服务注册与分布式协调 / 系统课时
建立变更前安全检查基线
建立变更前安全检查基线
安全加固最危险的不是配置写错,而是改完以后无法判断哪些行为发生了变化。本节在任何认证、ACL 或 TLS 修改之前记录端口、关键配置、ACL 与文件指纹,形成可重复采集的基线,让后续每一步都能对比影响并保留回滚依据。
学习目标
- 采集 ZooKeeper 当前监听端口、认证配置、TLS 配置和关键 ACL 状态。
- 保存配置副本与校验值,同时避免把密码等敏感字段直接写进检查记录。
- 建立变更前后使用同一顺序验证的安全检查表。
明确要记录的安全状态
基线不追求把整台服务器所有信息都归档,而是保留能回答“加固前是什么状态”的证据。对 ZooKeeper 安全改造而言,至少需要覆盖以下五类信息。
| 检查项 | 要回答的问题 | 主要证据 |
|---|---|---|
| 监听端口 | 哪些客户端和 Quorum 端口正在监听 | ss 输出 |
| ACL | 关键 znode 当前允许哪些身份执行哪些权限 | getAcl 结果 |
| 认证 | 是否配置认证 Provider、强制认证或 Quorum 认证 | zoo.cfg 安全项 |
| TLS | 是否存在安全客户端端口、sslQuorum 与相关 TLS 配置 |
配置项与监听状态 |
| 配置版本 | 变更前究竟使用哪份配置 | 配置副本与 SHA-256 |
ACL 不应只检查根节点。根节点 ACL 很宽松并不能证明业务 znode 同样宽松,反之亦然。应提前列出真正需要保护的路径,例如配置目录、服务注册目录或管理节点,并分别保存它们的 getAcl 结果。
一次性采集服务器基线
下面脚本默认 ZooKeeper 安装在 /opt/zookeeper,连接本机 2181。如果环境不同,可在执行前通过 ZK_HOME 和 ZK_SERVER 环境变量覆盖。脚本会创建带时间戳的独立目录,并对可能包含密码、Secret 或 superDigest 的配置行做脱敏。
set -euo pipefail
ZK_HOME="${ZK_HOME:-/opt/zookeeper}"
ZK_SERVER="${ZK_SERVER:-127.0.0.1:2181}"
STAMP="$(date +%Y%m%d-%H%M%S)"
OUT="zk-security-baseline-${STAMP}"
mkdir -p "${OUT}"
chmod 700 "${OUT}"
cp "${ZK_HOME}/conf/zoo.cfg" "${OUT}/zoo.cfg.before"
sha256sum "${OUT}/zoo.cfg.before" | tee "${OUT}/zoo.cfg.sha256"
ss -lntp | tee "${OUT}/listeners.txt"
grep -E '^(clientPort|secureClientPort|serverCnxnFactory|sslQuorum|ssl\.|ssl\.quorum\.|authProvider\.|requireClientAuthScheme|quorum\.auth\.)' \
"${ZK_HOME}/conf/zoo.cfg" \
| sed -E 's/^([^=]*(password|passwd|secret|superDigest)[^=]*)=.*/\1=<REDACTED>/I' \
| tee "${OUT}/security-config.txt" || true
printf 'getAcl /\nquit\n' \
| "${ZK_HOME}/bin/zkCli.sh" -server "${ZK_SERVER}" \
> "${OUT}/root-acl.txt"
printf 'baseline=%s\n' "${OUT}"预期结果:实际监听内容与配置值因环境而异,但命令成功后应看到配置哈希、当前 socket 与安全相关配置,并得到一个新的基线目录。
<HASH> zk-security-baseline-<TIME>/zoo.cfg.before
<LISTENING_SOCKETS>
<SECURITY_CONFIG_LINES>
baseline=zk-security-baseline-<TIME><TIME>、<HASH> 与监听地址都是动态值。还应确认目录中实际存在 zoo.cfg.before、zoo.cfg.sha256、listeners.txt、security-config.txt 和 root-acl.txt。如果 zkCli.sh 无法连接,应先解决当前客户端连接问题,而不是在缺少 ACL 基线时继续修改安全配置。
补齐关键 znode 的 ACL 记录
根节点只是起点。对每个关键 znode,都应使用 ZooKeeper CLI 的 getAcl 获取当前 ACL,并把结果保存到基线目录。记录时至少关注 Scheme、ID 和权限集合;cdrwa 分别对应 create、delete、read、write、admin 权限,后续收紧 ACL 时需要能够逐项比较。
如果计划修改 ACL,应在动手前保留一个已经验证可用的管理身份,并记录原 ACL。配置文件副本可以直接帮助回滚服务器参数,但 ACL 修改写入 ZooKeeper 数据树后不会因为恢复 zoo.cfg 自动回退,必须使用仍有 admin 权限的身份重新执行相应的 setAcl。
把基线变成变更检查表
每次安全调整只改变一个主要变量,然后使用相同顺序重新采集证据。这样发生连接失败时,可以快速判断问题来自端口、认证、ACL 还是 TLS,而不是同时猜测多个方向。
| 项目 | 变更前必须记录 | 变更后通过条件 | 回滚依据 |
|---|---|---|---|
| 客户端端口 | 明文与安全端口监听情况 | 目标端口按设计监听 | 原 zoo.cfg |
| 认证 | Provider 与强制认证设置 | 预期身份能认证,未授权身份被拒绝 | 原配置与管理身份 |
| ACL | 关键路径原 ACL | 授权操作成功,越权操作失败 | 原 ACL 文本 |
| 客户端 TLS | secureClientPort 与 SSL 配置 |
TLS 端口可完成预期握手 | 原配置与证书材料 |
| Quorum TLS | sslQuorum 和相关配置 |
集群成员可正常建立 Quorum 连接 | 原配置与节点证书 |
sslQuorum=true 只能证明配置意图,不能单独证明节点间已经成功使用 TLS;同样,看到安全端口监听也不代表证书名称和信任链一定正确。真正启用这些能力后,还需要分别执行握手和集群健康验证。本节的基线负责保存“改变之前”的状态,后续验证负责证明“改变之后”确实按预期工作。
按固定顺序决定是否继续下一步
安全加固过程中建议始终按同一顺序检查:先确认进程和端口仍正常,再确认服务端配置已加载,然后验证管理身份仍可连接,接着验证 ACL,最后检查 TLS 或 Quorum 行为。只要其中一项异常,就先停止继续叠加修改并对照最近一次基线。
一份可用的安全基线最终应能回答三个问题:原配置是什么、原访问权限是什么、修改后究竟改变了什么。 做到这一点,认证、ACL 与 TLS 加固就不再是一次难以追踪的整体切换,而能被拆成可验证、可比较、可回退的连续变更。